用途:该技能用于在 OpenSpec 工作流中归档已完成的 L0-1 变更,确保在关闭流程前收集好产物、审批与后续行动。
触发方式:当用户说“Archive this change”“Close the change”“Finalize change”“Document this change”“Mark as complete”“Archive proposal [X]”“Wrap up this change”等,或提到 archive、close、document、finalize、complete、wrap up 并带有变更上下文时自动激活。
前置条件:变更已实现、测试通过且验证完成、部署或发布已完成(或已记录)。若变更尚未实现、测试失败或验证未完成、缺少审批或签署、变更仍在进行中,则不应调用(未实现时应使用 openspec-change-implementation)。
输入:带审批的原始 proposal.md、实现日志或提交记录、验证证据(测试结果或评审反馈)。
输出:archive.md 归档摘要(含成果、指标、经验教训,模板为 assets/archive-template.md.template);更新后的 proposal/tasks 完成状态;部署或回滚说明;openspec/specs/ 中的规范与已批准增量同步。
流程:用 CHECKLIST.md 验证关闭条件;收集最终状态(已交付内容、剩余事项、偏差);在 archive.md 中记录指标、审批与验证证据;运行 scripts/archive_change.py <change-id> 将规格增量合并到 openspec/specs/;记录经验教训与后续建议,更新产物并通知关闭。
质量门与错误处理:所有检查项通过后才能标记为已归档;若缺少验证证据或审批,需先索取;若无法完全归档,需列出未完成任务并指定负责人。
限制:资料未提供具体安装命令、收费方式、支持平台或性能数据。