SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 11-16 16:09

技能介绍

用途:该技能用于在实验性工作流中归档一个已完成的变更,适合在变更实施完毕后进行最终收尾。

主要能力:

  1. 选择变更:若未提供变更名,则通过 openspec list --json 获取可用变更,并使用 AskUserQuestion 工具让用户选择;只显示活跃变更(未归档),并尽可能显示每个变更所用的 schema。不会猜测或自动选择变更。
  2. 检查产物完成状态:运行 openspec status --change "<name>" --json,解析 schemaName 与 artifacts 状态;若有未完成产物,展示警告并确认是否继续。
  3. 检查任务完成状态:读取任务文件(通常为 tasks.md),统计未完成(- [ ])与已完成(- [x])任务;若有未完成任务,显示数量警告并确认是否继续;若无任务文件则直接继续。
  4. 评估增量规格同步状态:检查 openspec/changes/<name>/specs/ 下的增量规格,若有则与 openspec/specs/<capability>/spec.md 中的主规格比对,确定新增、修改、删除、重命名等变更,并在提示前展示综合摘要。提示选项包括:需要同步时为“立即同步(推荐)”或“不同步直接归档”;已同步时为“立即归档”“仍然同步”或“取消”。若用户选择同步,则通过 Task 工具调用 openspec-sync-specs。
  5. 执行归档:创建 openspec/changes/archive 目录(如不存在),以当前日期生成目标名 YYYY-MM-DD-<change-name>,若目标已存在则报错并建议重命名现有归档或使用其他日期;否则将变更目录移动到归档目录。
  6. 展示摘要:显示变更名、所用 schema、归档位置、规格是否同步(如适用)以及未完成产物/任务的警告说明。成功时输出归档完成信息。

使用方式:由用户触发,可选择性提供变更名;技能会通过运行 openspec 命令与读取文件来检查状态,并在关键节点(产物未完成、任务未完成、规格同步选择)请求用户确认。

适用场景:实施完成后需要正式归档变更、希望确认收尾完整性并同步规格的工作流。

限制与注意事项:需要项目中存在 openspec 命令与相应目录结构;不会因警告而阻止归档,仅提示并确认;移动归档时会随目录保留 .openspec.yaml;若目标归档名已存在则失败。