Codex 分角色交付技能

这组技能把软件交付拆成需求设计、流程监督、编码实现、自动测试和文档/GitHub 交付，并使用 .ai/tasks.yaml 保存跨会话状态。

目录

design-architect/   需求追问、设计和任务拆分
supervisor/         设计审查、任务分派和质量门禁
implementation/     单任务编码与验证
github-actions/     GitHub Actions 自动测试配置
docs-github/        文档同步及 GitHub 交付
AGENTS.md           项目级共同规则
.ai/tasks.yaml      工作流状态和任务清单

安装

将五个技能目录安装到 Codex 可发现的 skills 目录，例如 Windows 的 %USERPROFILE%\.codex\skills\。将 AGENTS.md 和 .ai/tasks.yaml 放在目标项目根目录；已有 AGENTS.md 时合并规则，不要覆盖项目约束。

每个技能默认采用显式调用，避免普通编码请求意外进入完整交付流程。

首次使用

1. 在目标项目根目录启动 Codex。
2. 调用 $design-architect 并描述初始需求。该技能会像 grill-me 一样持续追问，直到需求达到可实现标准，然后生成 .ai/design.md 和任务。
3. 调用 $supervisor 审查设计。通过后，它会把一个无依赖任务设为 ready。
4. 调用 $implementation 并指定任务 ID，例如：使用 $implementation 实现 TASK-001。
5. 实现进入 review 后调用 $supervisor；未通过则按 notes 修正，通过后继续下一任务。
6. 调用 $github-actions 配置与本地命令一致的自动测试。
7. 全部任务通过后调用 $docs-github 更新文档并准备 PR。创建、推送、合并和发布应分别明确授权。

推荐提示词

使用 $design-architect 分析“增加组织级权限控制”的需求。先追问，不要直接写代码。

使用 $supervisor 检查当前设计和 .ai/tasks.yaml，告诉我下一步，并执行允许的状态流转。

使用 $implementation 实现 TASK-002；严格限制在任务 scope 内，测试后记录 evidence。

使用 $github-actions 为当前项目配置 PR 自动测试，复用本地测试命令，不要推送。

使用 $docs-github 更新本次改动文档并生成 PR 标题和正文预览，不要创建远端 PR。

状态协议

工作流阶段使用 discovery、design_review、implementation、documentation、delivery 或 blocked。任务使用：

draft -> ready -> in_progress -> review -> done
                      |           |
                      v           v
                    blocked <-----+

任务条目至少包含以下字段：

- id: TASK-001
  title: 示例任务
  status: draft
  owner: implementation
  depends_on: []
  scope:
    - 明确允许修改的模块或行为
  acceptance:
    - 可验证的验收标准
  tests:
    - 要新增或执行的测试
  evidence: []
  notes: ""

evidence 记录实际执行命令和结果，不能只写“测试通过”。任务只有经 supervisor 审查后才能成为 done。

GitHub 权限边界

读取仓库、检查状态和生成内容预览可以直接进行。以下操作需要用户明确授权：推送分支、创建或编辑 Issue/PR、修改仓库设置、合并、关闭 Issue、创建 Release。任何技能都不得把本地成功等同于 GitHub Actions 已通过。