Spec Kit 是 GitHub 官方开源的规格驱动开发(Spec-Driven Development,SDD)工具包,GitHub 星标超过 10 万,代表了 AI 编程从「随手提示」走向「工程化流程」的方向。它解决的问题很实际:直接把需求丢给 Claude Code、GitHub Copilot 这类编程 Agent,产出质量高度依赖提示词运气,大任务经常跑偏。Spec Kit 把过程拆成显式阶段——先用 /specify 生成规格说明,再 /plan 产出技术方案,/tasks 拆解任务,最后 /implement 落地实现——每一步产物都是可评审、可修改的 markdown 文件,让人类在「意图层」把关,把编码执行交给 Agent。它是方法论工具,不绑定任何一家模型。
快速结论
如果你已经在用编程 Agent 做「超过一个文件改动」的功能开发,Spec Kit 值得引入:它把一次性提示变成可评审的规格与计划,大任务的可控性明显提升。写小脚本、修小 Bug 用不上它——流程开销大于收益。它完全免费,支持 Claude Code、Copilot、Gemini CLI、Cursor 等主流 Agent,几乎没有试错成本。
核心功能
specifyCLI 脚手架:一条命令初始化项目的 SDD 结构,生成宪章(constitution)、模板与斜杠命令。- 分阶段斜杠命令:
/specify写需求规格 →/plan定技术方案 →/tasks拆任务清单 →/implement执行实现,每步产物落盘可评审。 - 项目宪章机制:用
constitution.md固化技术栈、编码规范和不可妥协原则,约束 Agent 的每次决策。 - 多 Agent 支持:同一套规格流程可驱动 Claude Code、GitHub Copilot、Gemini CLI、Cursor 等,不锁定供应商。
- 规格即文档:spec、plan、tasks 文件随代码入库,天然形成可追溯的决策记录。
适合人群
适合已经把编程 Agent 用进真实项目的工程师和团队,尤其是需要多人协作、要对 AI 产出做评审的场景;也适合想给「氛围编程」上流程约束的技术负责人。不适合 AI 编程初学者(先熟悉基本的 Agent 工作流再上流程工具)、以及以小改动为主的使用者——为一个 20 行的修复走四阶段流程纯属自我折磨。
使用场景
- 新功能开发:从模糊需求到规格、方案、任务、实现,全程留痕,人只评审文档和最终 diff。
- 多人协作的 AI 开发:规格文件成为团队与 Agent 之间的契约,避免每个人各喂各的提示词。
- 遗留系统改造:先让 Agent 按宪章约束产出改造方案,评审通过再动手,降低失控风险。
- 技术方案沉淀:spec/plan 文件随仓库演进,新成员和新 Agent 会话都能快速对齐上下文。
价格与版本
| 版本 | 价格判断 | 适合对象 | 说明 |
|---|---|---|---|
| 开源版 | 完全免费 | 所有用户 | MIT 协议,uvx/pip 安装 CLI 即用 |
Spec Kit 本身零成本,实际开销来自它驱动的编程 Agent(Claude Code、Copilot 等的订阅或 API 费用)。
国内访问与使用体验
Spec Kit 托管在 GitHub,仓库、文档与 CLI 安装在大陆一般可正常访问,工具本身在本地运行无网络依赖。实际使用体验取决于所搭配的编程 Agent 的可用性:搭配国内可用的 Agent 与模型即可全流程直连使用。模板与文档为英文,但生成的规格内容语言跟随你的输入,中文需求写中文规格没有障碍。
优点
- 把 AI 编程从提示词玄学变成可评审的工程流程,大任务成功率与可控性提升明显。
- GitHub 官方出品、社区庞大,模板与最佳实践迭代快。
- 不绑定模型与 Agent,已有工具链可以无缝套用。
- 产物全是 markdown,零学习成本即可评审、diff、入库。
不足
- 流程开销真实存在,小任务用它得不偿失。
- 效果依赖使用者写清规格的能力,垃圾进垃圾出的规律不变。
- 四阶段模板较为固定,与部分团队现有研发流程需要磨合。
- 本质是约定和模板的集合,期待它「自动提升代码质量」会失望。
替代品对比
| 工具 | 更适合 | 与 Spec Kit 的区别 |
|---|---|---|
| Claude Code | 交互式终端开发 | 是 Spec Kit 驱动的执行引擎之一,两者是配合关系 |
| GitHub Copilot | IDE 内补全与对话 | Copilot 负责写代码,Spec Kit 负责让写之前先有规格 |
| Cursor | IDE 形态的 AI 开发 | Cursor 的 rules 提供轻量约束,Spec Kit 的流程更重更完整 |
| Superpowers | 给 Claude Code 加技能与工作流 | Superpowers 是技能库生态,Spec Kit 是单一明确的 SDD 方法论 |
常见问题 FAQ
Spec Kit 是免费的吗?
是,MIT 开源,无任何付费版本;成本只来自你搭配的编程 Agent。
国内能用吗?
可以。GitHub 仓库与 CLI 安装一般可直连,工具本地运行;搭配国内可用的模型即可完整使用。
适合新手吗?
不太适合。建议先用熟 Claude Code 或 Copilot 的基本工作流,再引入 SDD 流程,否则容易被流程本身绊住。
和直接写提示词比好在哪?
规格和计划是显式产物,人可以在便宜的阶段(评审文档)纠错,而不是在昂贵的阶段(评审烂代码)返工。
必须用 GitHub 的产品吗?
不必须。虽然是 GitHub 出品,但它支持 Claude Code、Gemini CLI、Cursor 等多种 Agent,与是否使用 GitHub 平台无关。
总结
Spec Kit 回答的是 AI 编程时代「流程长什么样」的问题:需求先变成可评审的规格,再变成代码。它不会让弱模型变强,但能让强模型的产出可控、可协作、可追溯。已经在用 Claude Code 或 Copilot 做正经项目的团队,值得花一个下午把它跑通。