SuperAPI AI 工具集

openspec-continue

编程与开发

查看项目

更新于 10-16 07:54

技能介绍

OpenSpec Continue 技能用于在依赖链中创建下一个产物,通过 /opsx:continue 命令以增量方式构建变更,一次只创建一个产物,让用户可以在继续之前进行审阅和编辑。

用途

当用户希望以增量、逐步的方式创建产物时使用。典型场景包括:在通过 openspec-new 创建变更后,希望一次构建一个产物;用户说出“continue”“next artifact”“create specs”“create design”等指令时。

前提条件

存在一个活跃的变更(通过 openspec-new 或 /opsx:new 创建)。

工作流程

  1. 查询依赖图:运行 openspec status --change <name> --json,查看哪些产物已完成、就绪或被阻塞。
  2. 识别就绪产物:在默认的 spec-driven schema 中,依赖关系为 proposal -> specs / design -> tasks。依赖是使能关系:一旦某个依赖完成,其依赖项就变为“就绪”。
  3. 创建一个产物:读取依赖文件以获取上下文;运行 openspec instructions <artifact> --change <name> --json 获取增强的指令和模板;创建第一个就绪的产物(例如先 proposal,然后 specs,然后 design,然后 tasks)。
  4. 展示解锁内容:创建产物后,报告接下来哪些内容变得可用。
  5. 重复:用户审阅、可选编辑,然后再次运行 /opsx:continue 创建下一个产物。

产物依赖图(spec-driven schema)

proposal(根,无依赖) | +---> specs(需要:proposal) | +---> design(需要:proposal) | +---> tasks(需要:specs + design)

输出

每次调用创建一个产物文件(例如 proposal.md、specs/**/*.md、design.md、tasks.md)。

后续步骤

再次运行 /opsx:continue 创建下一个产物。当所有规划产物完成后:使用 openspec-apply 实现任务;或使用 openspec-ff 快进剩余产物。

故障排除

“No artifacts ready”:所有产物要么已完成,要么被阻塞。检查 openspec status --change <name>。 “Change not found”:显式指定变更名称:/opsx:continue add-dark-mode。

参考

OpenSpec 命令:/opsx:continue OpenSpec 概念:Artifacts