Claude Code中使用Spec Kit的實(shí)現(xiàn)步驟
在 Claude Code 中使用 Spec Kit(由 GitHub 官方推出的規(guī)格驅(qū)動開發(fā)工具包),可以實(shí)現(xiàn)“先寫規(guī)范、再生成代碼”的高質(zhì)量 AI 編程流程。以下是完整的安裝與使用指南:
一、前置依賴
確保系統(tǒng)已安裝以下工具:
Git
Python ≥ 3.8(推薦 3.10+)
uv(新一代 Python 包管理器,比 pip 更快)
?? Spec Kit 使用 uv 而非 npm,與 OpenSpec 不同。
二、安裝 Spec Kit
1. 安裝 uv(若未安裝)
# Linux/macOS curl -LsSf https://astral.sh/uv/install.sh | sh # Windows (PowerShell) powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
然后重啟終端或運(yùn)行:
source ~/.cargo/env ?# Linux/macOS
2. 安裝 Spec Kit CLI(通過 uvx)
uvx --from git+https://github.com/github/spec-kit.git specify --help
?? 注意:Spec Kit 的命令行工具叫 specify,不是 speckit。
你也可以全局安裝以便重復(fù)使用:
uv tool install --from git+https://github.com/github/spec-kit.git specify
驗(yàn)證安裝:
specify --version
三、在項(xiàng)目中初始化 Spec Kit(與 Claude Code 集成)
進(jìn)入你的項(xiàng)目目錄:
cd your-project
初始化 Spec Kit 項(xiàng)目:
specify init <PROJECT_NAME>
例如:
specify init my-api-service
按提示填寫:
項(xiàng)目描述
技術(shù)棧(如 Node.js + Express, Python + FastAPI 等)
功能需求
? 初始化后,會自動生成:
- spec/ 目錄:包含 plan.md(開發(fā)計劃)、tasks.md(任務(wù)列表)、schema/(數(shù)據(jù)結(jié)構(gòu))
- .git/ 自動初始化(若未存在)
- 與 Claude Code 兼容的上下文結(jié)構(gòu)
四、在 Claude Code 中使用 Spec Kit 規(guī)范
方法一:直接調(diào)用 specify 命令生成任務(wù),再用 Claude Code 實(shí)現(xiàn)
# 生成具體開發(fā)任務(wù) specify plan # 輸出任務(wù)后,在 Claude Code 中逐條實(shí)現(xiàn)
方法二:讓 Claude Code 讀取 spec/ 目錄內(nèi)容作為上下文
Claude Code 支持讀取整個項(xiàng)目上下文。當(dāng)你在 VS Code 中啟用 Claude Code 插件 后:
- 打開聊天窗口
- 輸入指令如:“根據(jù) spec/plan.md 實(shí)現(xiàn)用戶注冊功能”
- Claude Code 會自動參考 spec/ 下的規(guī)范生成符合要求的代碼
?? 關(guān)鍵:所有需求必須先寫入 spec/,再交給 Claude Code 實(shí)現(xiàn),避免“氛圍編碼”。
五、典型工作流(Spec Kit + Claude Code)
- 定義需求 → specify init
- 拆解任務(wù) → specify plan
- 生成代碼 → 在 Claude Code 中說:“按 spec/tasks.md 第3項(xiàng)實(shí)現(xiàn) JWT 認(rèn)證”
- 驗(yàn)證與測試 → specify verify(可選,需配置測試規(guī)范)
- 提交代碼 → Claude Code 可自動 git add/commit
六、目錄結(jié)構(gòu)示例
my-project/ ├── spec/ │ ? ├── plan.md ? ? ? ? ?# 整體開發(fā)計劃 │ ? ├── tasks.md ? ? ? ? # 具體任務(wù)清單 │ ? └── schema/ │ ? ? ? └── user.json ? ?# 數(shù)據(jù)模型 ├── src/ ? ? ? ? ? ? ? ? # Claude Code 生成的代碼放這里 └── README.md
?? 官方資源
GitHub 倉庫:https://github.com/github/spec-kit
官方文檔:README.md 中有詳細(xì) CLI 說明
?? 小貼士
Spec Kit 不依賴任何在線服務(wù),所有流程本地運(yùn)行,隱私安全。
與 OpenSpec 類似,但 Spec Kit 是 GitHub 官方出品,更輕量、聚焦 CLI。
如果你已用 OpenSpec,也可同時使用 Spec Kit,兩者理念一致,工具鏈互補(bǔ)。
到此這篇關(guān)于Claude Code中使用Spec Kit的實(shí)現(xiàn)步驟的文章就介紹到這了,更多相關(guān)Claude Code使用Spec Kit內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

Harness實(shí)戰(zhàn)指南之如何在Java Spring Boot項(xiàng)目中規(guī)范落地OpenSpec+Claude Code
Harness并非新概念,而是工程實(shí)踐的系統(tǒng)化,通過規(guī)則、權(quán)限、審查等檢查,確保AI編碼可控且高效,適用于有歷史包袱、需求增量改造的的JavaSpringBoot項(xiàng)目,本文介紹Harness實(shí)戰(zhàn)2026-06-02


