openspec-archive-change 是一个用于归档已完成变更的实验性工作流技能。它属于 full-aigc-skills/image-factory-skills 技能集,适用于用户在实现完成后希望最终确定并归档某个变更的场景。
用途:该技能帮助用户将某个已完成的变更归档到 OpenSpec 的归档目录中。它可以自动或根据用户输入选择变更,检查工件和任务的完成状态,评估规格增量是否已同步到主规格,并在用户确认后执行归档。
主要能力:
- 变更选择:可通过用户指定名称、对话上下文推断或从可用变更列表中选择;模糊时提示用户选择。
- Store 选择:若用户指定 store 或工作位于某个 store 中,可通过 openspec store list --json 发现已注册的 store id,并在后续命令中持续使用 --store <id>。
- 工件完成状态检查:运行 openspec status --change "<name>" --json,解析 schema、路径上下文和工件状态;若存在未完成工件,显示警告并请求用户确认。
- 任务完成状态检查:读取 tasks.md,统计 - [ ] 与 - [x] 的数量;若存在未完成任务,显示警告并请求确认;若无任务文件则跳过。
- 增量规格同步评估:使用 artifactPaths.specs.existingOutputPaths 作为增量规格来源,与主规格对比,显示合并摘要,并提供“立即同步(推荐)”、“不同步直接归档”或“归档/再次同步/取消”等选项。
- 同步执行:在写入主规格前运行 openspec instructions specs --change "<name>" --json 获取规则快照,然后内联运行 openspec-sync-specs 工作流进行智能合并,并验证所有增量规格均已同步。
- 归档操作:在 changesDir 下创建 archive 目录,生成带日期前缀的目标名称(若已有 YYYY-MM-DD- 前缀则不重复添加),检查目标是否存在,然后将 changeRoot 移动到归档目录。
- 成功输出:显示归档完成摘要,包括变更名、schema、归档位置、规格同步状态以及警告信息。
使用方式:该技能通常以代理技能形式调用,支持通过 $openspec-archive-change(Codex)或 /openspec-archive-change(其他代理)方式触发。需要本地安装 OpenSpec CLI,并依赖 openspec 命令进行状态查询、指令获取和归档移动操作。具体安装命令、配置方式暂未提供。
适用场景:
- 变更实施完成后需要最终定稿并归档。
- 需要检查工件和任务完成度后再决定是否归档。
- 需要将增量规格同步到主规格后再归档。
- 在多个 OpenSpec 仓库(store)环境中工作,需要指定 store 进行归档。
限制与注意事项:
- 该技能属于实验性工作流。
- 归档前会提示未完成工件或任务,但不会阻止归档,仅要求用户确认。
- 增量规格同步必须内联运行并验证,不能在同步进行中归档。
- 运行时上下文和操作指导为提示级输入,不得逐字复制到输出文件。
- 若 openspec instructions archive 命令失败或返回无效 JSON,可继续归档流程但不报告错误。
- 具体收费、价格、平台支持、效果等暂未提供。