AgentSkillsCN

openspec-continue-change

通过创建下一个产出物继续处理 OpenSpec 变更。当用户想要推进其变更、创建下一个产出物或继续其工作流程时使用。

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

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

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

步骤

  1. •

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

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

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

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

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

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

  2. •

    检查当前状态

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

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

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

    根据状态行动：

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

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

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

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

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

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

    创建产出物后，显示进度

    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：为提案“能力”部分列出的每个能力创建一个 spec（使用 capability 名称，而不是 change 名称）。
  • •design.md：记录技术决策、架构和实现方法。
  • •tasks.md：把实现拆分为带复选框的任务。

对于其他 schema，遵循 CLI 输出中的 instruction 字段。

护栏

  • •每次调用只创建一个产出物
  • •创建新产出物前，总是先阅读依赖产出物
  • •不要跳过产出物，也不要乱序创建
  • •如果上下文不清楚，创建前先询问用户
  • •写入后先确认产出物文件存在，再标记进度
  • •使用 schema 的产出物顺序，不要假设固定的产出物名称
  • •重要：context 和 rules 是对你的约束，不是文件内容
    • •不要把 <context>、<rules>、<project_context> 块复制进产出物
    • •它们用于指导你写作，但绝不能出现在输出中