Claude Code 通過 Spec Workflow 規範驅動開發

2025-09-07

往往我們在使用 AI 助手時，都期望隨面丟一句話就期望 AI 能給你完整的答案，但其實我們都要花時間在調整 AI 給出來的答案，Spec Workflow MCP 讓 Claude Code 遵守軟體工程的路徑：需求分析 → 架構設計 → 任務分解 → 實現程式碼的工作流工具，目的是在引導 AI 系統化地完成軟體開發，確保程式碼與業務需求的一致性。
另外一個是 Bug Fix Workflow，這個功能的流程：報告 → 修復 → 驗證，目的是在引導 AI 分析根本原因，修正它，並驗證結果，讓修復流程更有效率，

Spec Workflow 核心功能與優勢

系統性工作流程： AI 按照順序完成任務，保持專注和上下文。
完整追蹤：從使用者故事到程式碼實現，全程可追蹤。
標準化文檔：提供需求、設計、任務的結構化文檔模板，自動化進度管理。
階段性確認：每個階段都需要使用者確認，確保專案方向正確。
進度持久化：支援進度保存，即使新建對話，也能透過 check 指令繼續先前的工作。

開發環境

WSL 2 + Ubuntu 24.04
Claude Code 1.0.108
spec workflow mcp
- npm 位置：https://www.npmjs.com/package/@pimzino/spec-workflow-mcp
- github 位置：https://github.com/kingkongshot/specs-workflow-mcp/tree/main

安裝

全域安装

npm i -g @pimzino/claude-code-spec-workflow

在專案資料夾執行安裝指令

claude-code-spec-workflow

安裝後，在專案資料夾 .claude/commands 會有以下 command

/spec-create             Spec Create Command (project, gitignored)
/spec-execute            Spec Execute Command (project, gitignored)
/spec-steering-setup     Spec Steering Setup Command (project, gitignored)
/spec-status             Spec Status Command (project, gitignored)
/spec-list               Spec List Command (project, gitignored)
/bug-create         Bug Create Command (project, gitignored)
/bug-fix            Bug Fix Command (project, gitignored)
/bug-status         Bug Status Command (project, gitignored)
/bug-analyze        Bug Analyze Command (project, gitignored)
/bug-verify         Bug Verify Command (project, gitignored)

或者用 Claude 安裝 MCP

claude mcp add spec-workflow-mcp -s user -- npx -y spec-workflow-mcp@latest

Note：就沒有上述 command

其他 MCP

claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp
claude mcp add --scope user github npx @modelcontextprotocol/server-github
claude mcp add --scope user sequential-thinking npx @modelcontextprotocol/server-sequential-thinking

使用步驟

詳細描述你的需求

使用 spec workflow 建立一個 event-bus 平台

確認需求並往下一步
AI 會逐步的建立結構化的文檔，如下
📝 requirements.md - 用戶故事和功能需求
🎨 design.md - 技術架構和設計、流程圖
✅ tasks.md - 實踐任務列表
.workflow-confirmations.json - 狀態：進度追蹤

你只需要專心地把技術架構、流程圖確認好。
若中途離開，下次要再繼續則使用 spec workflow 關鍵字，例如，使用 spec workflow 繼續下一步。這時候 AI 會先確認當前的狀態，才會決定下一步動作。

假使你有自己的開發規範，也可以整合到目前的流程。

以下是我的工作流程

開始前的約束，用 # 記憶功能

- 有關 spec workflow 的文檔放在 ./.spec 資料夾
- 編碼原則要參考 ./.specs/code_style.md

建立範例

可以給 AI 範例，開發守則它會更精準的產出你需要的程式碼

使用 sub-module 的方式把 https://github.com/yaochangyu/api.template.git 專案放到 ./.specs/examples 資料夾，以這個範例為開發原則，並將原則寫入到 ./.specs/code_style.md 檔。

描述需求，再根據 AI 產生出來的修改或是一開始就寫清楚一點
```
使用 spec workflow 建立一個 event-bus 平台
```
確定需求沒有問題，就用 "繼續"
如果發現有問題，可以跟他講要怎麼改，文檔或是程式碼確定沒有問題後，使用
```
spec workflow 繼續下一步
```