SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-15 19:58

技能介绍

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

主要能力:列出可用变更供用户选择;通过 openspec status --change "<name>" --json 检查产物完成状态;读取 tasks.md 统计未完成任务;检查 openspec/changes/<name>/specs/ 下的增量规格并与 openspec/specs/<capability>/spec.md 对比,评估需应用的增删改;执行归档并输出摘要。

使用方式:未提供变更名时先运行 openspec list --json 并让用户选择,不猜测或自动选择。产物或任务未完成时给出警告并确认是否继续。归档时创建目录并移动:mkdir -p openspec/changes/archive;mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>。若目标已存在则报错,建议重命名或换日期。若需同步,通过 Task 工具调用 openspec-sync-specs。

适用场景:实现完成后的变更收尾与归档,尤其是需要同步增量规格到主规格的流程。

限制:归档不因警告而阻塞,仅提示并确认;.openspec.yaml 随目录移动保留;无 tasks 文件时跳过任务警告;无增量规格时跳过同步提示。具体工具与命令行为以实际环境为准。