SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-16 05:48

技能介绍

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

主要能力:选择目标变更(可指定名称,或从上下文推断、唯一活跃变更自动选中、歧义时列出活跃变更让用户选择);通过 openspec status --change "<name>" --json 检查产物完成状态;读取 tasks.md 统计未完成任务;依据 artifactPaths.specs.existingOutputPaths 评估增量规格与主规格的同步状态,并给出合并摘要与选项(立即同步、不同步直接归档、取消等);最后在 changesDir 下创建 archive 目录并移动变更目录。

使用方式:涉及规格与变更的读写命令可加 --store <id>(先用 openspec store list --json 发现已注册 store),选定后在该工作流内保持粘性;无 store 时作用于最近的本地 openspec/ 根。归档前可运行 openspec instructions archive --change "<name>" --json 获取可选上下文,失败不阻塞。若选择同步,需先运行 openspec instructions specs --change "<name>" --json 获取规格规则,再内联执行 openspec-sync-specs 工作流并等待完成,随后重新比对每个增量规格能力,确认已同步后才移动 changeRoot。归档目录名若变更名已带 YYYY-MM-DD- 前缀则原样使用,否则前置当前日期;目标已存在则报错。

适用场景:变更实现完毕、需要把变更目录移入归档并同步主规格时。

限制:产物或任务未完成只警告并需用户确认,不阻塞归档;同步未完成前不得归档;同步失败或比对不一致时报告差异并停止;运行时上下文与操作指引仅为提示级输入,冲突时以既有控制输入为准,且不得原样写入输出文件。具体 CLI 版本兼容性与更多细节以官方资料为准,暂未提供。