用途
openspec-continue-change 是一个用于推进 OpenSpec 变更流程的技能。当用户想要继续某个变更、创建下一个产物或恢复中断的工作时,该技能会引导完成当前变更中下一个待创建的文档产物。
主要能力
- 列出可用的 OpenSpec 变更,按最近修改时间排序,并让用户选择要继续的变更。
- 查询指定变更的当前状态,包括所用 schema、各产物的状态(done、ready、blocked)以及是否全部完成。
- 根据状态自动识别下一个可创建的产物,并获取该产物的详细指令。
- 读取已完成依赖产物的内容作为上下文,按照模板和规则创建新的产物文件。
- 创建完成后展示进度、当前 schema 以及新解锁的产物,并提示用户是否继续。
使用方式
用户调用时可选指定变更名称。若未指定,技能会运行 openspec list --json 获取可用变更,并通过提问让用户选择,不会自动猜测或选择变更。选择后,技能运行 openspec status --change "<name>" --json 检查状态,并根据结果执行:
- 若所有产物已完成,则祝贺用户并提示可以实施或归档该变更。
- 若有产物状态为 ready,则选取第一个 ready 的产物,运行
openspec instructions <artifact-id> --change "<name>" --json获取 context、rules、template、instruction、outputPath 和 dependencies,然后读取依赖文件、按模板创建产物并写入指定路径。 - 每次调用只创建一个产物,创建后再次运行
openspec status --change "<name>"展示进度。
适用场景
适用于使用 OpenSpec 进行规范驱动开发的团队或个人,在变更流程中按顺序创建提案、规格、设计、任务等文档。常见于 spec-driven schema 的工作流:proposal → specs → design → tasks。
限制
- 每次调用仅创建一个产物,不跳过产物或乱序创建。
- 必须先读取依赖产物再创建新产物。
- context 和 rules 是给 AI 的约束,不应复制到产物文件中。
- 若上下文不清晰,需先询问用户。
- 产物类型和顺序取决于所用 schema,不应假定具体产物名称。
- 需要已安装并配置 OpenSpec 命令行工具,且存在有效的变更。