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 更直接。