用途:在 OpenSpec 实验性工作流中收尾并归档一个已实现完成的变更,可选指定变更名,未指定时从对话上下文推断、唯一活动变更自动选择,模糊时必须提示用户选择。 主要能力:通过 openspec status --change "<name>" --json 检查制品与任务完成情况(skipped 视为满足);读取 tasks.md 统计未完成任务;用 artifactPaths.specs.existingOutputPaths 作为增量规格唯一来源,与主规格比较增删改重命名并展示汇总;可按需内联运行 openspec-sync-specs 完成主规格同步并复查;最后在 planningHome.changesDir 下建立 archive 目录,把 changeRoot 移动到 YYYY-MM-DD-<change-name>(已有日期前缀则不重复加日期)。 使用方式:涉及 store 时先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上追加 --store <id> 且保持粘性;归档前可运行 openspec instructions archive --change "<name>" --json 获取可选提示输入,该查询失败或返回无效 JSON 时继续归档、不报错;若选择同步,需先运行 openspec instructions specs --change "<name>" --json 并确保退出码为 0,同步必须内联同步执行,禁止委托后台任务,且不得在同步进行中归档。 适用场景:OpenSpec 变更实现完毕后需要确认收尾、同步增量规格到主规格并归档目录时。 限制:警告(未完成制品或任务)不阻塞归档,仅提示并需用户确认;目标归档名已存在则失败并需改名或改日期;增量规格缺失时跳过同步提示;运行上下文与操作指引不得原样写入输出文件,与内置步骤或用户选择冲突时以控制性输入为准;同步后需逐能力复查,未通过则停止归档。资料未提供具体安装命令、收费、平台与效果信息。
openspec-archive-change
编程与开发
更新于 10-15 21:48