用途:在实验性工作流中完成并归档一个已实现的变更。
主要能力:列出可用变更供用户选择;通过 openspec status --change "<name>" --json 检查产物完成状态;读取 tasks.md 统计未完成任务;比较增量规格与主规格并给出同步摘要;将变更目录移动到归档目录并输出归档摘要。
使用方式:未提供变更名时先运行 openspec list --json 并让用户选择,不猜测或自动选择。检查状态后,若 actionContext.mode 为 workspace-planning,则说明该切片不支持工作区归档并停止。存在未完成产物或任务时给出警告并确认是否继续。若存在增量规格,比较 openspec/specs/<capability>/spec.md 并提示同步选项;选择同步时通过 openspec-sync-specs 处理。归档时创建 <planningHome.changesDir>/archive,生成 YYYY-MM-DD-<change-name> 目标名,若已存在则报错,否则执行 mv "<changeRoot>" "<planningHome.changesDir>/archive/YYYY-MM-DD-<name>"。
适用场景:实现完成、需要把变更正式归档并同步规格时。
限制:工作区规划模式不支持归档;不阻塞于警告,仅提示确认;移动时保留 .openspec.yaml;具体平台、收费与安装方式暂未提供。