SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

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

主要能力:选择目标变更(可指定名称,或从上下文推断、唯一活跃变更自动选中,歧义时用 openspec list --json 让用户选择);用 openspec status --change "<name>" --json 检查产物完成状态;读取 tasks.md 统计未完成任务;依据 artifactPaths.specs.existingOutputPaths 评估 delta 规格与主规格的同步状态,并给出合并摘要与选项(立即同步、不同步直接归档、取消等);同步时先运行 openspec instructions specs --change "<name>" --json 获取规则,再内联执行 openspec-sync-specs 并逐项复核;最后创建 archive 目录、生成带日期前缀的目标名并移动 changeRoot。

使用方式:若使用已注册的 store,先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上追加 --store <id>,该选择在后续流程中保持有效;未指定 store 时作用于最近的本地 openspec/ 根目录。归档前可运行 openspec instructions archive --change "<name>" --json 获取可选上下文,该命令失败或返回无效 JSON 时不应中断归档。归档命令形如 mkdir -p "<planningHome.changesDir>/archive" 与 mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>"。

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

限制:产物或任务未完成只提示并确认,不阻塞归档;同步未完成或复核不匹配时必须停止归档;目标归档名已存在则报错;不得在同步进行中移动 changeRoot;运行时上下文与操作指引仅作提示,冲突时以既有步骤、用户选择、路径与命令契约为准。资料未提供具体版本、平台与收费信息。