Dev Cycle Orchestrator 是做什么的?
编排完整的开发生命周期:头脑风暴 → 计划 → 审查 → Issue → 实现 → 代码审查 → PR。
消歧义: 如果用户只需要 PRD,请路由到 /write-a-prd。如果只需要计划,请路由到 /prd-to-plan。此技能适用于完整的端到端生命周期。
7 阶段流水线
每个阶段都是强制性的。不得跳过任何阶段。
| # | 阶段 | 委托给 | 门控条件 |
|---|---|---|---|
| 1 | 头脑风暴 | write-a-prd | 记录 Issue URL |
| 2 | 计划 | prd-to-plan | 计划文件存在于 docs/plans/ |
| 3 | CEO 审查 | plan-ceo-review (建议 HOLD SCOPE) | 审查完成,用户批准 |
| 4 | Issue | Orchestrator (计划切片 → GitHub Issues) | 记录所有 Issue URL |
| 5 | 实现 | Orchestrator (每个 Issue 使用 tdd,subagent-development) | 所有 Issue 解决,测试通过 |
| 6 | 代码审查 | daa-code-review | 审查干净 |
| 7 | PR | commit + github-cli | 记录 PR URL |
重新进入逻辑
每次调用时:
无参数 (/dev-cycle)
- 扫描
docs/dev-cycle/中所有status: in_progress的*.state.md文件 - 如果找到一个 → 询问:“是否恢复 {feature} (
{branch})?当前位于 {phase}。” - 如果找到多个 → 列出分支名,询问恢复哪个
- 如果没有 → 询问:“您正在开发什么功能?” → 启动阶段 1
带参数 (/dev-cycle {slug})
- 查找
docs/dev-cycle/{slug}.state.md - 找到 → 在
current_phase处恢复 - 未找到 → 创建状态文件,启动阶段 1
Slug 冲突
创建新状态文件时,检查 docs/dev-cycle/ 中是否已有该 slug。如果 slug 已存在(已放弃或已完成),则添加后缀 -2、-3 等。
恢复时的上下文加载
继续之前,加载所有引用的产物:
- 头脑风暴:
gh issue view查看 PRD Issue - 计划: 从磁盘读取计划文件
- CEO 审查: 读取计划文件(包含审查修改)
- Issue:
gh issue view查看每个实现 Issue - 实现: 检查功能分支上的 git 状态,审查关闭的 Issue
呈现摘要:“正在恢复 {feature} 位于 {phase}。以下是上次中断的位置:...”
阶段执行
阶段 1:头脑风暴
调用 write-a-prd。信任该技能的内部流程(访谈 → PRD → GitHub Issue)。将 Issue URL 记录在状态文件中。
阶段 2:计划
将 PRD Issue URL 传递给 prd-to-plan。记录计划文件路径(位于 docs/plans/{feature}.md)。
阶段 3:CEO 审查
将计划文件路径传递给 plan-ceo-review。建议 HOLD SCOPE 模式,但让技能自己的模式选择(步骤 0F)运行。记录审查完成且用户批准的状态。
阶段 4:Issue
由编排器拥有。 读取计划的垂直切片。对于每个切片,使用 gh issue create 创建一个 GitHub Issue:
- 引用 PRD Issue
- 包含计划中的验收标准
- 按依赖顺序创建
创建后立即将每个 Issue URL 记录在 Issues 表中。关于部分完成恢复,请参见 references/phase-transitions.md。
阶段 5:实现
由编排器拥有。 创建功能分支 feat/{feature-slug}(有关分支处理,请参见 references/phase-transitions.md)。
按照 subagent-development 方法,为每个 GitHub Issue 分派一个子代理:
- 每个子代理调用
tdd技能 - 每次子代理分派之间运行代码审查
- 每个子代理完成后更新状态文件(不批量)
记录每个子代理的事件:
“子代理 #N 已启动:{title}”“子代理 #N 已完成:{pass/fail}”“#N Issue 后的代码审查:{clean/blocking issues found}”
阶段 6:代码审查
对功能分支上所有更改的文件调用 daa-code-review。如果发现阻塞问题 → 修复,重新运行。循环直至干净。
如果架构问题需要重新制定计划 → 触发向后过渡至阶段 2。
阶段 7:PR
首先检查与默认分支的冲突。调用 commit 进行常规提交,然后调用 github-cli 提交 PR。记录 PR URL,设置 status: completed。然后运行归档步骤(参见下面的归档)。
状态文件
每个功能在 docs/dev-cycle/{feature-slug}.state.md 中追踪。有关完整格式、字段定义和过渡规则,请参见 references/state-file-schema.md。
失败与恢复
有关以下内容,请参见 references/phase-transitions.md:
- 阶段重试逻辑(阻塞 → 下次调用重试)
- 向后过渡(实现/代码审查 → 计划)
- 功能放弃。归档的文件移至
docs/archive/。
分支管理
- 阶段 1–4: 在当前分支上运行(仅文档)
- 阶段 5: 创建
feat/{feature-slug}分支 - 阶段 7: 向默认分支提交 PR(通过
gh repo view --json defaultBranchRef检测) - 在阶段 5+ 处恢复: 如果尚未在功能分支上,则切换过去
归档
当功能达到终止状态(completed 或 abandoned)时,归档其产物:
- 创建归档目录:
mkdir -p docs/archive/dev-cycle docs/archive/plans - 移动状态文件:
git mv docs/dev-cycle/{slug}.state.md docs/archive/dev-cycle/ - 移动计划文件:从产物表读取计划路径,然后
git mv {plan_path} docs/archive/plans/ - 提交移动,使用消息:
chore(dev-cycle): archive {slug}
归档自动运行:
- 在阶段 7 结束时(记录 PR URL 并将状态设置为
completed后) - 功能放弃时(将状态设置为
abandoned后)