| name | start |
| description | 啟動完整的 specflow 專案流程。使用者只需與 spec agent 對話確認需求和架構，之後 tech-lead → (engineer + qa 並行) → verify → release 全部自動背景執行。觸發關鍵字："start", "開始", "啟動專案", "新專案"。 |
| user-invocable | true |
| allowed-tools | Read, Write, Edit, Grep, Glob, Bash, Agent |
| argument-hint | [專案主題] |
SpecFlow 完整流程 Orchestrator
使用者只需做兩件事：
- 與 spec agent 對話 — 確認需求、API contract、技術架構、sprint 規劃
- 確認 release — 每個 sprint 完成後確認
完整流程
Phase 1：初始化（自動）
LABEL_COUNT=$(gh label list --json name --jq 'length')
if [ "$LABEL_COUNT" -lt 7 ]; then
bash .claude/scripts/init-github.sh
fi
mkdir -p specs/features specs/changes specs/changes/archive
Phase 2：Spec 討論（使用者參與）
啟動 spec-writer agent（前景，需使用者互動）：
subagent_type: "spec-writer"run_in_background: false- 傳入 $ARGUMENTS
spec-writer 產出：
specs/ 目錄下的 spec 檔案（source of truth）- Epic Issue + Sprint Issues
- Sprint Milestones
Phase 3：Tech Lead 規劃（背景自動）
啟動 tech-lead agent（背景）：
subagent_type: "tech-lead"run_in_background: true
tech-lead：
- 讀取
specs/ 目錄，自動分析依賴圖譜
- 建立 feature issues（含 WHEN/THEN scenarios + 實作指引）
- 建立 QA issue（含 scenarios 清單）
- 產出
specs/dependencies.md
Phase 4：Engineer + QA 同時啟動（背景並行）
tech-lead 完成後，根據 specs/dependencies.md 的 wave 分組：
Engineer Agents
Wave 1（無依賴）：同時啟動
Agent(subagent_type="engineer", run_in_background=true, isolation="worktree")
Wave 2（有依賴）：等 Wave 1 完成
Agent(subagent_type="engineer", run_in_background=true, isolation="worktree")
QA Agent（與 Wave 1 同時）
Agent(subagent_type="qa-engineer", run_in_background=true, isolation="worktree")
Phase 5：測試驗證（全部完成後自動）
所有 engineer PR + QA test PR 完成後：
- 執行 e2e tests
- 全部通過 → Phase 5.5
- 有失敗 → QA 建 bug issue → engineer 修復 → 重測（最多 3 輪）
Phase 5.5：三維度驗證（背景自動）
Agent(subagent_type="verifier", run_in_background=true)
Verifier 檢查：
- Completeness：所有 spec 有實作？所有 scenario 有 test？
- Correctness：實作行為符合 spec？API/error codes 一致？
- Coherence：程式碼風格統一？設計決策被遵守？
結果：
- PASS → Phase 6
- WARNING → Phase 6（附帶建議）
- FAIL → 建 bug issue → engineer 修復 → 重新驗證
Phase 6：Sprint 完成通知（使用者確認）
✅ Sprint {N} 完成！
📊 摘要：
Features: X | PRs: X | E2E Tests: X passed | Bugs fixed: X
Verify: PASS ✅
驗證報告：specs/verify-sprint-{N}.md
請使用 /release 確認發佈。
重要
- 只有 spec 討論和 release 確認需要使用者
specs/ 目錄是 source of truth，所有 agent 從這裡讀取規格- 依賴分析自動化，不需手動判斷 wave
- 三維度驗證確保交付品質
