规格驱动开发是什么?GitHub Spec Kit 入门(2026)
让 AI 写代码时,你是不是常常「对着聊天框反复描述需求,改一版错一版,最后自己都不知道它到底实现了什么」?规格驱动开发(Spec-Driven Development,简称 SDD)就是为治这个病而来的方法:先把「要做什么」写成一份清晰的规格(spec),让规格成为唯一真相源,再由 AI 按规格生成计划、拆任务、写代码。2026 年它随着 GitHub 官方开源工具 Spec Kit 迅速走红。这篇文章讲清 SDD 是什么、和 vibe coding 的区别,并带你用 Spec Kit 完整跑一遍流程。
规格驱动开发(SDD)是什么
规格驱动开发的核心只有一句话:规格不是代码的附庸,代码才是规格的产物。传统开发里,PRD(产品需求文档)写完就丢一边,真相在代码里;而 SDD 反转了这个关系——你先和 AI 一起把需求、边界、验收标准写成结构化的规格文件,这份规格才是权威,代码只是根据它「构建」出来的产物。需求变了,就改规格、重新生成,而不是直接去手改一堆代码。这样一来,AI 有了明确、可审查的靶子,产出的可控性和可信度都大幅提升。
一句话理解 SDD
规格驱动开发 = 把「你到底要什么」先写清楚成规格文档,让 AI 照着规格造代码,而不是靠一次次口头描述碰运气。规格是源头,代码是产物。
为什么需要它:vibe coding 的反面
去年火起来的 vibe coding(氛围编程)主张「凭感觉对 AI 下指令、快速出东西」,做原型、玩 demo 很爽,但一旦项目变大就容易失控:AI 不知道全局约束、需求散落在聊天记录里、没人能审查它到底做了什么。规格驱动开发正是 vibe coding 的「工程化反面」——两者并不对立,而是适用于不同阶段。下面这张表帮你看清区别:
| 维度 | vibe coding(氛围编程) | 规格驱动开发(SDD) |
|---|---|---|
| 真相源 | 散在聊天记录和代码里 | 一份结构化的规格文档 |
| 适合场景 | 原型、demo、一次性脚本 | 复杂功能、多人协作、要交付 |
| 可审查性 | 弱,改了什么全靠翻记录 | 强,规格可评审、可版本化 |
| 需求变更 | 再对 AI 描述一遍 | 改规格、重新生成计划与代码 |
| 对新手 | 上手快但容易失控 | 有章法,逼你先想清楚再动手 |
GitHub Spec Kit:官方开源工具包
Spec Kit 是 GitHub 官方开源、MIT 许可的规格驱动开发工具包,2026 年成为落地 SDD 最主流的选择。它最大的优点是「agent 中立」——不绑定某一个 AI 工具,而是支持 Claude Code、GitHub Copilot、Gemini CLI、Cursor、Codex CLI、Qwen Code 等近 30 种 AI 编程工具。你现在用什么工具,基本都能直接套上这套流程。
Spec Kit 帮你做了什么
它在你的项目里生成一套标准的规格模板、目录结构和斜杠命令,把「宪法 → 规格 → 计划 → 任务 → 实现」这条流水线固化下来,让任意支持的 AI agent 都能按同一套章法干活。工具免费,你付的只是背后 AI 模型的费用。
安装与初始化
Spec Kit 用 Python 分发,需要 Python 3.11+、Git,以及包管理器 uv 和一个你已装好的 AI 编程工具。最省事的方式是用 uvx 一条命令拉起并初始化项目,运行时它会让你从支持的 agent 里选一个:
# 用 uvx 直接初始化一个新项目(会提示你选择 AI 工具)
uvx --from git+https://github.com/github/spec-kit.git specify init my-project
cd my-project
# 也可以直接指定要用的 agent(示例,参数名以官方为准)
# specify init my-project --integration claude
# 或先把 specify 命令装成常驻工具(@版本号 换成最新 release)
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z核心工作流:从一句话到可信代码
初始化后,你就在选定的 AI 工具(如 Claude Code)里用一组斜杠命令按顺序推进。新版命令带 speckit. 前缀,每一步都会在项目的 specs/ 目录下产出对应的 Markdown 文件,可以直接 review、提交进 Git。
| 命令 | 阶段 | 作用 |
|---|---|---|
| /speckit.constitution | 立宪法 | 定义项目的基本原则与约束(技术偏好、代码规范等) |
| /speckit.specify | 写规格 | 描述「做什么、为什么」,生成需求与用户故事 |
| /speckit.clarify | 澄清 | 逐条追问,消除规格里的模糊点,做计划前先补齐 |
| /speckit.plan | 定方案 | 选好技术栈,生成技术实现方案 plan |
| /speckit.tasks | 拆任务 | 把方案拆成一份可执行的任务清单 |
| /speckit.implement | 写代码 | 按任务清单逐项实现,落成真正的代码 |
命令前缀与版本会变
新版 Spec Kit 的命令加了 speckit. 命名空间(如 /speckit.specify),而早期版本是不带前缀的 /specify、/plan 等。此外初始化时指定 agent 的参数在不同版本出现过 --integration 与 --ai 两种写法。Spec Kit 更新很快,实际以你安装版本的官方文档、以及 init 后生成的命令为准;不确定就直接跑 specify init 用交互菜单选。
SDD 适合谁、不适合谁
- 适合:需求相对明确、要真正交付的功能;多人协作、需要评审和留痕的项目;逻辑复杂、想让 AI 少跑偏的场景。
- 适合:想借规格倒逼自己「先想清楚再动手」的新手,能少踩很多返工的坑。
- 不太适合:随手试想法的原型、一次性脚本、纯探索性的 demo——这些用 vibe coding 更快。
- 折中用法:先 vibe coding 快速验证方向,方向对了再用 SDD 把它「工程化」成能维护的正式实现。
配合你已经在用的工具
Spec Kit 不是要你换工具,而是给你手上的工具加一套方法论。如果你已经在用 Claude Code、Gemini CLI、Cursor 或 Qwen Code,直接在初始化时选它即可,规格文件和斜杠命令会自动装好。想先把这些底层工具用顺,站内有 Claude Code 接国产模型、Gemini CLI 国内使用、Qwen Code、以及 vibe coding、MCP 等概念的入门教程,配合 SDD 一起看效果最好。
规格驱动开发代表了 AI 编程从「凭感觉」走向「有章法」的方向:把需求想清楚、写成规格,让 AI 在明确的靶子上高质量地干活。但方法和工具只是骨架,真正决定成败的,是你能不能把复杂需求拆解到位、把 AI 的产出审查明白、把它稳定用进能交付的真实项目。想系统掌握这套用 AI 做产品的能力,欢迎来 IMAI 看看我们的体系化实战课程。
想系统学会用 AI 编程,从入门到做出真实产品?
查看系统课程