SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-16 07:26

技能介绍

用途:在实验性工作流中完成并归档一个已实现的变更。

主要能力:列出可用变更供用户选择;检查产物完成状态;检查任务完成情况;评估 delta spec 与主 spec 的同步状态;执行归档并输出摘要。

使用方式:可选指定变更名称,未提供时从上下文推断,模糊则必须提示选择。运行 openspec list --json 获取可用变更,仅显示未归档的活动变更,并让用户选择,不得猜测或自动选择。运行 openspec status --change "<name>" --json 检查产物完成状态,解析 schemaName 与 artifacts 状态;若有未完成产物,显示警告并用 AskUserQuestion 确认是否继续。读取 tasks.md,统计 - [ ] 与 - [x];若有未完成任务,显示数量警告并确认;无任务文件则跳过。检查 openspec/changes/<name>/specs/ 下的 delta spec,与 openspec/specs/<capability>/spec.md 比较,汇总将应用的增删改重命名;需要同步时提示“Sync now (recommended)”或“Archive without syncing”,已同步时提示“Archive now”“Sync anyway”“Cancel”。选择同步则通过 Task 工具调用 openspec-sync-specs。归档时执行 mkdir -p openspec/changes/archive,生成 YYYY-MM-DD-<change-name>,若目标已存在则报错并建议重命名或换日期,否则执行 mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>。最后输出变更名、schema、归档位置、是否同步及警告。

限制:警告不阻止归档,仅提示并确认;移动时保留 .openspec.yaml;未提供变更名称时必须提示选择。