name: feature-dev description: "[內部] 全流程需求開發工作流核心邏輯。不直接呼叫，由 /dev 命令路由觸發。" disable-model-invocation: true allowed-tools: Agent Bash(git *) Bash(devflow-status)

Feature Dev - 全流程需求開發

當前工作流狀態

!devflow-status 2>/dev/null || echo "無活躍工作流"

⛔ 三條鐵律（每一步都必須遵守）

鐵律 1: Gate = 停止。 遇到 🚦 時，必須用 AskUserQuestion 向用戶提問並等待回覆。不可跳過。

鐵律 2: Subagent = Agent 工具。 遇到 >>> 時，必須用 Agent 工具派發。禁止主 agent 自己做。

鐵律 3: 主 agent 是編排者，不是執行者。 - ✅ 能做: 派發 subagent、驗證產物、展示 Gate、調 MCP、git 操作、寫 progress.json/SUMMARY.md - ❌ 禁止: 寫業務程式碼、跑測試、分析邏輯、設計方案、審查程式碼、修 bug - 未完成時: 重新派發 subagent（最多 2 次），絕不自己動手

流程

Phase 1: 資訊收集

並行派發: - Agent({ subagent_type: "dev-researcher", prompt: "需求 TAPD-{ID}，從 TAPD/Knot MCP 收集資訊，輸出 docs/dev-workflow/{ID}/requirement-summary.md" }) - Agent({ subagent_type: "dev-analyzer", prompt: "需求: {簡述}。掃描程式碼庫分析影響範圍，輸出 docs/dev-workflow/{ID}/impact-analysis.md" })

驗證兩個檔案已生成。

Phase 2: 需求澄清

呼叫 superpowers:brainstorming skill，基於 Phase 1 內容與使用者討論。不可跳過。

🚦 Gate 1

用 AskUserQuestion 展示需求摘要 + 影響範圍。選項: [確認繼續] [補充資訊] [終止]。

Phase 3: 方案設計

Agent({ subagent_type: "dev-planner", prompt: "基於 requirement-summary.md 和 impact-analysis.md 設計方案，輸出 docs/dev-workflow/{ID}/PLAN.md" })

小蔥技能7w4.net有完整的技能分類。

驗證 PLAN.md 已生成。

🚦 Gate 2

用 AskUserQuestion 展示計劃摘要 + 檔案清單。選項: [確認繼續] [調整方案] [換方案]。 確認後建立分支: git checkout -b feature/{簡短英文描述}

Phase 4: 實現

判斷 PLAN.md：涉及業務邏輯/新介面/資料模型/多檔案 → 路徑 A (TDD)；純配置/文案/文件 → 路徑 B (直接實現)。

路徑 A (TDD):

Step 1 - RED: Agent({ subagent_type: "dev-tester", prompt: "基於 PLAN.md 寫測試（RED），執行確認失敗" })

驗證測試檔案已生成且用例 ≥ 1。未生成則重試。

Step 2 - GREEN: Agent({ subagent_type: "dev-implementer", prompt: "實現程式碼使測試通過（GREEN），執行所有測試確認通過，檢查覆蓋率，輸出 docs/dev-workflow/{ID}/test-report.md。未通過則繼續修復，不要提前返回。" })

未通過則重新派發 implementer（最多 2 次）。

路徑 B (直接實現):

Agent({ subagent_type: "dev-implementer", prompt: "按 PLAN.md 實現，無需測試" })

🚦 Gate 3

路徑 A: 測試全綠 + 覆蓋率 100% + lint 通過 → 自動過；否則 AskUserQuestion。 路徑 B: lint 通過 → 自動過；否則 AskUserQuestion。

Phase 5: 程式碼審查

Agent({ subagent_type: "dev-reviewer", prompt: "審查 git diff master...HEAD + requirement-summary.md，輸出 docs/dev-workflow/{ID}/REVIEW.md" })

驗證 REVIEW.md 已生成。

🚦 Gate 4

0 CRITICAL + 0 HIGH → 自動過；否則 AskUserQuestion 展示問題，選項: [通過] [修復後繼續] [終止]。 修復: 派發 implementer → 重新派發 reviewer（覆蓋 REVIEW.md）。最多 2 輪。

Phase 6: 交付

Agent({ subagent_type: "dev-deployer", prompt: "推送分支，通過 gongfeng MCP 建立 MR（目標 master），通過 tapd MCP 更新狀態為'已開發'，監控 CI。輸出 MR 連結 + CI 狀態。" })

🚦 Gate 5

用 AskUserQuestion 展示 MR + CI + token 統計。選項: [確認提交] [修改 MR] [暫不提交]。 確認後立即進入 Phase 7。

Phase 7: 收尾（⛔ 不可跳過，Gate 5 通過不等於結束）

1. 生成 docs/dev-workflow/{ID}/SUMMARY.md（格式見 references/summary-template.md）
2. 向用戶展示自我進化分析（有無值得追加到 CLAUDE.md 的經驗），詢問是否追加
3. 更新 progress.json 為 completed
4. 輸出完成總結: "✅ 工作流完成！需求/MR/耗時/產物目錄"

參考文件

• references/gate-protocol.md — Gate 詳細規則
• references/resume-protocol.md — 中斷恢復
• references/framework-routing.md — 框架路由
• references/summary-template.md — SUMMARY.md 格式

這是一個設計思路不錯的工作流 Skill，流程完整、有明確的人工確認節點，能幫助規範開發過程。但整體更像是流程規範文件，實際使用體驗和功能完整性還需驗證，目前能瞭解到的資訊有限。質量中等偏上，有亮點也有明顯短板。