GitHub 开源了 Spec Kit:让 AI 写代码不再靠"感觉"
好的规范,是给自己最好的礼物。
01 看到一个项目,很有感触
今天发现了 GitHub 官方开源的一个项目,叫 Spec Kit。
看了一下午,心里很有感触。
这个项目想解决一个问题:
现在很多人用 AI 写代码,都是"靠感觉"。
想要什么功能,直接跟 AI 说:
- "帮我写个照片管理应用"
- "要能上传、能分类、能搜索"
然后 AI 就开始写代码。
写出来的东西,能用,但问题很多:
- 代码结构混乱
- 没有测试
- 文档缺失
- 后期难以维护
就像盖房子没有图纸,盖到哪算哪。
02 Spec Kit 的做法
Spec Kit 提出了一个很有意思的理念:
规范驱动开发(Spec-Driven Development)。
简单说,就是先写规范,再写代码。
但不是那种写完就扔的文档,而是可执行的规范。
具体流程是这样的:
第一步:写宪法(Constitution)
定义项目的核心原则 比如:代码质量标准、测试要求、用户体验规范
第二步:写规范(Specify)
描述你想做什么 关注"做什么"和"为什么",不是"怎么做"
第三步:写计划(Plan)
选择技术栈 设计架构
第四步:拆任务(Tasks)
把计划拆成可执行的任务
第五步:执行(Implement)
AI 按照规范、计划、任务,一步步实现
每一步都有据可依,不是拍脑袋决定。
03 这让我想到一件事
其实不只是写代码,很多事情都是一样的。
我们总是急着开始,却不愿意花时间想清楚:
- 想做什么公众号,却没想好定位就开始写
- 想减肥,却没想好计划就开始节食
- 想学新技能,却没想好目标就开始报课
然后做着做着,就迷茫了。
Spec Kit 给了我一个启发:
好的开始,不是马上行动,而是先想清楚。
04 规范不是束缚,是保护
很多人觉得规范很烦:
- "为什么要写文档?"
- "为什么要写测试?"
- "直接写代码不就行了吗?"
但 Spec Kit 说了一句话,我特别喜欢:
规范不是束缚,是保护。
它保护什么?
保护未来的你。
- 当你忘记为什么这样设计时,规范会告诉你
- 当你想加新功能时,规范会告诉你边界在哪
- 当团队协作时,规范会让每个人知道标准是什么
规范是写给未来的情书。
05 给开发者的几个建议
如果你也在用 AI 写代码,试试这些:
1. 先写规范,再让 AI 实现
不要直接说"帮我写个 XX 功能"。
先写清楚:
- 这个功能的目标是什么
- 用户怎么用
- 有什么边界情况
- 性能要求是什么
2. 让 AI 解释,不只是给代码
- 问"为什么这样设计"
- 问"有没有其他方案"
- 问"这个方案的优缺点是什么"
3. 建立自己的"宪法"
每个项目都应该有核心原则:
- 代码风格
- 测试覆盖率
- 文档标准
- 安全要求
4. 规范是活的,可以改
规范不是一成不变的。
发现问题,及时调整。
规范服务于你,不是你服务于规范。
06 给非开发者的启发
就算你不写代码,Spec Kit 的理念也适用:
做任何事之前,先想清楚:
- 我想做什么?(Specify)
- 为什么要做?(Constitution)
- 怎么做?(Plan)
- 第一步是什么?(Tasks)
- 开始行动(Implement)
花 30% 的时间想清楚,能节省 70% 的返工时间。
07 最后,想跟你说
写到这里,我想跟你说:
慢一点,没关系。
花时间去想清楚,不是浪费时间。
花时间写规范,不是多此一举。
花时间建立标准,不是形式主义。
这是在保护未来的自己。
当你迷茫的时候,回头看看规范。
当你犹豫的时候,回头看看初心。
当你疲惫的时候,回头看看为什么出发。
好的规范,是给自己最好的礼物。 🌸
项目链接:https://github.com/github/spec-kit
如果你也是开发者,不妨试试规范驱动开发。 如果你不是开发者,不妨试试规范驱动人生。
Comments NOTHING