SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

用途:在 OpenSpec 实验性工作流中,把已完成的变更正式归档。适合用户希望在实现结束后收尾归档变更的场景。

主要能力:选择变更(可由用户指定、从对话上下文推断,或在仅有一个活跃变更时自动选择;名称模糊时必须列出活跃变更让用户选择);通过 openspec status --change "<name>" --json 检查产物完成状态(done 或 skipped 视为满足);读取任务文件统计未完成任务并给出警告;用 artifactPaths.specs.existingOutputPaths 作为增量规格唯一来源,与主规格比较后提示是否同步;同步前需成功运行 openspec instructions specs --change "<name>" --json 获取规则;归档时在 planningHome.changesDir 下创建 archive 目录并移动 changeRoot。

必要用法:如涉及已注册的 store,先用 openspec store list --json 发现 id,并在读写规格与变更的命令上附加 --store <id>(该标志在后续流程中保持粘性);无 store 时命令作用于最近的本地 openspec/ 根。归档前可选运行 openspec instructions archive --change "<name>" --json,失败不阻断归档。若存在增量规格,需内联运行 openspec-sync-specs 工作流并等待完成,再逐项复核每个能力是否已同步,未通过则停止归档。

限制:存在未完成产物或任务时需用户确认才继续;目标归档名已存在则报错;同步未完成前不得移动 changeRoot;运行时上下文与操作指引仅为提示级契约,与显式选择、解析路径、CLI 检查等冲突时应报告并保留控制项;归档以 YYYY-MM-DD-<name> 命名,已带日期前缀则不重复叠加。具体安装与调用示例资料中暂未提供。