Code Skills

面向 AI 编程代理的通用开发治理 Skills。当前提供 dux-code-skills，按任务风险选择会话轻量开发或显式正式 Plan，在保证边界、验证和验收质量的同时避免把零碎修改扩大成方案工程。

dux-code-skills

这个 Skill 既适用于日常修复、小功能和局部重构，也适用于新项目、跨模块改造、高风险变更和正式架构治理。

主要能力：

• 从需求、事实、假设和待确认问题开始设计方案；
• 按业务能力、职责、数据所有权和生命周期划分模块；
• 先检查项目已有依赖，再评估成熟、活跃的开源库，避免无意义地重复造轮子；
• 默认选择最新稳定且仍受支持的语言、框架和依赖版本，并记录版本依据、用途、许可证、维护与安全情况；
• 默认只在会话中确认真正影响实现的选择，需求明确时直接开发，不主动创建 Plan 文件；
• 仅在用户明确要求正式 Plan 时，以 REQ/NFR -> ARC -> TASK -> AC -> EVIDENCE 保持完整可追踪性；
• 按风险选择测试层级：关键用户流程和布局风险使用 E2E 与视觉证据，局部低风险修改复用最小可信测试；
• 发生重大偏差时只重新确认受影响的决策，不重复整套流程；
• 根据用户指定语言或当前请求语言生成方案，不强制使用英文。

默认工作流不会创建或更新 plan/。调用 $dux-code-skills、任务规模较大、仓库已有 plan/，或用户要求“先确认方案”，都不等于授权写 Plan 文件；这些内容默认留在会话中。

只有用户明确要求 Plan 模式、计划文件、正式可追踪架构，或仓库规范强制要求时，才维护：

plan/
├── architecture.md    # 已确认的需求、边界、ASCII 架构/流程、UI 线框与决策
└── implementation.md  # 可勾选任务、验收标准、证据和最终结论

安装

安装需要 Node.js >=22.20.0 和 npx，这是 skills@1.5.22 声明的运行环境要求。仓库使用 skills.sh CLI 完成 Skill 安装，并固定到已审查的 skills@1.5.22，以避免未固定版本导致安装行为随上游发布意外变化。升级 CLI 前应同时核对 Node.js 要求并重新验证安装流程。

从 GitHub 安装

安装到当前项目：

cd /path/to/project
npx --yes skills@1.5.22 add duxweb/code-skills \
  --skill dux-code-skills \
  --agent codex \
  --yes \
  --copy

安装到当前用户的全局 Skills：

npx --yes skills@1.5.22 add duxweb/code-skills \
  --skill dux-code-skills \
  --agent codex \
  --global \
  --yes \
  --copy

克隆后安装

git clone https://github.com/duxweb/code-skills.git

安装到指定项目：

/path/to/code-skills/install.sh --project /path/to/project

也可以先进入目标项目，让脚本安装到当前目录：

cd /path/to/project
/path/to/code-skills/install.sh

只有明确需要用户级安装时才使用：

/path/to/code-skills/install.sh --global

使用

日常开发：

使用 $dux-code-skills 完成这个修改，只在会话中确认必要选择，然后直接实现和验证；不要生成 Plan 文件。

正式 Plan：

使用 $dux-code-skills，以正式 Plan 模式规划这个跨模块功能，在确认后生成 plan/architecture.md 和 plan/implementation.md，再实施和验收。

也可以直接描述新项目、架构规划、跨模块功能、依赖选型、开发执行或最终验收任务；当运行环境支持隐式匹配时，Skill 会根据描述自动触发。

工作方式

1. 默认按会话轻量工作流执行：检查相关边界，只确认实质选择，直接实现并做比例适当的验证；
2. 局部低风险任务不生成 ID、ASCII 图或 Plan 文件，也不增加形式化确认步骤；
3. 复杂或高风险任务会加强会话中的架构、失败、回滚和安全确认，但仍不会自动写 Plan；
4. 仅在明确启用正式 Plan 后，才生成两份计划文件并维护完整追踪链；
5. 重大偏差只重新确认受影响的部分，最终按当前工作流完成验证与验收。

测试参考

运行 Skill 时，应以项目现有测试约定、测试运行器发现规则和当前官方文档为准。以下外部 Skills 仅作为可选参考输入，不是安装依赖：

• Microsoft playwright-cli：浏览器执行、检查、追踪与 Playwright 测试调试；
• Currents Playwright best practices：测试套件、fixture、CI 与视觉回归实践；
• Frontend testing best practices：用户流程与稳定选择器参考；
• Visual regression testing：基线稳定性、响应式状态和差异审查；
• Flutter add integration test：Flutter integration_test 项目设置和用户流程自动化参考。

官方平台资料优先于社区内容：

• Playwright：视觉对比、最佳实践；
• Flutter：集成测试指南、takeScreenshot API、matchesGoldenFile API。

目录结构

code-skills/
├── .gitignore
├── README.md
├── install.sh
└── dux-code-skills/
    ├── SKILL.md
    ├── agents/
    │   └── openai.yaml
    └── references/
        ├── requirements-assessment.md
        ├── architecture-design.md
        ├── testing-strategy.md
        ├── development-execution.md
        ├── change-control.md
        ├── review-and-acceptance.md
        └── output-templates.md

发布前事项

• 根据发布意图添加合适的开源许可证；
• 发布前审查 Skill 内容，因为安装后的 Skill 会以编程代理的完整工作权限运行。