用途
OpenSpec Bulk Archive 用于一次性归档多个已完成的变更。它通过 /opsx:bulk-archive 命令触发，会校验每个变更、检测变更之间的规格冲突，并通过检查代码库中实际实现的内容来解决冲突。
何时使用
- 多个变更已完成并准备归档。
- 用户说“archive all”“bulk archive”“clean up finished changes”。
- 在一次冲刺或一批并行工作之后。
前提条件
- 存在多个任务已完成的活跃变更。
使用方式
运行批量归档：
/opsx:bulk-archive—— 列出所有已完成的变更并提示选择。/opsx:bulk-archive <name1> <name2> ...—— 归档指定的变更。
执行过程：
- 列出所有已完成的变更。
- 在归档前校验每个变更。
- 检测变更之间的规格冲突（例如两个变更触及同一个规格文件）。
- 通过检查代码库中实际实现的内容来解决冲突。
- 按创建日期的时间顺序归档。
确认环节：智能体展示列表和冲突解决计划，由用户确认。
输出
- 所有选中的变更归档到
openspec/changes/archive/。 - 增量规格按时间顺序合并到
openspec/specs/。
后续步骤
- 使用 openspec-new 开始新的变更。
限制与故障排查
- 规格冲突：智能体会检查代码库来解决；确认前请审阅解决方案。
- 未完成的变更：批量归档会对未完成任务发出警告，但不会阻止操作。
参考
- OpenSpec 命令：
/opsx:bulk-archive