SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

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

主要能力:选择目标变更(可从上下文推断或列出活动变更让用户选择);用 openspec status --change "<name>" --json 检查工件完成状态;读取 tasks.md 统计未完成任务;用 artifactPaths.specs.existingOutputPaths 作为 delta 规格唯一来源,与主规格比较并给出合并摘要;按用户选择执行同步或直接归档;最后把 changeRoot 移动到 archive 目录并输出摘要。

必要用法:若使用已注册的 store,先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上追加 --store <id>,该选择在后续流程中保持。归档前可运行 openspec instructions archive --change "<name>" --json 获取可选上下文,失败或返回无效 JSON 时继续流程。同步前必须运行 openspec instructions specs --change "<name>" --json,要求退出码为零且 JSON 有效,否则报错并停止。同步需内联执行 openspec-sync-specs 工作流并等待完成,随后重新比对全部 delta 规格。归档时创建 archive 目录,目标名已带 YYYY-MM-DD- 前缀则沿用,否则前置当前日期,已存在则报错。

适用场景:变更实现完成、需要同步规格并归档时。

限制:工件或任务未完成只警告并确认,不阻塞;同步未完成前不得移动 changeRoot;运行时上下文与操作指引不得原样写入输出文件;资料未提供具体收费、平台与效果信息。