shinpr/claude-code-workflows

Development workflows for Claude Code that keep broad exploration focused on the outcome you approved.

Claude Code Development Workflows

是什麼 – 一組 Claude Code 插件，將 Claude Code AI 助手轉變為結構化的開發流程引擎。這些插件編碼了一套「食譜」（例如 /recipe‑implement、/recipe‑design、/recipe‑review），引導模型完成以下步驟：

範圍共識 – 使用者與 Claude 就期望結果及排除項目達成一致。
設計與規劃 – Claude 產生設計文件、UI 規格、ADR 和工作計畫，在撰寫任何程式碼前進行審查。
任務級實作 – 每個工作計畫項目被執行，根據倉儲特定的品質規則進行驗證，並自動提交。
獨立審查 – 第二階段的安全/審查代理在工作流程結束前檢查整個變更是否存在功能、可靠性或安全回退問題。

該系統有意分為三個插件家族：

插件	目標	典型入口點
`dev‑workflows`	後端或通用程式碼庫	`/recipe‑implement`、`/recipe‑design`、…
`dev‑workflows‑frontend`	React/TypeScript 前端	`/recipe‑front‑design`、`/recipe‑front‑build`、…
`dev‑workflows‑fullstack`	同時包含前後端的專案	`/recipe‑fullstack‑implement`、…

為何可能使用它

你需要在設計討論與實際程式碼生成之間建立正式交接，以確保 Claude 不會偏離已達成的產品目標。
你的團隊希望擁有可重複的安全門（設計審查、工作計畫審批、獨立安全審查），由插件自動強制執行。
你已使用 Claude Code，並希望在多個倉儲中保持相同的 AI 驅動工作流程，無需每次重新發明流程。

快速開始（來自 README）

# 1. 啟動 Claude Code
claude

# 2. 加入托管插件的市場
/plugin marketplace add shinpr/claude-code-workflows

# 3. 安裝與專案類型匹配的插件
#   – 後端 / 通用
/plugin install dev-workflows@claude-code-workflows
/recipe-implement "為公開 API 加入速率限制"

#   – React 前端
/plugin install dev-workflows-frontend@claude-code-workflows
/recipe-front-design "加入帳戶復原介面"

#   – 全端
/plugin install dev-workflows-fullstack@claude-code-workflows
/recipe-fullstack-implement "使用 JWT + 登入表單加入使用者驗證"

每個倉儲應只安裝一個工作流程插件；全端插件已包含後端和前端食譜。

工作流程如何運作（高階流程）

請求 → 確認結果與排除項目 →
   ┌─► 簡單路徑？ ──► 直接任務循環 → 完成
   │
   └─► 複雜？ → 檢查 → 設計 → 審查 → 批准範圍 →
        每個任務：實作 → 驗證 → 質量檢查 → 提交 →
        獨立安全審查 → （修正循環） → 完成

選擇哪條路徑取決於產品決策的複雜性，而非檔案數量。

插件引入的核心概念

工作計畫 – 將每個已批准的需求（來自設計文件、ADR、UI 規格等）映射到一個或多個具體任務的表格。未覆蓋的缺口會被標記，確保無遺漏。
任務範本 – 每個生成的任務都攜帶精確的接受標準和一個在提交前執行的「是/否」合規檢查。
品質設定檔 – 存放在 docs/project‑context/quality.yaml 中的倉儲特定的 lint、測試和安全規則。插件在每次驗證步驟中讀取此設定檔。
專用代理 – 插件協調一系列 AI 代理（如 requirement‑analyzer、code‑verifier、security‑reviewer），確保設計、實作和審查的關注點分離。

範例執行（來自 README 摘要）

使用者執行 /recipe‑implement "為公開 API 加入速率限制"。
Claude 分析倉儲，提出設計文件，使用者批准。
產生工作計畫，分為 4 個任務（加入中介層、更新設定、撰寫測試、更新文件）。
對每個任務，任務執行器 代理撰寫程式碼，程式碼驗證器 執行倉儲的品質設定檔，變更被提交。
所有任務完成後，安全審查器 代理進行獨立檢查；未發現問題，工作流程結束。

何時不需要

如果變更只是一個快速的原型，或結果與安全實作邊界已非常明確，你可以直接使用 Claude Code，無需額外工作流程開銷。

許可與貢獻

許可證：MIT（參見 README 中的徽章）。
貢獻：歡迎 PR；倉儲包含 PRs welcome 徽章。

總結

shinpr/claude-code-workflows 不是你要匯入自己程式碼中的函式庫；它是一個Claude Code 插件套件，為使用 Claude Code 的任何專案添加有紀律的、AI 驅動的開發流程。透過編碼設計審查、工作計畫審批、任務級驗證和獨立安全審查，它幫助團隊確保 Claude 生成的程式碼與已達成的產品目標和倉儲品質標準保持一致。