SuperAPI AI 工具集

openspec-archive-change

办公与效率

查看项目

更新于 10-15 21:48

技能介绍

用途:这是一个 OpenSpec 实验性工作流技能,用于把已完成的变更归档。用户需先指定变更名称,若未提供则从对话上下文推断;只有一个活动变更时自动选择,模糊时必须提示用户从活动变更中挑选,并说明如何覆盖(如 Codex 用 $openspec-archive-change,其他 agent 用 /openspec-archive-change)。

主要能力与流程:先做 store 选择,如指定 store 则运行 openspec store list --json 获取 id,并在读写 specs 与 changes 的命令上追加 --store <id>(选定后保持粘性);无 store 时作用于最近的本地 openspec/ 根目录。随后读取 openspec instructions archive --change "<name>" --json 作为可选输入,失败不阻断归档。用 openspec status --change "<name>" --json 检查工件完成状态,读 tasks.md 统计未完成任务,二者有未完成时仅警告并请用户确认。再用 artifactPaths.specs.existingOutputPaths 评估 delta spec 同步状态,对比主 spec(路径为 planningHome.root/openspec/specs/<capability-path>/spec.md),展示合并摘要后提供“立即同步(推荐)/不同步直接归档”或“立即归档/仍然同步/取消”选项。同步前运行 openspec instructions specs --change "<name>" --json 并要求成功,然后内联执行 openspec-sync-specs 工作流(不可后台委派),同步后逐一复核 ADDED/MODIFIED/REMOVED/RENAMED,失败或不一致则停止归档。最后 mkdir -p "<planningHome.changesDir>/archive",目标名为已有 YYYY-MM-DD- 前缀则沿用,否则加当前日期,冲突时报错;用 mv 移动 changeRoot,输出归档摘要。

限制:不阻塞于警告只提示确认;.openspec.yaml 随目录一起移动;运行时常量、操作指引与工件规则文本不得原样写入输出文件;仓库路径、日期、store id 等细节以实际运行为准。