用途:在实验性工作流中完成并归档一个已实现的变更。
主要能力:列出可用变更供用户选择;检查产物完成状态(openspec status --change "<name>" --json);检查任务文件中未完成任务数量;评估 delta spec 与主 spec 的同步状态并给出合并摘要;执行归档并输出摘要。
使用方式:若未提供变更名,先运行 openspec list --json 获取可用变更,仅显示未归档的活跃变更,并通过 AskUserQuestion 让用户选择,不猜测或自动选择。随后检查产物与任务完成情况,如有未完成项则警告并确认是否继续。若存在 openspec/changes/<name>/specs/ 下的 delta spec,则与 openspec/specs/<capability>/spec.md 比较,提示“Sync now (recommended)”或“Archive without syncing”;若已同步则提示“Archive now”“Sync anyway”“Cancel”。选择同步时通过 Task 工具调用 openspec-sync-specs。归档时执行 mkdir -p openspec/changes/archive,生成 YYYY-MM-DD-<change-name> 目标名,若已存在则报错并建议重命名或换日期,否则执行 mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>。最后输出归档摘要,包含变更名、所用 schema、归档位置、spec 是否同步及警告说明。
适用场景:变更实现完成后的收尾归档。
限制:不阻塞于警告,仅提示并确认;移动目录时保留 .openspec.yaml;无任务文件时跳过任务警告;无 delta spec 时跳过同步提示。具体工具与命令行为以实际环境为准。