Claude Code 实战：Spec-Kit、Kiro、OpenSpec 规范驱动开发三剑客

引言：AI 编码从"猜"到"算"，规范驱动是关键

2025 年，Claude 3.5 Sonnet 通过 Claude Code 插件已经成为很多开发者的"标配"。它的斜杠命令 和子代理功能，让 AI 不再是"你说我猜"的工具，而是能严格按照你的"规格说明书"干活的助手。

今天我们要聊的 Spec-Kit 、Kiro 和 OpenSpec ，就是规范驱动开发（Spec-Driven Development）的三大神器。它们和 Claude Code 结合，能实现 "自然语言 → 清晰规格 → 高质量代码" 的闭环，彻底解决 AI 生成代码"不可控、有漏洞"的痛点。

本文会从 集成方式、工作流程、实战案例 三个维度，对比这三个工具在 Claude Code 中的应用，还会给你每个工具的 10 分钟快速上手指南。读完你就知道：

企业级项目要合规、讲治理，选 Spec-Kit；
小团队快速做原型、要效率，选 Kiro；
维护老项目、怕改崩，选 OpenSpec。

一、三剑客速览：各自的核心本领

在深入细节前，先快速了解下这三个工具和 Claude Code 是怎么"合作"的：

工具	核心定位	和 Claude Code 集成方式	最大优势	适合场景
Spec-Kit	企业级规范治理工具	原生斜杠命令（`/speckit` 系列）+ 子代理分工	有"项目宪法"，强制 AI 守规矩	团队协作、标准化开发、合规要求高
Kiro	代理式 IDE，快速原型神器	Claude Code 嵌入 Kiro 终端 + 聊天式代理	自动化钩子，全程不用手动操作	个人/小团队、快速迭代、UI 原型
OpenSpec	棕地项目安全迭代框架	原生斜杠命令（`/openspec` 系列）+ Delta 变更隔离	变更可审计，不破坏老代码	维护遗留系统、风险控制、团队共识

二、深度对比：在 Claude Code 里怎么用？

1. 集成机制：Claude 是"指挥官"还是"助手"？

Spec-Kit ：Claude 是"指挥官"。你在 Claude 聊天框里敲 /speckit.specify，它就会帮你生成规格；敲 /speckit.implement，它就会按规格生成代码。还支持子代理------一个 Claude 负责澄清规格，另一个负责写代码，分工明确。
Kiro：Claude 是"嵌入式助手"。你在 Kiro IDE 的聊天框里跟 Claude 说"我要加个用户过滤"，它会帮你规划规格，然后 Kiro 会自动调用钩子（比如 lint、测试），最后在终端执行生成命令。
OpenSpec ：Claude 是"审查官"。你用 /openspec:proposal 生成变更提案，Claude 会帮你审查提案是否合理、Delta 变更是否安全，然后再用 /openspec:apply 生成代码。

2. 工作流程：从想法到代码的路径

特点：

Spec-Kit + Claude Code ：流程严谨，每一步都有 Claude 把关，适合对质量和合规要求高的企业项目。
Kiro + Claude Code：全程聊天交互，自动化程度高，适合快速验证想法，原型开发速度能翻倍。
OpenSpec + Claude Code：变更隔离，每一步都有审查，适合改老项目，不怕"牵一发而动全身"。

3. 实战案例：加一个"用户过滤搜索"功能

我们用同一个需求，看三个工具在 Claude Code 里的表现：

Spec-Kit：15 分钟，质量有保障

在 Claude 里敲 /speckit.specify "添加用户搜索过滤，支持按角色（admin/user）和关键词过滤"；
Claude 生成 spec.md，然后自动问你："过滤结果需要分页吗？"（澄清环节）；
你回答"需要"，Claude 更新 spec；
敲 /speckit.implement，Claude 生成 React 组件、API 调用、单元测试（因为宪法里要求写测试）；
敲 /speckit.analyze，Claude 检查代码是否符合规范，比如"测试覆盖率够不够"。

结果：代码质量高，符合团队规范，但流程稍长。

Kiro：10 分钟，全程自动化

在 Kiro IDE 聊天框里跟 Claude 说："我要加个用户过滤搜索，支持角色和关键词"；
Claude 生成 spec.md，Kiro 代理自动规划："先写 UI 组件，再对接后端接口，最后加测试"；
你点头，敲 /kiro:generate；
Kiro 自动调用 Claude 生成代码，然后钩子自动运行 npm run lint 和 npm test；
你在聊天框里跟 Claude 说"把搜索按钮改成蓝色"，Claude 自动更新代码；
敲 /kiro:deploy，钩子自动 Git push。

结果：速度快，不用手动操作，但规范约束弱。

OpenSpec：8 分钟，安全无风险

在 Claude 里敲 /openspec:proposal add-filter；
Claude 生成 proposal.md（说明为什么要加这个功能）和 Delta 变更（只改需要改的文件）；
敲 /openspec:review，Claude 审查："这个变更不会影响现有用户列表接口，安全"；
敲 /openspec:apply，Claude 生成代码，放在 openspec/changes/add-filter 目录；
你手动检查代码，没问题后敲 openspec archive，代码合并到主项目，同时归档变更历史。

结果：变更安全，可审计，但需要手动合并。

三、Claude Code 专属快速上手指南

1. Spec-Kit + Claude Code（8 分钟搞定）

前提：安装 Python 和 uv。

安装 Spec-Kit ：

bash 复制代码

pip install uv
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

配置 Claude Code ：
- 在 VS Code 里安装 Claude Code 插件；
- 打开插件设置，找到"AI Tools"，勾选"Enable Spec-Kit"。

初始化项目 ：

bash 复制代码

mkdir my-app && cd my-app
specify init my-app --ai claude

实战：加用户过滤 ：
- 在 Claude 聊天框里敲：/speckit.constitution，Claude 生成 constitution.md，你编辑加上"必须写单元测试"；
- 再敲：/speckit.specify "用户搜索过滤，支持角色和关键词"；
- Claude 澄清后，敲：/speckit.implement；
- 最后敲：/speckit.analyze 检查质量。

常见问题 ：如果 uv 安装失败，换 pip install specify-cli。

2. Kiro + Claude Code（6 分钟搞定）

安装 Kiro IDE ：
- 从 kiro.dev 下载并安装；
- 在 Kiro 里安装 Claude Code 插件（和 VS Code 操作一样）。
配置 Claude ：
- 打开 Kiro 终端，敲 claude-code init；
- 在 Kiro 聊天框里导入 steering.md（项目规则文件）。
实战：加用户过滤 ：
- 在 Kiro 聊天框里跟 Claude 说："帮我加个用户过滤搜索"；
- Claude 生成 spec.md，你点头；
- 敲 /kiro:generate，Kiro 自动生成代码并运行测试；
- 不满意就跟 Claude 说"改一下按钮颜色"，自动更新。

常见问题：如果 Kiro 终端找不到 Claude，重新安装插件并重启。

3. OpenSpec + Claude Code（5 分钟搞定）

前提：安装 Node.js（≥20）和 npm。

安装 OpenSpec ：

bash 复制代码

npm install -g @fission-ai/openspec@latest

配置 Claude Code ：
- 安装 Claude Code 插件后，它会自动识别 OpenSpec；
- 如果没识别，编辑 openspec/AGENTS.md，加上 Claude 的配置。
初始化项目 ：
bash 复制代码
```
cd my-project
openspec init
```
实战：加用户过滤 ：
- 在 Claude 聊天框里敲：/openspec:proposal add-filter；
- Claude 生成 proposal.md 和 Delta 变更；
- 敲 /openspec:review，Claude 审查；
- 敲 /openspec:apply 生成代码；
- 检查没问题后，敲 openspec archive add-filter --yes。

常见问题 ：如果 openspec 命令找不到，重启终端或重新安装。

四、选择建议：按场景选，不踩坑

场景	推荐工具	理由
企业级项目、多人协作	Spec-Kit	有宪法治理，确保 AI 生成代码符合规范
快速原型、小团队迭代	Kiro	自动化程度高，聊天交互效率高
维护老项目、风险控制	OpenSpec	变更隔离，可审计，不破坏现有代码
混合场景（原型+维护）	Kiro + OpenSpec	用 Kiro 做原型，用 OpenSpec 合并到主项目

五、总结：AI 编码的未来是"规范驱动"

Claude Code 让 AI 能听懂你的"规矩"，而 Spec-Kit、Kiro、OpenSpec 就是把"规矩"落地的工具。它们各有侧重，但核心都是让 AI 编码从"靠感觉"变成"按图纸施工"。

现在就动手试试吧：

想体验规范治理，从 /speckit.specify 开始；
想快速做原型，打开 Kiro 跟 Claude 聊两句；
想安全改老项目，用 /openspec:proposal 提交变更。

欢迎在评论区分享你的实战经验，我们一起把 AI 编码玩得更溜！