shinpr/claude-code-workflows

它解決了什麼問題

Claude Code Workflows 提供了一種結構化的、具代理能力的開發生命週期，確保產生的程式碼嚴格符合設計文件與測試。它透過為開發流程的每個階段引入專門代理，防止 AI 產生的程式碼偏離原始需求或無法通過自身測試的常見問題。

它是如何運作的

該專案實作了一系列「食譜」（入口點），將使用者請求導引至一系列專門代理的管道。根據任務複雜度（小、中、大），工作流程會有所不同：

• 分析與規劃：requirement-analyzer 判斷工作規模。對於較大的任務，它會觸發產品需求文件（PRD）的建立、程式碼庫分析以及技術設計文件。

• 執行：專門的執行者（後端或前端）使用測試驅動開發（TDD）實作功能，確保程式碼經過類型檢查與 lint。

• 驗證：code-reviewer 與 code-verifier 會根據設計文件檢查實作，確保沒有遺漏任何需求。

• 診斷：在 investigator、verifier 與 solver 之間的專用迴圈用於根本原因分析錯誤，並提出經過權衡分析的解決方案。

• 逆向工程：系統可以掃描現有程式碼以產生 PRD 與設計文件，使舊程式碼庫變得 AI 友好。

適合對象

使用 Claude Code 的開發者，若希望擁有比簡單聊天式程式碼生成更具決定性、專業的軟體工程流程，則此專案適合您。特別適合從事後端 API、React/TypeScript 前端或全端應用程式開發的人員。

特色

• 層級感知工作流程：後端、前端與全端開發的獨立插件，各具專門代理（例如 React 的 ui-spec-designer）。
• 多代理協調：使用代理鏈（Analyzer $ ightarrow$ Designer $ ightarrow$ Planner $ ightarrow$ Executor $ ightarrow$ Reviewer）來保持乾淨的上下文視窗。
• UI 規格：前端工作的專門步驟，用於捕捉原型常遺漏的邊緣情況（載入、錯誤、空白狀態）。
• 自動化文件生成：能將現有程式碼逆向工程為結構化的 PRD 與設計文件。
• TDD 整合：內建測試優先實作與品質修正的原則。