先说结论
Spec Kit(github/spec-kit)是 GitHub 官方开源的「规格驱动开发」工具包,给 Claude Code、Copilot、Codex 这类 AI 编程代理装上一套固定工序:先写清楚要做什么,再让 AI 动手。截至 2026 年 11 月 5 日,它有 147,268 颗星,MIT 协议,最新版本 v1.3.0 发布于 11 月 3 日,前一天刚发过 v1.2.6。
本文信息全部来自它的官方 README、文档站(github.github.io/spec-kit)和 GitHub 发布记录,我们整理并核对了事实,但没有做长周期的实测对比——「用了它代码质量提升多少」这类问题,本文不给答案,谁给了都是编的。一切以官方文档为准。
它解决什么问题:AI 写码太快,「想清楚」跟不上
用 AI 编程工具的常见体验:一句话下去,几百行代码秒出,跑是能跑,但跟你想要的不是一回事;返工三轮,代码越改越乱。
Spec Kit 的思路是反过来:把「写清楚要做什么」变成一道强制工序,放在 AI 动手之前。它不是给代理加知识,也不是换模型,而是加流程——这也是它和市面上大量「技能包」(教代理某类知识)最根本的区别。
三条流程:独立入口,不是强制阶段
按官方 README,Spec Kit 现在有三条现成流程:
- 规格驱动开发(SDD):核心内置。从建「项目宪法」开始,走六步:constitution 定原则 → specify 写规格 → plan 定技术方案 → tasks 拆任务 → implement 实现 → converge 收敛。
- 修 bug:扩展,装了才有。三步:评估原因 → 修复 → 验证,最后给结论——verified(确认修好)、partial(部分修好)、failed(没修好),只有 verified 算修复成功。
- 想法评估:扩展,装了才有。五步走完给一个决定:go(做)、needs-clarification(先弄清楚)、kill(不做)。
README 特意强调:这三条是独立入口,不是强制阶段。最特别的是「想法评估」——在写一行代码之前,先让代理收集证据判断这个想法值不值得做;README 的意思是,带着书面理由停掉一个想法,也是有用的结果。对想拿 AI 做项目的人来说,这一步可能比写代码本身更省命。
六条命令实际怎么跑
以 SDD 为例,最小流程是:每个项目建一次 constitution,之后每个功能重复走其余五步。命令不在终端里敲,而是在你的 AI 编程代理对话里发,一次一条,每条的结果确认了再发下一条——这是 README 反复强调的使用方式。以 GitHub Copilot 的语法为例:
- /speckit-constitution:创建关注代码质量、测试和可维护性的项目原则
- /speckit-specify:描述要做什么,官方例子是「做一个相册按日期分组、有瓷片预览的图片整理工具」
- /speckit-plan:定技术方案,官方例子是「用 Vite 加原生 JavaScript,图片存本地,元数据存 SQLite」
- /speckit-tasks:拆任务
- /speckit-implement:实现
- /speckit-converge:收敛,报告 Converged 才算完;没收敛就重复 implement 和 converge
最后一步「收敛」值得单独说:它把「AI 说做完了」变成「流程报告收敛了」,至少你有一个明确的完成判据,而不是靠 AI 嘴上说说。
定制机制与一句安全提醒
Spec Kit 的定制体系比想象中厚:扩展(extension)加命令和完整流程;预设(preset)改模板、命令、术语甚至方法论;工作流(workflow)把提示词、命令、质量关卡和脚本任务自动化;打包(bundle)给某个角色或团队发成套配置;目录(catalog)机制让企业托管自己的私有组件源。组织可以用它强制执行内部或行业合规标准——微软开发者博客 10 月初也专门写过企业场景的扩展方式。
安全提醒,README 原话的意思是:社区目录里的组件「不构成审计或背书」,安装或运行之前请自行审查源码。这句话放在这里不是客气——给 AI 代理装第三方流程文件的道理,和给系统装第三方软件是一样的。
门槛与安装
门槛不高:Python 3.11 以上、uv 包管理器、一个受支持的 AI 编程代理,Linux、macOS、Windows 都行。两行命令装好并建项目:
- 第一行:uv tool install specify-cli
- 第二行:specify init my-project --integration copilot(integration 参数换成你在用的代理名字)
装完在项目目录里启动你的编程代理,在对话里发命令就行。文档站在 github.github.io/spec-kit,README 有简体中文版。已有代码的老项目也能接入,官方有专门的接入指南;企业内网隔离环境也有离线安装方案。
适合谁,不适合谁
适合:被 AI「一把梭」坑过、想要确定感的个人开发者;需要团队里所有人(和所有代理)按同一套工序干活的团队;习惯先评估再动手、想少走弯路的人。
不适合:追求「一句话出活」、不想写任何规格的人——Spec Kit 的每一步都要求你参与确认,它省的是返工,费的是前期沟通。也别把它当成质量保险:流程管住的是「有没有想清楚」,管不住「想清楚了还是做错」。
选 AI 编程工具本身的,看我们的四款横评:Claude Code、Codex、Gemini CLI、Copilot 横评;单看 Claude Code 的,有这篇深评:Claude Code 深评;免费档起步的,看免费 AI 编程助手怎么选。更多工具放在工具目录,全部文章见文章列表。