【WB】GitHub Spec Kit：用「规范驱动」终结 vibe coding 的混乱

一、为什么需要它

这两年 AI 写代码越来越顺手，但一个坑越来越明显：你直接让 AI「写个 XX 功能」，它确实能写，可「要建什么、为什么这么建」全装在它临时编的上下文里。一旦需求变、人换了、要维护，代码本身成了唯一事实来源——没人说得清当初为什么这么设计。

微软的 Den Delimarsky 举过一个例子：做通知系统，PM 以为「偏好」是分渠道开关，后端做成单个总开关，前端以为接的是系统通知，设计师画的稿要重构半个用户服务。这不是谁沟通差，是缺了「共享上下文」。Spec-Driven Development（SDD，规范驱动开发）就是来解决这个的：把「为什么」写进能随项目一起演进的文档里，像给思考做版本控制。

二、它到底是什么

Spec Kit 是 GitHub 官方开源的一个工具包，目标是把 SDD 方法论变成 AI 编程里开箱即用的流程。它不替代你的 AI 编码 Agent（Copilot、Claude、Codex 等），而是在 Agent 前面加一层「规范层」：你先描述要建什么，经过结构化阶段逐步细化，最后才交给 Agent 实现。

核心理念一句话：规格（spec）变成可执行的产物，直接生成实现，而不是写完代码就扔掉的脚手架。和传统「先写需求文档、再写代码」不同，SDD 的每个阶段产出的是 Markdown 文件，会喂给下一阶段、也喂给 Agent 当上下文——是活的，不是一次性的。

三、核心流程与能力

核心流程就四步，每一步产出一份 Markdown，喂给下一步：

除了基础流程，几个能力值得记住：

四、动手跑通（玩一玩）

下面这条路线整理自官方 README / 文档（2026-07-25 核实）。说明：我这台环境访问 GitHub 直连超时，以下步骤未在我机器实跑，按官方文档还原，你本地试时以官方实时文档为准。

# 1. 前置：装 uv（包管理器，境外源，必要时走代理）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. 安装 Specify CLI（把 vX.Y.Z 换成 Releases 里的最新 tag）
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z

# 3. 初始化项目，并选你用的 AI Agent
specify init my-project --integration copilot
cd my-project

# 4. 在 Agent 里用 /speckit.* 斜杠命令推进各阶段
/speckit.spec     # 写需求规格
/speckit.plan     # 出技术规划
/speckit.tasks    # 拆成可执行任务
# 然后让 Agent 按产物实现；Codex CLI 用 $speckit-* 形式

五、适合谁 & 怎么挑

一句话：想让 AI 产出「可控、可预测、好维护」的代码，就值得上加这一层规范。

适合：个人想把 AI 产出变靠谱、团队要给 Agent 统一上下文、企业内网要可控可审计。不太适合：写完就扔的一次性小脚本——那层规范反而是负担。

六、小结与提醒

Spec Kit 是 GitHub 官方把「先想清楚再写」做成工具的典型尝试：不替你写代码，而是替你把「要建什么」讲清楚，再交给任意 Agent 实现。对受够 vibe coding 混乱的人，值得一试。