liyupi
528f9e17a9
- 修改《AI 编程扩展大全》标题、开头和结尾，使其符合教程特性 - 在《AI 辅助工具集》中补充 MCP 服务推荐和规范化开发工具介绍 - 在《AI IDE 插件》中新增 Claude Code 扩展和 IDE 扩展插件详细说明 - 新增《Spec-kit：规范驱动开发框架》工具实战文章 - 新增《OpenSpec：轻量规范开发框架》工具实战文章 - 新增《Agent Skills：通用 AI 技能库》工具实战文章 - 新增《Superpowers：核心技能库》工具实战文章 - 优化《AI 编程工具大全》目录结构，细化辅助工具集和工具实战板块说明
238 lines
9.0 KiB
Markdown
238 lines
9.0 KiB
Markdown
# Spec-kit：规范驱动开发框架
|
||
|
||
> 让 AI 按照专业流程开发项目
|
||
|
||
你好，我是程序员鱼皮。
|
||
|
||
在前面的文章中，我们学习了如何用 AI 快速生成代码。但你可能会发现，AI 有时候会 “想到哪写到哪”，生成的代码可能不符合预期，或者项目做到一半就乱套了。
|
||
|
||
有没有办法让 AI 按照专业的流程来开发项目呢？
|
||
|
||
这篇文章，我会介绍 **Spec-kit**，一个由 GitHub 推出的规范驱动开发框架，让 AI 像专业程序员一样工作。
|
||
|
||
让我们开始吧！
|
||
|
||
|
||
|
||
## 一、什么是 Spec-kit？
|
||
|
||
[Spec-kit](https://github.com/github/spec-kit) 是 GitHub 推出的规范驱动开发（SDD）框架。
|
||
|
||
什么是规范驱动开发呢？
|
||
|
||
传统开发流程是：想到什么写什么，边写边改，最后再补文档。这样容易导致需求不清晰、代码和文档对不上。
|
||
|
||
而规范驱动开发的思路正好相反：**先把需求写成规范文档，并且把规范文档当作代码的唯一真相来源**。你可以把规范文档理解为 "法律条文"，它包含了详细的需求描述、系统设计和接口定义。AI 必须严格遵守这些条文来生成代码，确保产出完全符合预期。
|
||
|
||
|
||
|
||
|
||
|
||
## 二、快速上手 Spec-kit
|
||
|
||
让我通过一个实际例子，带你快速上手 Spec-kit。
|
||
|
||
### 1、安装 Spec-kit
|
||
|
||
首先打开终端，利用 uvx 命令直接安装运行 Specify 工具，并初始化一个项目：
|
||
|
||
```bash
|
||
uvx --from git+https://github.com/github/spec-kit.git specify init my-project
|
||
```
|
||
|
||
|
||
|
||
选择你使用的 AI 编程工具，Spec-kit 支持 Claude Code、GitHub Copilot 等几乎所有主流编程工具。这里我选 Claude Code：
|
||
|
||
|
||
|
||
根据操作系统选择脚本类型，Windows 选下面的，其他选上面的：
|
||
|
||
|
||
|
||
执行完这个命令后，会在当前目录下创建一个 `my-project` 文件夹：
|
||
|
||
|
||
|
||
文件夹里面包含了这些核心文件：
|
||
|
||
- `.specify/memory/constitution.md`：项目的基本准则和约定
|
||
- `.specify/scripts/`：一些可执行脚本
|
||
- `.specify/templates/`：模板文件
|
||
- `.claude/commands/`：定义了一套内置的斜杠命令，让你在 AI 编程工具中可以直接调用
|
||
|
||
|
||
|
||
初始化程序还给了我们一些指引，告诉我们接下来如何运用这些命令来开发项目。
|
||
|
||
|
||
|
||
用 Claude Code 打开这个项目文件夹，就可以在对话中使用定义好的命令了。
|
||
|
||
|
||
|
||
|
||
|
||
### 2、标准化开发流程
|
||
|
||
接下来就是标准化的开发流程，参考 [官方文档](https://github.com/github/spec-kit)，主要分为 7 个步骤：
|
||
|
||
#### 1）Constitution 制定项目准则
|
||
|
||
运行 `/speckit.constitution` 命令，定义项目的基本原则、代码规范、性能标准等。这是项目的 "宪法"，后续所有开发都要遵守。
|
||
|
||
比如：
|
||
|
||
```markdown
|
||
/speckit.constitution 禁止使用蓝紫渐变色风格的 UI
|
||
```
|
||
|
||
💡 如果你要做中文项目，最好在制定项目准则时就明确告诉 AI “整个网站使用中文”。
|
||
|
||
|
||
|
||
AI 更新了项目准则文档：
|
||
|
||
|
||
|
||
建议每一步我们都用 Git 提交一个版本，这样出了问题后能及时回滚，也便于我们看到每一步改动的文件。
|
||
|
||
|
||
|
||
|
||
|
||
#### 2）Specify 编写功能规范
|
||
|
||
运行 `/speckit.specify` 命令，描述要做什么功能、为什么做、用户需求是什么。比如：
|
||
|
||
```markdown
|
||
/speckit.specify 我想做个【自动提醒我喝水的网站】
|
||
```
|
||
|
||
|
||
|
||
AI 为这次的需求创建了一个新的 Git 分支，防止污染现有项目。在这个分支下创建了一个需求规格文档（spec.md） + 一个需求检查文档（requirements.md）。
|
||
|
||
|
||
|
||
需求规格文档非常详细，还包含了边缘测试用例，针对用户各种可能的操作进行处理。
|
||
|
||
|
||
|
||
需求检查文档中记录了 AI 对于需求的理解，打钩表示 AI 理解并确认了：
|
||
|
||
|
||
|
||
|
||
|
||
#### 3）Clarify 澄清不明确的地方（可选）
|
||
|
||
如果你发现需求检查文档中有的条目没有打钩，那你需要通过 Clarify 命令来让 AI 引导你进一步明确需求，直到所有的条目都打上勾。
|
||
|
||
运行 `/speckit.clarify` 命令，AI 会提出结构化的问题，让你来回答。从而帮你填补需求中的空白，比如边界情况、错误处理等。
|
||
|
||
|
||
|
||
|
||
|
||
#### 4）Plan 制定技术方案
|
||
|
||
运行 `/speckit.plan` 命令，让 AI 决定用什么技术栈、系统架构、数据模型、API 接口等。
|
||
|
||
|
||
|
||
制定技术方案完成，这次生成了一大堆文档，简单了解一下：
|
||
|
||
- CLAUDE.md 项目开发指南，记录技术栈和项目结构，用于指导 Claude Code 接下来如何开发
|
||
- quickstart.md 快速入门指南，包含 6 个实施阶段和部署方案
|
||
- plan.md 实施方案，定义了纯客户端架构、存储策略、宪法合规性检查等
|
||
- data-model.md 数据模型设计，定义了 4 个核心实体（提醒设置、水量日志、每日进度、历史记录）和存储结构
|
||
- research.md 技术研究文档，记录了 8 项关键技术决策
|
||
- contracts/api-contract.md API 接口文档
|
||
|
||
|
||
|
||
接下来，我们就可以准备开发实现了。
|
||
|
||
|
||
|
||
|
||
|
||
#### 5）Tasks 拆解任务
|
||
|
||
运行 `/speckit.tasks` 命令，把计划拆解成可执行的任务列表，并标注依赖关系和优先级。
|
||
|
||
|
||
|
||
生成了一个任务列表文档，每一步要做什么都非常清晰：
|
||
|
||
|
||
|
||
|
||
|
||
#### 6）Analyze 分析检查（可选）
|
||
|
||
运行 `/speckit.analyze` 命令，检查规范、计划、任务是否完整一致，提前发现设计缺陷。
|
||
|
||
|
||
|
||
可以看到，AI 没有检查出问题，还让我自信地进行下一步，真爽死了！
|
||
|
||
|
||
|
||
#### 7）Implement 执行实现
|
||
|
||
最后，运行 `/speckit.implement` 命令，让 AI 按照任务列表生成代码。
|
||
|
||
|
||
|
||
大功告成，看一下效果~
|
||
|
||
|
||
|
||
因为我这里始终没有提到使用中文输出，所以网站内容都是英文的，不过我感觉效果还可以。
|
||
|
||
|
||
|
||
## 三、Spec-kit 的优缺点
|
||
|
||
到这里，我们已经学会了如何用 Spec-kit 开发完整项目，再复习一下完整流程：
|
||
|
||
|
||
|
||
即使不用 Spec-kit，我们开发完整项目时也可以人工遵循这些步骤。
|
||
|
||
这种模式最大的好处是 **对齐**。所有人都基于同一份清晰的规范文档工作，大家对需求的理解高度一致，既减少了沟通中的误解，又能确保代码质量。
|
||
|
||
不过缺点也很明显，对于小项目，本来直接写代码几分钟就能搞定了，上面这套流程走下来差不多要半个小时！
|
||
|
||
所以这套流程比较适合团队从 0 开始做完整的新项目，虽然流程比直接写代码慢一些，但能大大降低返工的风险，长远来看反而更高效。
|
||
|
||
|
||
|
||
## 写在最后
|
||
|
||
看到这里，相信你已经对 Spec-kit 有了基本的了解。
|
||
|
||
**Spec-kit 不是万能的，但在合适的场景下，它能帮你大幅提升项目质量。**
|
||
|
||
如果你正在做大型项目、需要团队协作、对代码质量要求高，那么可以试试 Spec-kit。但如果你只是想写个简单的脚本或者快速验证一个想法，直接让 AI 生成代码会更快。
|
||
|
||
选择合适的工具，才能事半功倍。
|
||
|
||
在接下来的文章中，我会继续介绍其他规范化开发工具，帮你找到最适合自己的开发方式。
|
||
|
||
|
||
|
||
## 推荐资源
|
||
|
||
1）鱼皮 AI 导航网站：[AI 资源大全、最新 AI 资讯、免费 AI 教程](https://ai.codefather.cn)
|
||
|
||
2）编程导航学习圈：[学习路线、编程教程、实战项目、求职宝典、交流答疑](https://www.codefather.cn)
|
||
|
||
3）程序员面试八股文：[实习/校招/社招高频考点、企业真题解析](https://www.mianshiya.com)
|
||
|
||
4）程序员写简历神器：[专业模板、丰富例句、直通面试](https://www.laoyujianli.com)
|
||
|
||
5）1 对 1 模拟面试：[实习/校招/社招面试拿 Offer 必备](https://ai.mianshiya.com)
|