Spec-Kit 使用指南
什么是Spec-Kit？
Spec-Kit是GitHub开源的一个工具包，用于实现规格驱动开发（Spec-Driven Development）。它与AI编码工具（如GitHub Copilot、Claude Code、Gemini CLI）集成，帮助开发者构建更高质量的软件。
解决的核心痛点
● "氛围编码"问题：传统AI编码中，你描述目标，得到代码块，但往往"看起来对，但实际不工作"
● 缺乏结构化流程：从想法到实现缺乏清晰的步骤和检查点
● 质量不一致：生成的代码缺乏统一的质量标准和测试覆盖
主要功能
1. 规格优先开发：先写规格说明，再生成代码
2. 四阶段工作流：Specify（规格化） → Plan（规划） → Tasks（任务分解） → Implement（实现）
3. 强制测试驱动开发（TDD）：必须先生成测试，再生成实现代码
4. 与AI工具无缝集成：支持Claude Code、GitHub Copilot等
环境准备与安装
前提条件（以Claude Code + macOS为例）
● 系统要求：macOS（支持Apple Silicon和Intel芯片）
● Claude Code：已安装Claude Code CLI
● Claude订阅：Claude Pro（20/月）或ClaudeMax（20/月）或Claude Max（20/月）或ClaudeMax（100/月）
● Python环境：Python 3.8+
安装步骤
1. 安装uv包管理器
2. 验证Claude Code安装
3. 从零开始构建项目
(若已有项目)集成Spec-Kit
4. 启动Claude Code
5. 验证安装
在Claude Code中检查是否有
关键命令
完整工作流程
阶段0：Build（构建）
目标：设置项目环境和初始化Spec-Kit
1. 按照上述安装步骤完成环境配置
2. 确认所有命令可用
3. 准备开始规格驱动开发
阶段1：Specify（规格化）
目标：明确项目需求和规格
执行命令
使用
● 专注于什么和为什么，而不是技术栈
● 描述用户旅程和体验
● 定义成功标准
示例：
审查和修改
执行
重点关注：
● 业务逻辑准确性：是否符合你的业务需求
● 功能完整性：是否遗漏重要功能
● 边界条件：错误处理、异常情况
● 性能要求：响应时间、并发用户数等
● 安全要求：认证、授权、数据保护
阶段2：Plan（规划）
目标：制定技术实现计划
执行命令
使用
示例：
审查技术计划
Claude Code会生成详细的技术计划，包括：
● 架构设计：系统整体架构
● 技术栈选择：前后端技术栈
● 数据库设计：数据模型和关系
● API端点规划：RESTful API设计
● 部署策略：部署和运维方案
阶段3：Tasks（任务分解）
目标：将规格和计划分解为可执行任务
执行命令
任务列表管理
生成的任务列表需要你：
● 优先级排序：调整任务执行顺序
● 任务细化：对复杂任务进一步分解
什么是Spec-Kit？
Spec-Kit是GitHub开源的一个工具包，用于实现规格驱动开发（Spec-Driven Development）。它与AI编码工具（如GitHub Copilot、Claude Code、Gemini CLI）集成，帮助开发者构建更高质量的软件。
解决的核心痛点
● "氛围编码"问题：传统AI编码中，你描述目标，得到代码块，但往往"看起来对，但实际不工作"
● 缺乏结构化流程：从想法到实现缺乏清晰的步骤和检查点
● 质量不一致：生成的代码缺乏统一的质量标准和测试覆盖
主要功能
1. 规格优先开发：先写规格说明，再生成代码
2. 四阶段工作流：Specify（规格化） → Plan（规划） → Tasks（任务分解） → Implement（实现）
3. 强制测试驱动开发（TDD）：必须先生成测试，再生成实现代码
4. 与AI工具无缝集成：支持Claude Code、GitHub Copilot等
环境准备与安装
前提条件（以Claude Code + macOS为例）
● 系统要求：macOS（支持Apple Silicon和Intel芯片）
● Claude Code：已安装Claude Code CLI
● Claude订阅：Claude Pro（20/月）或ClaudeMax（20/月）或Claude Max（20/月）或ClaudeMax（100/月）
● Python环境：Python 3.8+
安装步骤
1. 安装uv包管理器
brew install uv
2. 验证Claude Code安装
claude doctor
3. 从零开始构建项目
uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>
(若已有项目)集成Spec-Kit
uvx --from git+https://github.com/github/spec-kit.git specify init --here
4. 启动Claude Code
# 进入项目文件夹
cd <PROJECT_NAME>
# 启动claude code
claude
5. 验证安装
在Claude Code中检查是否有
/specify命令可用。关键命令
完整工作流程
阶段0：Build（构建）
目标：设置项目环境和初始化Spec-Kit
1. 按照上述安装步骤完成环境配置
2. 确认所有命令可用
3. 准备开始规格驱动开发
阶段1：Specify（规格化）
目标：明确项目需求和规格
执行命令
使用
/specify命令描述你要构建的内容：● 专注于什么和为什么，而不是技术栈
● 描述用户旅程和体验
● 定义成功标准
示例：
/specify 我需要构建一个用户注册系统，允许用户通过邮箱注册账号，验证邮箱地址，并在注册成功后自动登录
审查和修改
执行
/specify命令后，Claude Code会生成详细的规格文档（spec.md）。你需要审查并修改：重点关注：
● 业务逻辑准确性：是否符合你的业务需求
● 功能完整性：是否遗漏重要功能
● 边界条件：错误处理、异常情况
● 性能要求：响应时间、并发用户数等
● 安全要求：认证、授权、数据保护
阶段2：Plan（规划）
目标：制定技术实现计划
执行命令
使用
/plan命令提供技术实现规划：示例：
/plan 使用Node.js + Express.js后端，MongoDB数据库，JWT认证，nodemailer发送验证邮件
审查技术计划
Claude Code会生成详细的技术计划，包括：
● 架构设计：系统整体架构
● 技术栈选择：前后端技术栈
● 数据库设计：数据模型和关系
● API端点规划：RESTful API设计
● 部署策略：部署和运维方案
阶段3：Tasks（任务分解）
目标：将规格和计划分解为可执行任务
执行命令
/tasks 将上述规格和计划分解为可执行的开发任务
任务列表管理
生成的任务列表需要你：
● 优先级排序：调整任务执行顺序
● 任务细化：对复杂任务进一步分解
