SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:在 OpenSpec 实验性工作流中,把已实现完成的变更正式归档。

主要能力:选择目标变更(可指定名称,或从上下文推断、唯一活跃变更自动选中,歧义时列出活跃变更让用户选择);用 openspec status --change "<name>" --json 检查产物完成状态;读取 tasks.md 统计未完成任务;依据 artifactPaths.specs.existingOutputPaths 评估 delta 规格与主规格的同步状态,并给出合并摘要;执行归档,把 changeRoot 移动到 archive 目录。

必要用法:若使用已注册的 store,先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上追加 --store <id>,选定后保持粘性。归档前可运行 openspec instructions archive --change "<name>" --json 获取可选上下文,该命令失败或返回无效 JSON 时继续归档、不报错。同步前须运行 openspec instructions specs --change "<name>" --json 且要求退出码为零、JSON 有效,否则停止。同步以内联方式运行 openspec-sync-specs 工作流并等待完成,随后重新比对全部 delta 规格,确认已同步后才归档。归档命令为 mkdir -p "<planningHome.changesDir>/archive" 与 mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>";目标名已有 YYYY-MM-DD- 前缀则原样使用,否则前置当前日期,不叠加第二个日期。

适用场景:实现完成、需要把变更收尾并归档时。

限制:产物或任务未完成只警告并需用户确认,不阻塞归档;同步仍在进行时禁止归档;目标归档名已存在则报错;运行上下文与操作指引仅为提示级输入,冲突时保留控制性取值,且不得原样写入输出文件。