SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-16 05:47

技能介绍

用途:归档已完成的 OpenSpec change,属于实验性工作流的一部分,用于在实现完成后收尾并归档变更。

主要能力:可选指定 change 名称(省略时从上下文推断、唯一活跃变更自动选择,模糊时提示选择);用 openspec status --change "<name>" --json 检查产物(artifact)完成状态,用 openspec list --json 读取并校验 totalTasks/completedTasks;评估 delta spec 与主 spec 的同步状态(新增、修改、删除、重命名),必要时以内联方式执行 openspec-sync-specs 智能合并,再复核主 spec 结构。

使用方式:涉及 store 时先 openspec store list --json 获取 id,并在读写 spec/change 的命令(new change、status、instructions、list、show、validate、archive、doctor、context、schemas、view)上附加 --store <id> 且保持黏性;写入前用 openspec list --json 确认存在 root,root 为 null 表示未初始化,不得因写入副作用创建 openspec/。归档先建目录再移动:mkdir -p "<planningHome.changesDir>/archive",目标名已带 YYYY-MM-DD- 前缀则原样使用,否则前置当前日期,最终 mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>"。

适用场景:已使用 OpenSpec 的项目在实现完成后收尾变更、同步 spec 并归档;无 store 时作用于最近的本地 openspec/ 根目录。

限制:产物或任务未完成时仅警告并需用户确认,不阻断归档;delta spec 同步受阻(如仅有 MODIFIED/RENAMED 而无 ADDED、无主 spec 可删除的 REMOVED-only 情况)时只能“不同步归档”或取消;同步未完成前不得移动 changeRoot;归档目标已存在时报错。安装命令及支持的 CLI 版本、收费方式等资料暂未提供。