SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-19 16:18

技能介绍

用途:openspec-archive-change 是一个面向实验性工作流的归档技能,用于在变更实现完成后将其收尾并归档。用户希望最终确定某个变更时使用。

主要能力:

  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 对应的主规格比较,判断将应用的变更(新增、修改、删除、重命名),并在提示前展示合并摘要。提示选项依据状态不同:需要变更时为“立即同步(推荐)”与“不同步直接归档”;已同步时为“立即归档”“仍然同步”“取消”。若用户选择同步,执行 /opsx:sync 逻辑(使用 openspec-sync-specs 技能),随后无论选择如何都继续归档。
  5. 执行归档:创建目录 mkdir -p openspec/changes/archive;以当前日期生成目标名 YYYY-MM-DD-<change-name>;若目标已存在则报错并建议重命名现有归档或更换日期;否则执行 mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>。
  6. 输出摘要:展示变更名、所用 schema、归档位置、规格是否同步(若适用)以及未完成产物/任务的警告说明。成功时输出固定格式的“Archive Complete”摘要。

使用方式:由支持该技能体系的代理调用,按上述步骤执行对应的 openspec 命令与工具交互;用户需要配合选择变更并在出现警告时确认。

适用场景:实验性工作流中变更实现完成后的归档收尾,尤其是需要检查产物与任务完整性、并决定是否将增量规格同步到主规格的场合。

限制与约束:必须始终提示用户选择变更,不得自动选择;归档不应因警告而阻塞,只需告知并确认;移动时保留 .openspec.yaml(随目录一起移动);必须展示清晰摘要;若请求同步,采用 openspec-sync-specs 的代理驱动方式;存在增量规格时始终先执行同步评估并在提示前展示合并摘要。具体命令行为、环境依赖与错误处理细节暂未提供。