SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-16 06:13

技能介绍

用途:在 OpenSpec 实验性工作流中,把一个已完成的变更收尾并归档,适合实现结束、准备把变更移出活跃列表的场景。

主要能力:解析并选定目标变更(可省略名称,从上下文推断;多个活跃变更时用 openspec list --json 让用户选择);用 openspec status --change "<name>" --json 检查工件完成状态;读取 tasks.md 统计未完成任务;评估增量规范与主规范的同步状态并给出合并摘要;创建 archive 目录并把变更目录移动过去;输出归档摘要。若注册了 store,可用 openspec store list --json 发现 id,并在读写规范/变更的命令上追加 --store <id>(选定后对该工作流保持粘性)。

使用方式:先运行 openspec instructions archive --change "<name>" --json 获取可选上下文(失败或旧 CLI 不支持时继续,不阻断);再运行 openspec status --change "<name>" --json;存在增量规范时比较 artifactPaths.specs.existingOutputPaths 中的规范与 <planningHome.root>/openspec/specs/<capability-path>/spec.md,提示用户选择同步或直接归档;选择同步时先运行 openspec instructions specs --change "<name>" --json(要求成功且返回有效 JSON,否则报错停止),再内联执行 openspec-sync-specs 工作流并复核,全部一致后才归档;最后 mkdir -p "<planningHome.changesDir>/archive",目标名为 YYYY-MM-DD-<change-name>(已带日期前缀则保持原样),用 mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>"。

适用场景:变更实现完成、需要归档并更新主规范时。

限制:工件或任务未完成只警告并需用户确认,不阻断;目标归档名已存在则失败;规范同步未完成前不得归档;同步只能内联同步执行并等待,不可后台委派。资料未提供具体价格、平台与版本兼容信息。