SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

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

主要能力:选择目标变更(可由名称、对话上下文或唯一活跃变更推断,歧义时用 openspec list --json 让用户选择);读取可选归档输入(openspec instructions archive --change "<name>" --json,失败时不阻断归档);用 openspec status --change "<name>" --json 检查制品完成状态;读取 tasks.md 统计未完成任务;评估增量规格与主规格的同步状态。

使用方式:若使用已注册 store,先运行 openspec store list --json 获取 id,并在读写 specs/changes 的命令上加 --store <id>(选定后保持粘性)。必要步骤包括检查状态、确认警告、可选同步规格、创建 archive 目录并把 changeRoot 移动到 <planningHome.changesDir>/archive/<target-name>。目标名已带 YYYY-MM-DD- 前缀时不重复加日期;冲突则报错。

限制:制品或任务未完成只警告,需用户确认后继续;规格同步必须在归档前内联完成并验证,不得在同步进行中移动 changeRoot;运行期 context 与 operation guidance 不可直接复制到输出文件。其他细节资料暂未提供。