SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-16 03:17

技能介绍

用途:在 OpenSpec 实验性工作流中,把已实现完成的变更正式归档。

主要能力:若未提供变更名,先运行 openspec list --json 列出可用变更并让用户选择(只显示未归档的活动变更,不猜测、不自动选择);运行 openspec status --change "<name>" --json 检查产物完成状态,解析 schemaName 与 artifacts;读取 tasks.md 统计未完成任务;检查 openspec/changes/<name>/specs/ 下的 delta spec,与 openspec/specs/<capability>/spec.md 对比并汇总将应用的增删改重命名。

使用方式:对未完成产物或任务给出警告并用 AskUserQuestion 确认是否继续;delta spec 存在时提示“Sync now (recommended)”或“Archive without syncing”,已同步时提示“Archive now”“Sync anyway”“Cancel”,选择同步则执行 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、归档位置、是否同步 spec 及警告说明。

限制:警告不阻止归档,仅提示并确认;移动时保留 .openspec.yaml;无 tasks 文件则跳过任务警告;无 delta spec 则跳过同步提示。具体收费、平台与效果资料暂未提供。