openspec-continue-change
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese通过创建下一个产出物继续处理变更。
输入:可选指定变更名称。如果省略,检查是否可以从对话上下文中推断。如果模糊或不明确,你必须提示获取可用变更。
步骤
-
如果没有提供变更名称,提示选择运行获取按最近修改排序的可用变更。然后使用 AskUserQuestion tool 让用户选择要处理哪个变更。
openspec-cn list --json展示前 3-4 个最近修改的变更作为选项,显示:- 变更名称
- Schema(如果存在 字段,否则为 "spec-driven")
schema - 状态(例如:"0/5 tasks", "complete", "no tasks")
- 最近修改时间(来自 字段)
lastModified
将最近修改的变更标记为 "(推荐)",因为它很可能是用户想要继续的。重要提示:不要猜测或自动选择变更。始终让用户选择。 -
检查当前状态bash
openspec-cn status --change "<name>" --jsonParse the JSON to understand current state. The response includes:- : The workflow schema being used (e.g., "spec-driven")
schemaName - : Array of artifacts with their status ("done", "ready", "blocked")
artifacts - : Boolean indicating if all artifacts are complete
isComplete
-
根据状态行动:
如果所有产出物已完成 ():isComplete: true- 祝贺用户
- 显示最终状态,包括使用的 Schema
- 建议:"所有产出物已创建!您现在可以实现此变更或将其归档。"
- 停止
如果产出物准备好创建(状态显示有的产出物):status: "ready"- 从状态输出中选择第一个 的产出物
status: "ready" - 获取其指令:
bash
openspec-cn instructions <artifact-id> --change "<name>" --json - Parse the JSON. The key fields are:
- : Project background (constraints for you - do NOT include in output)
context - : Artifact-specific rules (constraints for you - do NOT include in output)
rules - : The structure to use for your output file
template - : Schema-specific guidance
instruction - : Where to write the artifact
outputPath - : Completed artifacts to read for context
dependencies
- Create the artifact file:
- Read any completed dependency files for context
- Use as the structure - fill in its sections
template - Apply and
contextas constraints when writing - but do NOT copy them into the filerules - Write to the output path specified in instructions
- Show what was created and what's now unlocked
- STOP after creating ONE artifact
如果没有产出物准备好(全部受阻):- 在有效的 Schema 下不应发生这种情况
- 显示状态并建议检查问题
-
创建产出物后,显示进度bash
openspec-cn status --change "<name>"
输出
每次调用后,显示:
- 创建了哪个产出物
- 正在使用的 Schema 工作流
- 当前进度(N/M 完成)
- 现在解锁了哪些产出物
- 提示:"想要继续吗?只需让我继续或告诉我下一步做什么。"
产出物创建指南
产出物类型及其用途取决于 Schema。使用指令输出中的 字段来了解要创建什么。
instruction常见的产出物模式:
spec-driven schema (proposal → specs → design → tasks):
- proposal.md: Ask user about the change if not clear. Fill in Why, What Changes, Capabilities, Impact.
- The Capabilities section is critical - each capability listed will need a spec file.
- specs/<capability>/spec.md: Create one spec per capability listed in the proposal's Capabilities section (use the capability name, not the change name).
- design.md: Document technical decisions, architecture, and implementation approach.
- tasks.md: Break down implementation into checkboxed tasks.
For other schemas, follow the field from the CLI output.
instructionGuardrails
- Create ONE artifact per invocation
- Always read dependency artifacts before creating a new one
- Never skip artifacts or create out of order
- If context is unclear, ask the user before creating
- Verify the artifact file exists after writing before marking progress
- Use the schema's artifact sequence, don't assume specific artifact names
- IMPORTANT: and
contextare constraints for YOU, not content for the filerules- Do NOT copy ,
<context>,<rules>blocks into the artifact<project_context> - These guide what you write, but should never appear in the output
- Do NOT copy
通过创建下一个产出物继续处理变更。
输入:可选指定变更名称。如果省略,检查是否可以从对话上下文中推断。如果模糊或不明确,你必须提示获取可用变更。
步骤
-
如果没有提供变更名称,提示选择运行获取按最近修改排序的可用变更。然后使用 AskUserQuestion tool 让用户选择要处理哪个变更。
openspec-cn list --json展示前 3-4 个最近修改的变更作为选项,显示:- 变更名称
- Schema(如果存在 字段,否则为 "spec-driven")
schema - 状态(例如:"0/5 tasks", "complete", "no tasks")
- 最近修改时间(来自 字段)
lastModified
将最近修改的变更标记为 "(推荐)",因为它很可能是用户想要继续的。重要提示:不要猜测或自动选择变更。始终让用户选择。 -
检查当前状态bash
openspec-cn status --change "<name>" --json解析该JSON以了解当前状态,响应包含:- :正在使用的工作流Schema(例如:"spec-driven")
schemaName - :包含各产出物及其状态的数组(状态可选值为"done"、"ready"、"blocked")
artifacts - :布尔值,标识所有产出物是否已全部完成
isComplete
-
根据状态行动:
如果所有产出物已完成 ():isComplete: true- 祝贺用户
- 显示最终状态,包括使用的 Schema
- 建议:"所有产出物已创建!您现在可以实现此变更或将其归档。"
- 停止
如果产出物准备好创建(状态显示有的产出物):status: "ready"- 从状态输出中选择第一个 的产出物
status: "ready" - 获取其指令:
bash
openspec-cn instructions <artifact-id> --change "<name>" --json
解析该JSON,核心字段如下:- :项目背景(仅作为你的约束,不要输出到最终文件中)
context - :对应产出物的专属规则(仅作为你的约束,不要输出到最终文件中)
rules - :输出文件使用的结构模板
template - :Schema专属指引
instruction - :产出物的写入路径
outputPath - :需要读取作为上下文的已完成产出物
dependencies - 创建产出物文件:
- 读取所有已完成的依赖文件作为上下文
- 使用作为结构——填充其各个部分
template - 编写内容时遵循和
context的约束,但不要将它们复制到文件中rules - 写入到指令中指定的输出路径
- 说明已创建的内容以及当前解锁的内容
- 创建一个产出物后立即停止
如果没有产出物准备好(全部受阻):- 在有效的 Schema 下不应发生这种情况
- 显示状态并建议检查问题
-
创建产出物后,显示进度bash
openspec-cn status --change "<name>"
输出
每次调用后,显示:
- 创建了哪个产出物
- 正在使用的 Schema 工作流
- 当前进度(N/M 完成)
- 现在解锁了哪些产出物
- 提示:"想要继续吗?只需让我继续或告诉我下一步做什么。"
产出物创建指南
产出物类型及其用途取决于 Schema。使用指令输出中的 字段来了解要创建什么。
instruction常见的产出物模式:
spec-driven schema (proposal → specs → design → tasks):
- proposal.md:如果变更内容不明确,先询问用户。填写原因、变更内容、能力项、影响范围。
- 能力项部分非常关键——列出的每个能力项都需要对应一个spec文件。
- specs/<capability>/spec.md:为proposal的能力项部分列出的每个能力项创建一个spec文件(使用能力项名称,而非变更名称)。
- design.md:记录技术决策、架构设计和实现方案。
- tasks.md:将实现工作拆解为可勾选的任务列表。
对于其他Schema,请遵循CLI输出中的字段说明。
instruction防护规则
- 每次调用仅创建一个产出物
- 创建新产出物前务必读取所有依赖的产出物
- 永远不要跳过产出物或乱序创建
- 如果上下文不明确,创建前先询问用户
- 标记进度前,需验证写入后的产出物文件确实存在
- 遵循Schema定义的产出物顺序,不要假设特定的产出物名称
- 重要提示:和
context是给你的约束,不是文件的内容rules- 不要将、
<context>、<rules>块复制到产出物中<project_context> - 这些是你编写内容的指引,但绝对不能出现在输出中
- 不要将