SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

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

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

必要用法:若使用已注册的 store,先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上追加 --store <id>,选定后保持粘性。归档前可运行 openspec instructions archive --change "<name>" --json 获取可选上下文,失败不阻塞。同步前须运行 openspec instructions specs --change "<name>" --json 且要求成功,再内联执行 openspec-sync-specs 并复核。归档时创建 mkdir -p "<planningHome.changesDir>/archive",目标名已带 YYYY-MM-DD- 前缀则沿用,否则前置当前日期,然后 mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>"。

适用场景:实现完成、需要把变更归档并同步主规格的 OpenSpec 项目。

限制:产物或任务未完成只警告并需用户确认,不阻塞;同步未完成或校验不通过时不得归档;不得把运行时上下文、操作指引或规则文本原样写入输出文件;资料未提供具体版本、收费与平台信息。