很多人抱怨 AI 编程不好用，让 Claude Code 写出来的东西总觉得差点意思。问题往往不在 AI，在需求表达太模糊。
GitHub 开源的 Spec-Kit（Spec-Driven Development Toolkit）解决的就是这个问题。它的核心理念简单到几乎有点无聊：先写规格，再写代码。
但就是这个”无聊”的理念，正在改变很多人和 AI 协作的方式。
它不教你写代码，它教你”说人话”
Spec-Kit 不是又一个 AI 编程助手。它是一套让你学会跟 AI 沟通的工具链。
整个流程就四步：
- Specify：定义你要做什么
- Plan：规划怎么做
- Tasks：拆分成小任务
- Implement：执行实现
听起来像极了产品经理的日常工作。但区别在于，Spec-Kit 把这些步骤结构化成了 AI 能理解的格式。
四个场景，看看它怎么用
新项目启动：以前直接跟 AI 说”帮我搭个 React 项目”，AI 可能给你塞一堆你根本不需要的配置。现在先跑 uvx --from git+https://github.com/github/spec-kit.git specify init my-project，它会引导你填写项目要解决的问题、技术栈选型、核心功能模块。生成的 spec.md 就是后续所有 AI 编程的统一依据。
复杂功能开发：比如做”用户权限系统”。先创建规格文件，定义权限模型（RBAC/ABAC）、列出需控制的资源和操作、说明边界条件。规格文档写完，问题基本就想透了。再让 AI 写代码，通常一次就能用。
多人协作：团队里有人用 Claude Code，有人用 Cursor，有人用 Copilot。代码风格乱七八糟。Spec-Kit 的解决方案是让 spec.md 成为唯一的真实来源（single source of truth）。不管谁写代码，都先读同一个规格文件，AI 工具产出在架构层面自然一致。
重构老项目：接手别人的老代码，用 specify analyze 命令分析代码结构、生成规格文档、识别重构模块。先把核心业务逻辑抓出来写成规格，再让 AI 从零重写，不带历史包袱。
四条实战建议
- 规格文档别写太细：说清楚”要什么”，别管”怎么做”。写太细反而限制 AI 发挥。“用户登录成功后跳转到首页”就够了，不需要写到”调用 API 后判断 status===200…”
- 用 AI 帮你写规格：先跟 AI 聊需求，让它帮你整理成结构化文档。聊天过程本身就是一次需求澄清。
- 规格文档是活的：先写粗糙版 → AI 生成代码 → 发现问题更新规格 → 继续迭代。不是签完就扔的合同。
- 配合 CLAUDE.md 使用：
spec.md定义”做什么”，CLAUDE.md定义”怎么做”，两者结合，AI 写出的代码就像你自己写的。
什么时候不需要它？
简单脚本、快速原型、改几行代码——直接跟 AI 说就行，不需要跑一遍 Spec-Kit。
Spec-Kit 的定位很清晰：AI 只是执行者，你才是架构师。它让你把架构师这个角色扮演好，把模糊的想法变成可执行的结构化文档，然后交给 AI 去实现。