openspec-continue-change

name	openspec-continue-change
description	通过创建下一个产出物继续处理 OpenSpec 变更。当用户想要推进其变更、创建下一个产出物或继续其工作流程时使用。
license	MIT
compatibility	需要 openspec CLI。
metadata	{"author":"openspec","version":"1.0","generatedBy":"1.1.1-1"}

通过创建下一个产出物继续处理变更。

输入：可选指定变更名称。如果省略，检查是否可以从对话上下文中推断。如果模糊或不明确，你必须提示获取可用变更。

步骤

1. 如果没有提供变更名称，提示选择

   运行 openspec-cn list --json 获取按最近修改排序的可用变更。然后使用 AskUserQuestion tool 让用户选择要处理哪个变更。

   展示前 3-4 个最近修改的变更作为选项，显示：

   • 变更名称
   • Schema（如果存在 schema 字段，否则为 "spec-driven"）
   • 状态（例如："0/5 tasks", "complete", "no tasks"）
   • 最近修改时间（来自 lastModified 字段）

   将最近修改的变更标记为 "(推荐)"，因为它很可能是用户想要继续的。

   重要提示：不要猜测或自动选择变更。始终让用户选择。

2. 检查当前状态

   openspec-cn status --change "<name>" --json
   

   解析 JSON 以了解当前状态。响应包括：

   • schemaName：正在使用的工作流 schema（例如："spec-driven"）
   • artifacts：产出物数组及其状态（"done"、"ready"、"blocked"）
   • isComplete：布尔值，表示是否所有产出物都已完成

3. 根据状态行动：

   ---

   如果所有产出物已完成 (isComplete: true)：

   • 祝贺用户
   • 显示最终状态，包括使用的 Schema
   • 建议："所有产出物已创建！您现在可以实现此变更或将其归档。"
   • 停止

   ---

   如果产出物准备好创建（状态显示有 status: "ready" 的产出物）：

   • 从状态输出中选择第一个 status: "ready" 的产出物
   • 获取其指令：

     openspec-cn instructions <artifact-id> --change "<name>" --json
     

   • 解析 JSON。关键字段包括：
     • context：项目背景（对你的约束 - 不要包含在输出中）
     • rules：产出物特定规则（对你的约束 - 不要包含在输出中）
     • template：输出文件使用的结构
     • instruction：schema 特定指导
     • outputPath：产出物写入路径
     • dependencies：已完成的依赖产出物（用于读取上下文）
   • 创建产出物文件：
     • 阅读任何已完成的依赖文件以获取上下文
     • 使用 template 作为结构 - 填充各个章节
     • 在编写时将 context 和 rules 作为约束 - 但不要把它们复制进文件
     • 写入指令中指定的 outputPath
   • 展示创建了什么，以及现在解锁了什么
   • 创建一个产出物后停止

   ---

   如果没有产出物准备好（全部受阻）：

   • 在有效的 Schema 下不应发生这种情况
   • 显示状态并建议检查问题

4. 创建产出物后，显示进度

   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> 块复制进产出物
  • 它们用于指导你写作，但绝不能出现在输出中