SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

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

主要能力:选择变更(可由名称、对话上下文推断,或列出活跃变更让用户选择);用 openspec status --change "<name>" --json 检查工件完成情况;读取 tasks.md 统计未完成任务;用 artifactPaths.specs.existingOutputPaths 判断 delta 规格与主规格的同步状态,并给出同步或跳过同步选项;执行同步需先运行 openspec instructions specs --change "<name>" --json 获取规则快照,再内联运行 openspec-sync-specs 工作流并复核;最后在 changesDir 下创建 archive 目录,把 changeRoot 移动到 YYYY-MM-DD-<change-name> 目标。

使用方式:若变更属于已注册 store,先用 openspec store list --json 查 id,并在读写规格与变更的命令上追加 --store <id>。归档前可运行 openspec instructions archive --change "<name>" --json 获取补充提示,该命令失败可忽略继续。移动前使用 mkdir -p "<planningHome.changesDir>/archive" 与 mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>"。

限制:未完成任务或工件不完整只提示并确认,不阻止归档;规格同步仍在进行时绝不移动 changeRoot;目标已存在时报错建议改名或换日期,且不叠加第二个日期前缀;不把运行时上下文、操作指引或规则文本原样写入输出文件。缺失事实暂未提供。