参考文章:使用局限
在 Claude Code 中使用 Spec Kit(由 GitHub 官方推出的规格驱动开发工具包),可以实现"先写规范、再生成代码"的高质量 AI 编程流程。以下是完整的安装与使用指南:
一、前置依赖
确保系统已安装以下工具:
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"
然后重启终端或运行:
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。
你也可以全局安装以便重复使用:
uv tool install --from git+https://github.com/github/spec-kit.git specify
验证安装:
specify --version
三、在项目中初始化 Spec Kit(与 Claude Code 集成)
进入你的项目目录:
cd your-project
初始化 Spec Kit 项目:
specify init <PROJECT_NAME>
例如:
specify init my-api-service
按提示填写:
项目描述
技术栈(如 Node.js + Express, Python + FastAPI 等)
功能需求
✅ 初始化后,会自动生成:
四、在 Claude Code 中使用 Spec Kit 规范
方法一:直接调用 specify 命令生成任务,再用 Claude Code 实现
# 生成具体开发任务
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
六、目录结构示例
my-project/
├── spec/
│ ├── plan.md # 整体开发计划
│ ├── tasks.md # 具体任务清单
│ └── schema/
│ └── user.json # 数据模型
├── src/ # Claude Code 生成的代码放这里
└── README.md
📚 官方资源
GitHub 仓库:https://github.com/github/spec-kit
官方文档:README.md 中有详细 CLI 说明
CSDN 实战教程:Spec-Kit + Claude Code:规格驱动AI编程工程化实战
💡 小贴士
Spec Kit 不依赖任何在线服务,所有流程本地运行,隐私安全。
与 OpenSpec 类似,但 Spec Kit 是 GitHub 官方出品,更轻量、聚焦 CLI。
如果你已用 OpenSpec,也可同时使用 Spec Kit,两者理念一致,工具链互补。