一、前置依赖

确保系统已安装以下工具：
Git
Python ≥ 3.8（推荐 3.10+）
uv（新一代 Python 包管理器，比 pip 更快）
???? Spec Kit 使用 uv 而非 npm，与 OpenSpec 不同。

二、安装 Spec Kit

1. 安装 uv（若未安装）

然后重启终端或运行：

2. 安装 Spec Kit CLI（通过 uvx）

?? 注意：Spec Kit 的命令行工具叫 specify，不是 speckit。
你也可以全局安装以便重复使用：

验证安装：

三、在项目中初始化 Spec Kit（与 Claude Code 集成）

进入你的项目目录：

初始化 Spec Kit 项目：

例如：

按提示填写：

项目描述
技术栈（如 Node.js + Express, Python + FastAPI 等）
功能需求
? 初始化后，会自动生成：

• spec/ 目录：包含 plan.md（开发计划）、tasks.md（任务列表）、schema/（数据结构）
• .git/ 自动初始化（若未存在）
• 与 Claude Code 兼容的上下文结构

四、在 Claude Code 中使用 Spec Kit 规范

方法一：直接调用 specify 命令生成任务，再用 Claude Code 实现

方法二：让 Claude Code 读取 spec/ 目录内容作为上下文

Claude Code 支持读取整个项目上下文。当你在 VS Code 中启用 Claude Code 插件 后：

• 打开聊天窗口
• 输入指令如：“根据 spec/plan.md 实现用户注册功能”
• Claude Code 会自动参考 spec/ 下的规范生成符合要求的代码

???? 关键：所有需求必须先写入 spec/，再交给 Claude Code 实现，避免“氛围编码”。

五、典型工作流（Spec Kit + Claude Code）

1. 定义需求 → specify init
2. 拆解任务 → specify plan
3. 生成代码 → 在 Claude Code 中说：“按 spec/tasks.md 第3项实现 JWT 认证”
4. 验证与测试 → specify verify（可选，需配置测试规范）
5. 提交代码 → Claude Code 可自动 git add/commit

六、目录结构示例

???? 官方资源

???? 小贴士

Spec Kit 不依赖任何在线服务，所有流程本地运行，隐私安全。
与 OpenSpec 类似，但 Spec Kit 是 GitHub 官方出品，更轻量、聚焦 CLI。
如果你已用 OpenSpec，也可同时使用 Spec Kit，两者理念一致，工具链互补。