把需求写成规格再开工：GitHub 官方 spec-kit 14.7 万星

「先写 prompt，再看运气」是很多人用 AI 编码 agent 的真实状态。GitHub 官方的 spec-kit 想把这件事变成工程：规格驱动开发（SDD）不再是一篇方法论博客，而是一个 147,433 星、13,230 fork 的官方工具包（MIT，Python，2025 年 8 月创建，仍在活跃更新，今日 Trending 新增 808 星）。

它的结构是三个独立入口，而不是强制流水线：建功能或应用走完整的 SDD，规格从规划、实现到收敛全程跟随；修 bug 是按需安装的扩展，先评估成因、限定修复范围、记录验证过程；评估想法同样是扩展，用证据给出 go、clarify 还是 stop 的结论。核心只有 SDD，其余按需装。

机制层面，spec-kit 做成了一套可组合的乐高：跨 agent 集成让你切换底层编码 agent；扩展机制承载命令、质量门和完整流程；preset 负责适配模板、术语、方法论，或者强制组织标准；workflow 能自动化 prompt、命令、门禁和 shell 任务，还可以用 overlay 改装而不用 fork 上游；bundle 是按角色和团队打包的精选配置；catalog 是社区组件目录，支持自建私有目录与离线、防火墙内网部署。

上手门槛不高：Python 3.11 以上加 uv，uv tool install specify-cli 之后按文档建项目即可，Linux、macOS、Windows 都支持，README 还有简体中文版。一个提醒来自官方自己：catalog 里的社区组件「不是审计或背书」，安装前先审一遍源码。

14.7 万星说明的其实是一个共识的形成：把需求写成规格再交给 agent，比直接甩一段 prompt 的返工率低得多，因为 agent 拿到的是有边界、有验收标准的任务书，而不是一句愿望。但也不必把它当银弹：规格本身写不好，agent 照样会按错误规格一本正经地跑偏，SDD 保证的是过程可追溯，不保证起点正确。规格质量，仍然是你自己的功课。