跳到主要内容

OpenSpec

OpenSpec 更像轻量变更管理层:用 proposal、change 和 archive 管理 brownfield 项目的高频改动,不强行引入太重流程。

这个框架解决什么

  • 现有项目、brownfield 场景和高频小改动。
  • 需要显式记录变更原因,但又不想引入太多角色和阶段的团队。
  • 想把 proposal 与最终实现、归档记录连接起来的组织。

默认进入方式

从高频的现有项目迭代开始,先验证 OpenSpec 是否比完整 spec 链更贴近真实成本。

更适合谁

  • 团队高频处理小功能、增量优化、兼容调整和迭代型改动。
  • 需要追踪“为什么改”,但 spec-first 的完整产物链过重。
  • 现有 repo 治理还算稳定,只缺一层轻量 proposal 记录。

角色与阶段概览

阶段目标主要产物
提 proposal先说明为什么要改、改什么、不改什么。proposal
形成 change set把 proposal 转成具体改动包与依赖说明。change set
执行与验证在实现阶段对照 proposal 做最小变更。implemented change
archive把结果、结论和后续处理归档,保留变更历史。archive record

采用前检查

  • 先确认团队已经有 repo 规则、验证命令和明确 owner,否则只会把流程层再加一层壳。
  • 先挑一个真实任务试跑,而不是先做大面积制度推广。
  • proposal 先确认,再执行 change,不要让实现反推需求。
  • archive 不是可选装饰,而是让后续团队知道这个改动为什么存在。

下一步怎么读

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

来源