Name: Openspec New Change
Author: studyzy

name	openspec-new-change
description	使用实验性的产出物工作流启动一个新的 OpenSpec 变更。当用户想要通过结构化的分步方法创建新功能、修复或修改时使用。
license	MIT
compatibility	需要 openspec CLI。
metadata	{"author":"openspec","version":"1.0","generatedBy":"1.1.1-1"}

使用实验性的产出物驱动方法启动新变更。

输入：用户的请求应当包含变更名称（kebab-case）或对想要构建内容的描述。

步骤

如果没有提供明确的输入，询问用户想要构建什么

使用 AskUserQuestion Tool（开放式，无预设选项）询问：

"您想要处理什么变更？请描述您想要构建或修复的内容。"

根据他们的描述，推导出一个 kebab-case 名称（例如："add user authentication" → add-user-auth）。

重要提示：在不了解用户想要构建什么的情况下，请勿继续。
确定工作流 Schema

除非用户明确要求不同的工作流，否则使用默认 Schema（省略 --schema）。

仅当用户提到以下内容时才使用不同的模式：
- 特定模式名称 → 使用 --schema <name>
- "显示工作流" 或 "有哪些工作流" → 运行 openspec-cn schemas --json 并让他们选择
否则：省略 --schema 以使用默认值。
创建变更目录
```
openspec-cn new change "<name>"
```
仅当用户请求特定工作流时才添加 --schema <name>。这将在 openspec/changes/<name>/ 下使用所选 Schema 创建一个脚手架变更。
显示产出物状态
```
openspec-cn status --change "<name>"
```
这会显示哪些产出物需要创建，以及哪些已就绪（依赖项已满足）。
获取第一个产出物的指令 第一个产出物取决于所使用的 schema（例如：spec-driven 通常先生成 proposal）。检查 status 输出，找到第一个状态为 "ready" 的产出物。
```
openspec-cn instructions <first-artifact-id> --change "<name>"
```
这会输出创建第一个产出物所需的模板和上下文。
停止并等待用户指示

输出

完成上述步骤后，进行总结：

变更名称和位置
正在使用的 Schema/工作流及其产出物顺序
当前状态（0/N 个产出物已完成）
第一个产出物的模板
提示："准备好创建第一个产出物了吗？请描述此变更的内容，我将为您起草，或者要求我继续。"

护栏

不要立即创建任何产出物 —— 仅显示指令
不要跳过显示第一个产出物模板的步骤
如果名称无效（非 kebab-case），请求有效的名称
如果同名变更已存在，建议继续处理该变更
如果使用非默认工作流，请传递 --schema

name	openspec-new-change
description	使用实验性的产出物工作流启动一个新的 OpenSpec 变更。当用户想要通过结构化的分步方法创建新功能、修复或修改时使用。
license	MIT
compatibility	需要 openspec CLI。
metadata	{"author":"openspec","version":"1.0","generatedBy":"1.1.1-1"}

使用实验性的产出物驱动方法启动新变更。

输入：用户的请求应当包含变更名称（kebab-case）或对想要构建内容的描述。

步骤

如果没有提供明确的输入，询问用户想要构建什么

使用 AskUserQuestion Tool（开放式，无预设选项）询问：

"您想要处理什么变更？请描述您想要构建或修复的内容。"

根据他们的描述，推导出一个 kebab-case 名称（例如："add user authentication" → add-user-auth）。

重要提示：在不了解用户想要构建什么的情况下，请勿继续。
确定工作流 Schema

除非用户明确要求不同的工作流，否则使用默认 Schema（省略 --schema）。

仅当用户提到以下内容时才使用不同的模式：
- 特定模式名称 → 使用 --schema <name>
- "显示工作流" 或 "有哪些工作流" → 运行 openspec-cn schemas --json 并让他们选择
否则：省略 --schema 以使用默认值。
创建变更目录
```
openspec-cn new change "<name>"
```
仅当用户请求特定工作流时才添加 --schema <name>。这将在 openspec/changes/<name>/ 下使用所选 Schema 创建一个脚手架变更。
显示产出物状态
```
openspec-cn status --change "<name>"
```
这会显示哪些产出物需要创建，以及哪些已就绪（依赖项已满足）。
获取第一个产出物的指令 第一个产出物取决于所使用的 schema（例如：spec-driven 通常先生成 proposal）。检查 status 输出，找到第一个状态为 "ready" 的产出物。
```
openspec-cn instructions <first-artifact-id> --change "<name>"
```
这会输出创建第一个产出物所需的模板和上下文。
停止并等待用户指示

输出

完成上述步骤后，进行总结：

变更名称和位置
正在使用的 Schema/工作流及其产出物顺序
当前状态（0/N 个产出物已完成）
第一个产出物的模板
提示："准备好创建第一个产出物了吗？请描述此变更的内容，我将为您起草，或者要求我继续。"

护栏

不要立即创建任何产出物 —— 仅显示指令
不要跳过显示第一个产出物模板的步骤
如果名称无效（非 kebab-case），请求有效的名称
如果同名变更已存在，建议继续处理该变更
如果使用非默认工作流，请传递 --schema

openspec-new-change