用途:在 OpenSpec 实验性工作流中,于变更实现完成后对其进行最终确认与归档。适用于用户想要收尾并归档某个变更的场景。
主要能力:可指定变更名,未指定时依据会话上下文推断,仅在存在一个活动变更时自动选择,含糊时列出活动变更请用户选择并提示如何覆盖。通过 openspec status --change "<name>" --json 检查制品与任务完成情况,对未完成制品或未完成任务给出警告并请求确认。评估 delta spec 同步状态,读取 artifactPaths.specs.existingOutputPaths,与主规格比较后给出合并摘要并询问:需要同步时可选“立即同步(推荐)”或“不同步直接归档”;已同步时可选“立即归档”“仍要同步”“取消”。同步前需运行 openspec instructions specs --change "<name>" --json 获取规则,然后内联执行 openspec-sync-specs 工作流(代理驱动的智能合并),完成后重新比对直到无待应用内容;任意能力不匹配则停止归档。
使用方式与存储:若指定 store 或工作位于 store 中,先运行 openspec store list --json 发现 id,并在读取或写入规格与变更的命令上追加 --store <id>,该选择在后续流程中保持;未指定 store 时命令作用于最近的本地 openspec/ 根。归档时在 planningHome.changesDir 下创建 archive 目录,目标名以 YYYY-MM-DD- 前缀生成且不重复叠加日期,若目标已存在则报错。
限制:同步必须在归档前内联完成并验证,绝不在同步进行中移动 changeRoot;CLI 检查、路径解析、提示和命令契约不变;运行时上下文与操作指引仅为提示级输入,冲突时保留控制性取值,且不得逐字写入输出文件。部分细节(如具体平台与收费)暂未提供。