跳到主要内容

OpenSpec:误用与退出条件

框架最大的风险,不是它本身太差,而是团队把它用成“看起来很完整”的仪式,却没有把真实交付、验证和 review 绑进去。能不能及时退出错误用法,比一开始会不会写模板更重要。

常见误用

  • 任何小 typo 都走 proposal,流程负担立刻超过收益。
  • archive 永远不清理,导致没人再愿意看历史。
  • proposal 写了很多,但实现和验证仍然全靠临场发挥。

维护成本

  • proposal 模板与 archive 目录需要持续修剪。
  • 需要有人判断哪些变化值得进入 OpenSpec,哪些不值得。
  • 如果没有与 PR 和验证命令联动,就会变成孤立文档堆。

退出条件

  • proposal 数量越来越多,但 merge 时没人再回看。
  • 团队开始用 OpenSpec 包装大项目,最后流程既轻不下去也重不起来。
  • archive 没有检索价值,成员只好回到聊天记录找上下文。

维护与退出矩阵

判断面继续保留框架的条件该停下来做减法的信号
执行方式proposal 模板与 archive 目录需要持续修剪。proposal 数量越来越多,但 merge 时没人再回看。
团队认知需要有人判断哪些变化值得进入 OpenSpec,哪些不值得。团队开始用 OpenSpec 包装大项目,最后流程既轻不下去也重不起来。
长期收益如果没有与 PR 和验证命令联动,就会变成孤立文档堆。archive 没有检索价值,成员只好回到聊天记录找上下文。

团队检查清单

  • 团队能不能说清每个阶段产出什么,而不只是记住框架名。
  • 框架维护成本有没有低于它带来的返工下降与节奏稳定收益。
  • 只要真实任务已经持续绕开这套骨架,就该先停下来做减法。

这类风险页的作用,不是证明框架“也有问题”,而是帮助你在框架开始失效时尽早识别出错方向,避免继续往一个已经不被真实任务采用的骨架里堆更多 ritual。

下一步怎么读

  • Spec Kit:当你需要更完整的 spec 与 plan 链时,Spec Kit 更合适。
  • BMAD:当任务跨角色跨阶段时,BMAD 更能承载治理。
  • Superpowers:当你要的是 agent 每天如何执行,而不是 proposal 管理层时,Superpowers 更直接。
  • Bugfix / Refactor / Test:OpenSpec 很适合承接高频维护型变化。
  • Issue / Jira -> Draft PR:proposal 通过后,可直接进入异步 PR 流程。

来源