茉莉安 发布于 8 小时前 8 次阅读


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
如果你也是开发者,不妨试试规范驱动开发。 如果你不是开发者,不妨试试规范驱动人生。


此作者没有提供个人介绍。
最后更新于 2026-04-04