SuperAPI AI 工具集

openspec-archive-change

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:在实验性 OpenSpec 工作流中归档已完成的变更,通常在实现完成后由用户发起。

主要能力:选择变更(可从对话推断、只有一个活动变更时自动选择,歧义时列出活动变更让用户选择);用 openspec status --change "<name>" --json 检查工件完成状态;读取 tasks.md 统计未完成任务;依据 status JSON 中 artifactPaths.specs.existingOutputPaths 评估 delta 规格与主规格的同步差异,并提示同步、跳过同步或取消;未同步时需先运行 openspec instructions specs --change "<name>" --json 获取规则,再以内联方式运行 openspec-sync-specs 工作流并逐项复核;最后在 planningHome.changesDir 下创建 archive 目录,将 changeRoot 移动为 YYYY-MM-DD-<change-name>(已带日期前缀则不重复添加)。

使用方式:可选指定变更名;若使用已注册的独立 OpenSpec store,先运行 openspec store list --json 查询 id,并在读取或写入规格与变更的命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)上追加 --store <id>,选定后该标志在后续流程中保持有效;无 store 时作用于最近的本地 openspec/ 根目录。归档前会运行 openspec instructions archive --change "<name>" --json 获取可选上下文与操作指引,视为建议,失败或返回无效 JSON 时不阻断流程。

适用场景与限制:适用于本地或注册 store 中的 OpenSpec 变更归档;存在未完成工件或任务时会警告并请用户确认,不阻断归档;规格同步未通过校验时停止归档,避免主规格未更新而变更已被移动。迁移时保留 .openspec.yaml。其他实现细节与收费情况暂未提供。