在 Claude Code 中使用 Spec Kit（由 GitHub 官方推出的规格驱动开发工具包），可以实现“先写规范、再生成代码”的高质量 AI 编程流程。以下是完整的安装与使用指南：
一、前置依赖
确保系统已安装以下工具：
Git
Python ≥ 3.8（推荐 3.10+）
uv（新一代 Python 包管理器，比 pip 更快）
???? Spec Kit 使用 uv 而非 npm，与 OpenSpec 不同。
二、安装 Spec Kit
1. 安装 uv（若未安装）
|
1 2 3 4 5 |
# 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" |
然后重启终端或运行：
|
1 |
source ~/.cargo/env # Linux/macOS |
2. 安装 Spec Kit CLI（通过 uvx）
|
1 |
uvx --from git+https://github.com/github/spec-kit.git specify --help |
?? 注意：Spec Kit 的命令行工具叫 specify，不是 speckit。
你也可以全局安装以便重复使用：
|
1 |
uv tool install --from git+https://github.com/github/spec-kit.git specify |
验证安装：
|
1 |
specify --version |
三、在项目中初始化 Spec Kit（与 Claude Code 集成）
进入你的项目目录：
|
1 |
cd your-project |
初始化 Spec Kit 项目：
|
1 |
specify init <PROJECT_NAME> |
例如：
|
1 |
specify init my-api-service |
按提示填写：
项目描述
技术栈（如 Node.js + Express, Python + FastAPI 等）
功能需求
? 初始化后，会自动生成：
- spec/ 目录：包含 plan.md（开发计划）、tasks.md（任务列表）、schema/（数据结构）
- .git/ 自动初始化（若未存在）
- 与 Claude Code 兼容的上下文结构
四、在 Claude Code 中使用 Spec Kit 规范
方法一：直接调用 specify 命令生成任务，再用 Claude Code 实现
|
1 2 3 4 |
# 生成具体开发任务 specify plan
# 输出任务后，在 Claude Code 中逐条实现 |
方法二：让 Claude Code 读取 spec/ 目录内容作为上下文
Claude Code 支持读取整个项目上下文。当你在 VS Code 中启用 Claude Code 插件 后：
- 打开聊天窗口
- 输入指令如：“根据 spec/plan.md 实现用户注册功能”
- Claude Code 会自动参考 spec/ 下的规范生成符合要求的代码
???? 关键：所有需求必须先写入 spec/，再交给 Claude Code 实现，避免“氛围编码”。
五、典型工作流（Spec Kit + Claude Code）
- 定义需求 → specify init
- 拆解任务 → specify plan
- 生成代码 → 在 Claude Code 中说：“按 spec/tasks.md 第3项实现 JWT 认证”
- 验证与测试 → specify verify（可选，需配置测试规范）
- 提交代码 → Claude Code 可自动 git add/commit
六、目录结构示例
|
1 2 3 4 5 6 7 8 |
my-project/ ├── spec/ │ ├── plan.md # 整体开发计划 │ ├── tasks.md # 具体任务清单 │ └── schema/ │ └── user.json # 数据模型 ├── src/ # Claude Code 生成的代码放这里 └── README.md |
???? 官方资源
GitHub 仓库：
官方文档：README.md 中有详细 CLI 说明
???? 小贴士
Spec Kit 不依赖任何在线服务，所有流程本地运行，隐私安全。
与 OpenSpec 类似，但 Spec Kit 是 GitHub 官方出品，更轻量、聚焦 CLI。
如果你已用 OpenSpec，也可同时使用 Spec Kit，两者理念一致，工具链互补。
