# openspec-new-change

> 使用实验性的产出物工作流启动一个新的 OpenSpec 变更。当用户想要通过结构化的分步方法创建新功能、修复或修改时使用。

- Author: 穆文斌
- Repository: jamesMuWB/keepchat
- Version: 20260130100823
- Stars: 2
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/jamesMuWB/keepchat
- Web: https://mule.run/skillshub/@@jamesMuWB/keepchat~openspec-new-change:20260130100823

---

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

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

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

**步骤**

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

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

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

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

   **重要提示**：在不了解用户想要构建什么的情况下，请勿继续。

2. **确定工作流 Schema**

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

   **Use a different schema only if the user mentions:**
   - A specific schema name → use `--schema <name>`
   - "show workflows" or "what workflows" → run `openspec schemas --json` and let them choose

   **否则**：省略 `--schema` 以使用默认值。

3. **创建变更目录**

   ```bash
   openspec-cn new change "<name>"
   ```

   仅当用户请求特定工作流时才添加 `--schema <name>`。
   这将在 `openspec/changes/<name>/` 下使用所选 Schema 创建一个脚手架变更。

4. **显示产出物状态**

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

   这会显示哪些产出物需要创建，以及哪些已就绪（依赖项已满足）。

5. **Get instructions for the first artifact**
   The first artifact depends on the schema (e.g., `proposal` for spec-driven).
   Check the status output to find the first artifact with status "ready".

   ```bash
   openspec-cn instructions <first-artifact-id> --change "<name>"
   ```

   这会输出创建第一个产出物所需的模板和上下文。

6. **停止并等待用户指示**

**输出**

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

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

**护栏**

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