| name | openspec-continue-change |
| description | 通过创建下一个产出物继续处理 OpenSpec 变更。当用户想要推进其变更、创建下一个产出物或继续其工作流程时使用。 |
| license | MIT |
| compatibility | 需要 openspec CLI。 |
| metadata | {"author":"openspec","version":"1.0","generatedBy":"1.1.1-1"} |
通过创建下一个产出物继续处理变更。
输入:可选指定变更名称。如果省略,检查是否可以从对话上下文中推断。如果模糊或不明确,你必须提示获取可用变更。
步骤
-
如果没有提供变更名称,提示选择
运行 openspec-cn list --json 获取按最近修改排序的可用变更。然后使用 AskUserQuestion tool 让用户选择要处理哪个变更。
展示前 3-4 个最近修改的变更作为选项,显示:
- 变更名称
- Schema(如果存在
schema 字段,否则为 "spec-driven")
- 状态(例如:"0/5 tasks", "complete", "no tasks")
- 最近修改时间(来自
lastModified 字段)
将最近修改的变更标记为 "(推荐)",因为它很可能是用户想要继续的。
重要提示:不要猜测或自动选择变更。始终让用户选择。
-
检查当前状态
openspec-cn status --change "<name>" --json
解析 JSON 以了解当前状态。响应包括:
schemaName:正在使用的工作流 schema(例如:"spec-driven")
artifacts:产出物数组及其状态("done"、"ready"、"blocked")
isComplete:布尔值,表示是否所有产出物都已完成
-
根据状态行动:
如果所有产出物已完成 (isComplete: true):
- 祝贺用户
- 显示最终状态,包括使用的 Schema
- 建议:"所有产出物已创建!您现在可以实现此变更或将其归档。"
- 停止
如果产出物准备好创建(状态显示有 status: "ready" 的产出物):
如果没有产出物准备好(全部受阻):
- 在有效的 Schema 下不应发生这种情况
- 显示状态并建议检查问题
-
创建产出物后,显示进度
openspec-cn status --change "<name>"
输出
每次调用后,显示:
- 创建了哪个产出物
- 正在使用的 Schema 工作流
- 当前进度(N/M 完成)
- 现在解锁了哪些产出物
- 提示:"想要继续吗?只需让我继续或告诉我下一步做什么。"
产出物创建指南
产出物类型及其用途取决于 Schema。使用指令输出中的 instruction 字段来了解要创建什么。
常见的产出物模式:
spec-driven schema(proposal → specs → design → tasks):
- proposal.md:如果变更不清楚,先向用户确认。填写“为什么”“什么变化”“能力”“影响”。
- “能力”部分很关键——列出的每个能力都需要一个 spec 文件。
- specs//spec.md:为提案“能力”部分列出的每个能力创建一个 spec(使用 capability 名称,而不是 change 名称)。
- design.md:记录技术决策、架构和实现方法。
- tasks.md:把实现拆分为带复选框的任务。
对于其他 schema,遵循 CLI 输出中的 instruction 字段。
护栏
- 每次调用只创建一个产出物
- 创建新产出物前,总是先阅读依赖产出物
- 不要跳过产出物,也不要乱序创建
- 如果上下文不清楚,创建前先询问用户
- 写入后先确认产出物文件存在,再标记进度
- 使用 schema 的产出物顺序,不要假设固定的产出物名称
- 重要:
context 和 rules 是对你的约束,不是文件内容
- 不要把
<context>、<rules>、<project_context> 块复制进产出物
- 它们用于指导你写作,但绝不能出现在输出中