OpenSpec:角色、阶段与产物
框架和“任务模板”的差别,在于它不仅告诉你先做什么、后做什么,还定义了哪些角色切面需要出现、哪些产物必须沉淀、哪些 handoff 不能跳过。
角色切面
- Requester:提出变更需求和业务背景。
- Proposer:把需求转成 proposal 与 change set。
- Implementer:按 proposal 执行代码与验证。
- Approver:确认 proposal 是否值得进入实现与归档。
阶段总表
| 阶段 | 目标 | 主要产物 |
|---|---|---|
| 提 proposal | 先说明为什么要改、改什么、不改什么。 | proposal |
| 形成 change set | 把 proposal 转成具体改动包与依赖说明。 | change set |
| 执行与验证 | 在实现阶段对照 proposal 做最小变更。 | implemented change |
| archive | 把结果、结论和后续处理归档,保留变更历史。 | archive record |
核心产物
- proposal、change、archive 三段式记录。
- 与 PR 或任务系统可关联的轻量变化说明。
- 适合 brownfield 语境的最小验证与决策证据。
交接点
- proposal 先确认,再执行 change,不要让实现反推需求。
- archive 不是可选装饰,而是让后续团队知道这个改动为什么存在。