Dev Cycle Orchestrator
編排完整的開發生命週期:腦力激盪 → 規劃 → 審查 → 問題 → 實現 → 程式碼審查 → PR。
區別說明: 如果使用者只想要 PRD,請導向 /write-a-prd。如果只想要計畫,請導向 /prd-to-plan。此技能適用於完整的端到端生命週期。
七階段管道
每個階段都是強制性的。不得跳過任何階段。
| # | 階段 | 委派給 | 閘門條件 |
|---|---|---|---|
| 1 | 腦力激盪 | write-a-prd | Issue URL 已記錄 |
| 2 | 規劃 | prd-to-plan | 計畫檔案存在於 docs/plans/ 下 |
| 3 | CEO 審查 | plan-ceo-review (建議 HOLD SCOPE) | 審查完成,使用者批准 |
| 4 | 問題 | 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 審查: 讀取計畫檔案(包含審查修訂版本)
- 問題: 使用
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 階段:問題
由 orchestrator 擁有。 讀取計畫的垂直切片。為每個切片使用 gh issue create 建立 GitHub issue,該 issue 需要:
- 引用 PRD issue
- 包含計畫中的驗收標準
- 按依賴順序建立
在建立後立即在 Issues 表格中記錄每個 issue URL。請參閱 references/phase-transitions.md 了解部分完成的恢復方法。
第 5 階段:實現
由 orchestrator 擁有。 建立功能分支 feat/{feature-slug}(請參閱 references/phase-transitions.md 中的分支處理)。
按照 subagent-development 方法為每個 GitHub issue 派遣一個子代理:
- 每個子代理調用
tdd技能 - 程式碼審查在每次子代理派遣之間執行
- 狀態檔案在每個子代理完成後更新(非批量)
記錄每個子代理的事件:
"為 Issue #N 啟動子代理:{title}""Issue #N 的子代理已完成:{pass/fail}""Issue #N 後的程式碼審查:{clean/blocking issues found}"
第 6 階段:程式碼審查
對功能分支上所有變更的檔案調用 daa-code-review。如果發現阻礙性問題 → 修正後重新執行。迴圈直到審查乾淨。
如果出現需要重新規劃的架構問題 → 觸發向後轉換至第 2 階段。
第 7 階段:PR
首先檢查與預設分支的衝突。調用 commit 進行 conventional 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後)