近 10 万 Star！当全世界都在 Vibe Coding，GitHub 官方说：先写规格

大家好，我是何三，独立开发者

最近有个现象挺有意思。

所有人——我是说所有人——都在聊 Vibe Coding。打开 Twitter，满屏都是"让 AI 自己写，写出来就能跑"。GitHub Copilot 装上了，Claude Code 也用上了，Prompt 一敲，代码哗啦啦往外冒。感觉程序员这个工种快被 AI 替代了。

然后 GitHub 官方出手了。

一个叫 Spec Kit 的项目，直接斩获了近 10 万 Star。它说了一句话，在 AI 编程圈炸开了锅：

先写规格，再让 AI 写代码。

不是让 AI 放飞自我，而是让 AI 按剧本演戏。

Vibe Coding 的反面，是什么？

Vibe Coding 的精髓是什么？"感觉对了，代码就对了"。写个 prompt，AI 帮你搭框架、写逻辑、甚至调试。很爽，对吧？

我试过。确实爽。

但问题是——爽完之后呢？

我上个月用 Claude Code 搭了个内部工具，20 分钟就出了第一个版本。我兴奋得差点发了朋友圈。结果第二天加功能，AI 把之前的结构全推翻了。第三天改需求，代码直接炸了。重构了三轮，越改越乱。

说白了，Vibe Coding 解决的是"从 0 到 1"，但从 1 到 100 全靠运气。

Spec Kit 的方案就简单粗暴多了：开工之前，先把"你要什么"写清楚，写成一份机器能读懂、AI 能执行的规格说明书。然后 AI 按这份说明书干活，偏差率直接归零。

打个比方你就懂了——Vibe Coding 像是去米其林餐厅跟厨师说"你看着办"，Spec-Driven Development 则是给了厨师一份完整的菜单：前菜是什么，主菜用什么火候，甜品要不要加肉桂，标得明明白白。

结果呢？后者大概率不会翻车。

说到这个，我想起一个事儿。去年有个朋友做外包，甲方需求一天变三遍，前端团队换了三拨人，最后项目延期两个月。要是当时有人先把需求写成可执行的规格，可能早交付了。

这玩意儿到底怎么用？

Spec Kit 的核心是一个叫 Specify 的 CLI 工具。装好之后，你的开发流程变成这样：

# 1. 初始化项目，选你的 AI 编码助手
specify init my-project --integration copilot

# 2. 在编辑器里敲 slash 命令，建立项目宪法
/speckit.constitution 制定代码质量、测试标准、用户体验方面的原则

# 3. 写规格（重点：只讲 What，不讲 How）
/speckit.specify 做一个相册管理应用，照片按日期分组，支持拖拽排序

# 4. 定技术方案
/speckit.plan 用 Vite + 原生 HTML/CSS/JS，数据存本地 SQLite

# 5. AI 自动拆任务
/speckit.tasks

# 6. AI 开干
/speckit.implement

看到区别了吗？Vibe Coding 是你说"做个相册应用"，AI 直接开干。Spec Kit 让你先告诉 AI"做什么"，再告诉它"用什么做"，然后它再动手。

第一次用的时候，说实话我也觉得多此一举。但试完一个完整项目后，真香。

为什么呢？因为返工率几乎为零。

以前跟 AI 编程，最大的痛苦是——AI 永远猜不对你的想法。你说"做个列表"，它给你用 React Table 套了五层。你说"简单点"，它删了三行又加了十行。来来回回，prompt 写了两千字，代码没跑通。

Spec Kit 的做法是：让 AI 先理解你的需求，锁定需求再动手。 规格说明书一旦定稿，AI 的所有输出都对齐这份规格——不跑偏、不自由发挥、不擅自加戏。

生态有多强？

说实话，我最开始以为这就是 GitHub 内部的一个小工具。

结果一看社区生态，我被震住了。

30 多种 AI 编码助手的集成——Claude Code、GitHub Copilot、Gemini CLI、Cursor、Codex CLI……你能叫得上名字的，基本都有。

还有 50 多个社区贡献的扩展，分成了几大类：

举个具体的：Jira Integration 这个扩展，能从你的规格说明自动生成 Jira 故事和子任务，状态同步。Checkpoint Extension 会在实现过程中自动分批次提交，避免一个 feature 一个超大 commit。

这生态，完全不像一个刚发布 9 个月的项目。

谁适合用？

说实话，不是所有人都需要。

如果你是 solo 开发者，自己写个小工具玩玩，Vibe Coding 完全够。甚至更爽——prompt 一敲，一个下午搞定。

但如果你在以下场景，Spec Kit 能救命：

• 团队协作：多人用 AI 写同一个项目，有人写前端、有人写后端，没有统一的规格，两行代码就能冲突
• 企业项目：有合规要求、架构规范、代码审查，AI 不能自由发挥
• 长周期项目：今天写的代码，三个月后回来改，没有规格文档等于考古
• 甲方/客户项目：需求变更频繁，需要"书面证据"确认需求

为什么这么设计？别问我，问 GitHub 去——他们内部肯定吃过 Vibe Coding 的亏。

项目地址

GitHub： https://github.com/github/spec-kit

官网文档：https://github.github.io/spec-kit/

安装就一行命令，有 Python 和 uv 就行：

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

Vibe Coding 很好，但它不是终点。GitHub 这个项目，说到底就一句话：

让 AI 自由发挥之前，先给它一份剧本。

本文使用 MGO 编辑并发布

关注"何三笔记"，回复"mgo" 免费下载使用