P-IT Blog
用Claude Code搭配 spec-kit 開發程序體驗

用Claude Code搭配 spec-kit 開發程序體驗

告別「玄學編程」！Claude Code 搭配 spec-kit 開啟 AI 開發新紀元

還在憑感覺寫代碼（Vibe Coding）嗎？將模糊的想法丟給 AI，然後花整個下午在「生成代碼 -> 報錯 -> 再生成」的循環中崩潰？

今天介紹一套真正的「規格驅動開發」（Spec-Driven Development, SDD）組合拳：Claude Code + spec-kit。它通過一套結構化的工作流，強迫 AI 在寫代碼前先思考、先規劃，讓你的開發過程從「抽盲盒」變成精密的工程實施。

🛠️ 什麼是 Spec-Driven Development (SDD)？

SDD 的核心理念即使簡單：先規格，後實作。 有了 spec-kit，原本枯燥的文檔編寫變成了與 Claude Code 對話的過程。這些規格不再是靜態的文字，而是驅動 AI 工作的可執行指令。

� 實戰工作流：六步走

以下是使用 Claude Code 搭配 spec-kit 的標準開發流程。請務必熟悉這些步驟和指令，它們是高質量代碼的保證。

步驟 (Step) 指令 (Command) 說明 (Description)
1. 安裝與初始化 specify init 安裝並初始化項目，配置 Claude 為你的 AI 助手。
2. 確立原則 /speckit.constitution 定義項目的「憲法」：代碼風格、測試標準、性能要求等。這是所有後續工作的基石。
3. 定義需求 /speckit.specify 告訴 Claude 你想做什麼（What）。它會生成詳細的需求規格書。
4. 技術規劃 /speckit.plan 告訴 Claude 怎麼做（How）。基於需求，生成技術架構、數據模型和接口定義。
5. 拆解任務 /speckit.tasks 將計劃拆解為一系列依賴清晰的原子任務清單，確保執行有序。
6. 執行實作 /speckit.implement Claude Code 自動執行任務清單，編寫代碼並進行驗證。

� 詳細操作指南

1. 安裝與初始化 (Installation)

首先，你需要安裝 specify-cli 工具並初始化你的項目。我們推薦使用 uv 來管理工具。

# 安裝 specify-cli
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# 初始化項目，指定使用 claude
specify init my-project --ai claude

執行後，你會看到項目中多了 .spec-kit 目錄，這裡存放著所有的規格文件。

2. 確立原則 (Constitution)

在開始寫代碼前，先立規矩。這一步往往被忽略，但在 AI 輔助開發中至關重要。

/speckit.constitution

Claude 會引導你定義：

  • 代碼規範：例如 "Python 代碼必須符合 PEP 8 標準"
  • 測試要求：例如 "所有新功能必須包含單元測試"
  • 架構原則：例如 "採用模塊化設計，避免循環依賴"

3. 定義需求 (Specify)

現在，用自然語言描述你的功能。不需要太詳細，Claude 會幫你補充。

/speckit.specify "我需要一個用戶登錄系統，支持郵箱和 GitHub 登錄"

Claude 會生成一份 specifications/user-login.md，其中包含：

  • 用戶故事 (User Stories)
  • 功能性需求
  • 驗證標準

此時，Claude 可能會反問你：

"是否需要支持密碼找回功能？" "GitHub 登錄失敗時如何處理？" 通過這一步 Clarify（釐清），你們共同完善了需求。

4. 技術規劃 (Plan)

需求確認後，發布計劃指令。

/speckit.plan

Claude 會分析現有代碼庫，並生成一份詳細的實施計劃 (Implementation Plan)，包括：

  • 需要修改的文件列表
  • 新增的數據庫 Schema
  • API 接口定義
  • 依賴庫變更

5. 拆解任務 (Tasks)

有了計劃，讓 Claude 把它變成可執行的任務清單。

/speckit.tasks

它會生成類似這樣的清單：

    1. 設置數據庫遷移文件
    1. 實現 User 模型
    1. 編寫登錄 API 邏輯
    1. 集成 GitHub OAuth

6. 執行實作 (Implement)

最後，見證魔法的時刻。

/speckit.implement

Claude Code 會自動讀取任務清單，逐個執行。它會：

  1. 創建文件
  2. 編寫代碼
  3. 運行測試
  4. 遇到錯誤自動修復
  5. 勾選完成的任務

你只需在旁邊喝咖啡，或者參與 Code Review。

✨ 為什麼這比直接生成代碼更好？

  1. 上下文連貫：從原則到計畫再到代碼，每一步都有跡可循，避免了 AI "瞎編"。
  2. 減少幻覺：因為有明確的 spec 文檔作為約束，AI 不會隨意發揮。
  3. 文檔即代碼：開發完成時，你自然擁有了一套完整的項目文檔。

📝 結語

Claude Code + spec-kit 將「人」的角色從「寫代碼的工匠」提升為「定義規格的建築師」。 如果你想體驗這種掌控全局的開發快感，現在就試試吧！

參考資料：Spec Kit GitHub Repository, Claude Code Documentation