SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:在 OpenSpec 实验性工作流中归档已完成的变更,适合实现完成后需要定稿、把变更移入归档并同步规格的场景。

主要能力:选择变更(从上下文推断或让用户选择);用 openspec status --change "<name>" --json 检查产物与任务完成情况;依据 artifactPaths.specs.existingOutputPaths 评估 delta spec 与主规格的差异并提示同步;最后把 changeRoot 移动到归档目录并输出摘要。

使用方式:若指定了 store,先用 openspec store list --json 查询,再在读写 spec 与 change 的命令上追加 --store <id>;归档前可运行 openspec instructions archive --change "<name>" --json 获取上下文(该查询为可选,失败不阻塞)。同步前必须运行 openspec instructions specs --change "<name>" --json 且要求成功。归档时执行 mkdir -p "<planningHome.changesDir>/archive",目标名已有 YYYY-MM-DD- 前缀则沿用,否则前置当前日期,已存在则报错;然后 mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>"。

限制:产物或任务不完整只警告并让用户确认,不阻断;delta spec 同步必须内联运行并验证后才可移动目录,不得后台委派;具体收费、平台与效果资料暂未提供。