SuperAPI AI 工具集

openspec-archive-change

通用与其它

查看项目

更新于 10-16 05:54

技能介绍

用途:在实验性工作流中归档已完成的变更,适用于实现完成后需要定稿并归档的场景。

主要能力:选择变更(可由对话推断、唯一活跃变更自动选定,或列出活跃变更让用户选择);通过 openspec status --change "<name>" --json 检查产物完成状态;读取 tasks.md 统计未完成任务;依据 artifactPaths.specs.existingOutputPaths 评估增量规范与主规范的同步差异。

使用方式:涉及 store 时先运行 openspec store list --json 获取已注册 store id,并在读取或写入 specs、changes 的命令上追加 --store "<id>",该选择在后续流程中保持。归档前可运行 openspec instructions archive --change "<name>" --json 获取可选提示输入,该调用仅供参考,失败不阻断归档。若需同步,先运行 openspec instructions specs --change "<name>" --json,成功后再以内联方式运行 openspec-sync-specs 并同步等待完成,随后重新比对每个增量规范确认已同步。最后创建归档目录 mkdir -p "<planningHome.changesDir>/archive",目标名已含 YYYY-MM-DD- 前缀则原样使用,否则前置当前日期,确认目标不存在后用 mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>" 移动,并输出变更名、schema、归档位置与同步情况摘要。

限制:产物或任务未完成只警告并请求确认,不阻断归档;同步未完成或验证不匹配时不得归档;目标目录已存在则报错;.openspec.yaml 随目录移动保留;运行时上下文与操作指引属提示级约定,不得原样复制进输出文件。命令格式与示例以资料为准。