Spec Kit 是 GitHub 开源的规格驱动开发工具包,帮助团队用 AI 编程工具(Copilot、Claude Code、Cursor)实现结构化开发流程。通过指定→计划→任务→实现的四阶段工作流,提升代码质量和项目可控性。MIT 许可证,免费开源,文末附详细使用教程
🎤 引言
你有没有遇到过这种情况:跟 AI 编程助手描述完需求,它噼里啪啦写了几百行代码,编译通过,测试却 fail——代码看起来没问题,但和产品经理想的完全不是一回事?
比如你跟 AI 说"做个用户登录功能",结果 AI 给你写了个只用用户名不要密码的登录逻辑。这种事情在 AI 编程时代太常见了。
这问题不在 AI 编程能力,而在于我们的开发方式太随意了。没有清晰的规格定义,AI 只能靠猜。
GitHub 近期开源的 Spec Kit 就是来解决这个问题的——它是专门为 AI 编程工具打造的新开发方式,让开发流程变得结构化、可追溯。
⭐ 核心功能
Spec Kit 包含两个核心组件:Specify CLI 命令行工具 + 模板脚本。它们配合实现了规格驱动开发(Spec-Driven Development,SDD)。
1. 规格化阶段(Specify)
你提供高层需求描述(做什么、为什么),AI 编码助手会生成详细的规格文档。这个阶段要求明确:项目技术栈、架构设计、约束条件全部白纸黑字写清楚。
2. 技术规划阶段(Plan)
拿到规格文档后,AI 编码助手制定完整的技术实现方案。这一阶段会拆解出具体的模块结构、数据流设计、API 规范,确保技术方案和业务需求对齐。
3. 任务拆解阶段(Tasks)
将技术方案分解成一个个小任务(task),每个任务有明确的输入输出和验收标准。Spec Kit 预设了 /specify、/plan、/tasks 三个命令,对应三个核心阶段。
4. 代码实现阶段(Implement)
AI 编码助手按照任务清单逐个实现,每完成一个任务都可以对照规格文档检查是否跑偏。你只需要充当"验收者",而不是"代码打字员"。
扩展系统
Spec Kit 还支持插件扩展机制,可以从本地或全局目录发现加载扩展。YAML 配置定义了扩展的元数据和能力,支持自定义斜杠命令、钩子(hook)等高级玩法。
📥 安装使用
环境要求
- Python 3.11+
uv包管理器(推荐方式)
安装步骤
# 方式一:uv 安装(推荐)
uv tool install specify-cli --from git+https://github.com/github/spec-kit
# 方式二:直接运行
uvx --from git+https://github.com/github/spec-kit specify init <项目名>初始化项目
# 在新项目目录中运行
specify init my-project
cd my-project初始化后,AI 编码助手会自动获得一组斜杠命令:/specify(生成规格)、/plan(制定计划)、/tasks(拆分任务)。这些命令和 VS Code 中的 GitHub Copilot 深度集成,直接在 Copilot Chat 面板中使用。
支持的 AI 编码助手
| 工具 | 平台 | 集成方式 |
|---|---|---|
| GitHub Copilot | VS Code / VS 2026 | 内置 /specify、/plan、/tasks 命令 |
| Claude Code | 终端 | 模板脚本 + 自定义 prompt |
| Gemini CLI | 终端 | 模板脚本 + 自定义 prompt |
| Cursor | IDE | 模板脚本 + 规则配置 |
💡 实测 Copilot + Spec Kit 组合体验最佳,VS 2026 已内置云端 agent 支持异步执行任务。
🎯 适用场景
新项目开发(Greenfield)
从零开始搭建系统,Spec Kit 的价值在于强迫你先想清楚"做什么",再动手写代码。规格文档先行,开发过程不迷路。
增量功能迭代(Brownfield)
已有代码库要加新功能?Spec Kit 让你在现有上下文基础上增量开发,不需要推翻重来。适合维护老项目的团队。
遗留系统现代化(Legacy Modernization)
很多遗留系统的原始设计意图早已丢失。接手的人只能对着几百个 PHP 文件干瞪眼。Spec Kit 可以帮你:先把业务逻辑用现代规格语言描述清楚,再让 AI 重新设计架构、逐个模块替换。
实际案例:某团队用 Spec Kit 重构一个 10 年历史的报表系统,先花 2 天写规格文档,再用 AI 生成新代码,比纯人工重写快了 3 倍,且业务逻辑零丢失。
🔍 对比同类工具
| 工具 | 定位 | 特点 |
|---|---|---|
| Spec Kit | 规格驱动开发框架 | 强调规格先行、结构化流程、跨 AI 工具 |
| Cursor | AI 代码编辑器 | 注重编辑体验,规格靠人工定义 |
| Copilot Workspace | AI 开发环境 | 端到端覆盖,但闭源生态绑定 |
| Claude Code | 终端 AI 编程 | 灵活但无强制规范,需要人工管控 |
Spec Kit 的差异化在于它的流程约束——不是给你一个更聪明的 AI,而是强迫你用更规范的方式和 AI 协作。
⚠️ 注意事项
- 不要跳过规格阶段。Spec Kit 的核心价值就是"规格先行",如果你直接让 AI 写代码,那就退回普通 prompt coding 了。
- PyPI 上的
specify-cli是假的。GitHub 官方只通过 GitHub 仓库发布包,PyPI 上同名包非官方维护,版本也可能落后。 - AI 生成的内容需要人工验收。Spec Kit 是协作框架,不是全自动流水线。AI 负责执行,你负责把关质量。
- 规格文档需要维护。需求变了,规格也要跟着改。不要让规格文档变成摆设。
✅ 总结
Spec Kit 解决的不是 AI 编程能力问题,而是开发流程规范问题。
用 AI 写代码现在很容易,但用 AI 写出符合预期、方便维护的代码很难。Spec Kit 的思路很直接:先写清楚要做什么(规格),再制定怎么做(计划),然后拆成小任务让 AI 逐个实现(任务驱动)。
对于已经在用 AI 编程助手的团队,这套框架值得一试。它本质上是一套人机协作的规范协议,让 AI 的输出更可预测、也让人类更容易把控方向。
推荐指数:⭐⭐⭐⭐(扣一星因为插件生态还年轻)