openspec-new-change

使用实验性的、以构件为驱动的方法启动一项新变更。

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

步骤

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

   使用 AskUserQuestion 工具（开放式提问，不预设选项）询问：

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

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

   重要：在弄清楚用户想要构建什么之前，切勿继续。

2. 确定工作流架构

   使用默认架构（省略 --schema），除非用户明确要求使用其他工作流。

   仅在用户提到以下内容时使用不同的架构：

   • “tdd”或“test-driven” → 使用 --schema tdd
   • 特定架构名称 → 使用 --schema <name>
   • “show workflows”或“what workflows” → 运行 openspec schemas --json，让他们选择

   其他情况：省略 --schema，使用默认架构。

3. 创建变更目录

   openspec new change "<name>"
   

   仅当用户要求特定工作流时，才添加 --schema <name>。 这会使用选定的架构，在 openspec/changes/<name>/ 创建一个脚手架变更。

4. 显示构件状态

   openspec status --change "<name>"
   

   这会显示哪些构件需要创建，哪些已就绪（依赖项已满足）。

5. 获取第一个构件的说明 第一个构件取决于架构（例如，规范驱动流程使用 proposal，tdd 使用 spec）。 查看状态输出，找到第一个状态为“ready”的构件。

   openspec instructions <first-artifact-id> --change "<name>"
   

   这会输出用于创建第一个构件的模板和上下文。

6. 停止并等待用户指示

输出

完成这些步骤后，总结以下内容：

• 变更名称和位置
• 正在使用的架构/工作流及其构件顺序
• 当前状态（已完成 0/N 个构件）
• 第一个构件的模板
• 提示：“准备好创建第一个构件了吗？只需描述这项变更的内容，我就会起草；也可以让我继续。”

防护规则

• 尚未创建任何构件——只显示说明
• 不要超出显示第一个构件模板这一步
• 如果名称无效（不是 kebab-case），请用户提供有效名称
• 如果已存在同名变更，建议继续该变更
• 使用非默认工作流时传入 --schema