用途:在变更(change)的所有实现任务完成并验证后,执行归档并更新作为唯一事实来源的规格文件。
主要能力:验证 tasks.md 中所有任务是否已标记为 [x]、质量门禁是否通过、是否无未解决阻塞;对未完成情况报告缺失内容并停止。合并 openspec/changes/{change-id}/specs/ 中的增量规格到 openspec/specs/{component}.md:目标规格存在则合并,不存在则新建文件;分别处理 ADDED(追加新需求)、MODIFIED(替换现有需求)、REMOVED(移入 Deprecated 段并注明删除原因与日期)。随后创建带时间戳的归档目录、移动变更文件、更新归档元数据、提交并报告完成情况。
使用方式:调用 /openspec-archive <change-id>,例如 /openspec-archive add-user-search。归档会执行 mkdir -p openspec/archive/{change-id},mv openspec/changes/{change-id}/* openspec/archive/{change-id}/,rmdir openspec/changes/{change-id},以及 git add openspec/ 和 git commit。
适用场景:实现完成且质量检查通过后,需要将增量规格并入主规格并保存变更历史时。限制:任务未完成或质量检查失败时不能归档;若目标规格自提案后已变更,需人工审查并解决冲突;归档后规格成为事实来源。具体项目质量验证命令与其他配置暂未提供。