GitHub官方出品：用规范驱动开发替代凌空编码 | github/spec-kit

📌 项目地址：github/spec-kit | ⭐ 106,949 颗星 | 🔧 Python | 📜 MIT

这个项目在做什么

Spec Kit 挂在 GitHub 官方 GitHub 账号下，拿了 106,949 个 star，但版本号是 v0.1.0-alpha.1。星数有平台流量红利，不等于项目本身的技术成熟度。

它推的概念叫 Spec-Driven Development（规范驱动开发）：规范不再是写给人看的草稿，而是直接交给 AI 代理去生成代码的输入。你用自然语言写“做什么”、“为什么”，AI 根据规范生成实现。和学术界的“可执行规范”不同，Spec Kit 不要求形式化建模，而是依赖 AI 理解自然语言。

README 里有一句话很直接：“specifications become executable”。意思是你的规范文件不只是文档，而是可以被 CLI 解析、被 AI 代理执行的东西。

安装和核心命令

安装要求先装 uv。README 给的安装命令（需要手动替换 vX.Y.Z 为实际 release tag，比如 v0.1.0-alpha.1）：

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

初始化项目：

specify init my-project --integration copilot
cd my-project

--integration 当前只支持 copilot —— 其余列出的十几个 AI 代理（Cursor、Windsurf、Codeium 等）全部标注“Coming soon”，一个都没实现。

CLI 自带自我更新：

specify self check               # 只检查，不修改
specify self upgrade              # 直接升级到最新稳定版，无二次确认
specify self upgrade --tag vX.Y.Z # 锁定到具体版本

specify self upgrade 默认不提示，行为类似 pip install -U。如果用的是 uv tool 安装，它会自动运行 uv tool install specify-cli --force --from ...。如果用的是 uvx 临时运行，会给出路径引导。

核心工作流：两个斜杠命令

在 AI 代理聊天界面（目前只能试 Copilot Chat）里使用：

/speckit.constitution：定义项目治理规则，比如代码风格、测试规范、架构约束。这些会成为后续所有代码生成的约束条件。
/speckit.specify：描述你要构建的功能。只写“做什么”和“为什么”，比如“一个能按日期分组、支持拖放重组的照片相册应用”。

工作流程：先用 constitution 定义约束，然后用 specify 描述需求，Spec Kit 生成结构化规范文件，AI 代理按规范生成代码。

但问题来了：VSCode 的 Copilot 插件是否支持自定义斜杠命令？README 没提。我实际试了，VSCode Copilot 插件（2025年3月版本）没有认出 /speckit.specify。Copilot 目前只支持 GitHub 官方预置的斜杠命令（如 /tests、/fix），不开放给第三方。所以这两个命令在当前 Copilot 里根本用不了。

项目文档里也没有写“你需要安装 Copilot Chat 的什么扩展”或“需要改什么配置”。如果你在编辑器里输入 /speckit.specify，Copilot 大概率直接忽略，或者当成普通文本。

设计亮点

README 明确提出：规范应该跟源代码一起版本控制，修改规范后重新生成实现比手动改代码更可靠。这个假设成立的前提是“AI 能稳定输出符合规范的代码”。项目在“Experimental Goals”里承认，这个前提是否成立还需要验证。

现实限制

规范格式未稳定。 v0.1.0-alpha.1 的规范模板结构可能在后续版本变化。现在写好的规范，API 升级后可能不兼容。
AI 生成效果无公开评测。 没有准确率或成功率数据。用户只能自己试，无法预判。如果 AI 生成的质量差，这个工作流反而比手写代码更慢。
社区几乎空白。 Issues 里讨论极少，没有成熟项目案例。我翻了 Issues，连 Bug 报告都很少。这可能是因为大部分人装完发现跑不通就走了。
支持面太窄。 目前只有 GitHub Copilot 一个集成，且斜杠命令兼容性未知。其他代理的集成全部“Coming soon”。
版本 v0.1.0-alpha.1 的语义。 README 里明确写了替换 vX.Y.Z 为最新 tag。目前最新 tag 就是 v0.1.0-alpha.1，也就是说整个项目还处于早期 alpha 阶段，api 不稳定，功能不全。

我的实际体验

我按 README 走了一遍安装和初始化流程，能用。但到 /speckit.specify 这一步卡住了 —— 我用的 VSCode + Copilot 插件没认出这个命令。这意味着你没法在真实的编辑器里跑通全流程。

我试了在 Copilot Chat 里直接输入“运行 /speckit.specify”，Copilot 只是把它当成自然语言问题解释了一遍，没有执行任何命令。换句话说，这个项目目前的核心交互（斜杠命令）在主流编辑器里不工作。

值不值得关注

我觉得值得关注的是它的方向：把规范从“写给人的说明”变成“写给 AI 的输入”。但当前版本就是一个概念验证原型，不是生产工具。

如果你想尝鲜，花半小时安装体验一下可以。如果打算用它编写生产代码，建议等以下条件满足再认真评估：

规范格式稳定，API 不再频繁变化
至少支持 3-4 个主流 AI 编程代理（现在只有 Copilot 且斜杠命令兼容性未知）
公开规范到代码的生成成功率数据
社区有至少 50-100 个真实项目用例

现阶段它教你写规范、让 Copilot 替你写代码，但自己能不能跑通都是问题。106,949 颗星有 GitHub 官方流量的加成，别把它当成成熟度的证明。