Claude Code中Spec Kit实现步骤完整指南

2026-06-20阅读 0热度 0

Claude

Spec Kit 是 GitHub 官方推出的规格驱动开发工具包，搭配 Claude Code 使用，能真正落地"先写规范、再生成代码"的高质量 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. 通过 uvx 安装 Spec Kit CLI

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

举个例子：

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 实现

# 生成具体开发任务
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 说明

? 小贴士

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