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