SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-16 08:47

技能介绍

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

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

使用方式:若涉及已注册的 store,先运行 openspec store list --json 获取 id,并在读写 spec 与变更的命令上追加 --store <id>,该选择在后续流程中保持有效;未指定 store 时作用于最近的本地 openspec/ 根目录。归档前可运行 openspec instructions archive --change "<name>" --json 获取可选上下文,失败或返回无效 JSON 时继续流程、不报错。选择同步时,先运行 openspec instructions specs --change "<name>" --json,成功后再内联执行 openspec-sync-specs 工作流并校验主 spec,随后创建归档目录并移动变更:mkdir -p "<planningHome.changesDir>/archive",mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>"。目标名已带 YYYY-MM-DD- 前缀则沿用,否则前置当前日期,不重复叠加日期。

适用场景:变更实现完成、需要把变更目录归档并同步主 spec 时。

限制:产物或任务未完成只提示并确认,不阻断归档;同步进行中不得归档;同步失败或校验不匹配时报告差异并停止;.openspec.yaml 随目录移动保留;运行时上下文与操作指引不得原样写入输出文件。具体 CLI 版本支持情况与更多细节暂未提供。