openspec-ff-change

快速完成产出物创建 - 一次性生成开始实现所需的一切。 **输入**：用户的请求应包含变更名称（kebab-case）或对他们想要构建内容的描述。 **步骤** 1. **如果没有提供明确的输入，询问他们想要构建什么** 使用 **AskUserQuestion tool**（开放式，无预设选项）询问： > "您想要处理什么变更？请描述您想要构建或修复的内容。" 根据他们的描述，推导出一个 kebab-case 名称（例如："add user authentication" → `add-user-auth`）。 **重要提示**：在不了解用户想要构建什么的情况下，请勿继续。 2. **创建变更目录** ```bash openspec-cn new change "<name>" ``` 这将在 `openspec/changes/<name>/` 创建一个脚手架变更。 3. **获取产出物构建顺序** ```bash openspec-cn status --change "<name>" --json ``` 解析 JSON 以获取： - `applyRequires`: 实现前所需的产出物 ID 数组（例如：`["tasks"]`） - `artifacts`: 所有产出物及其状态和依赖项的列表 4. **按顺序创建产出物直到准备好应用** 使用 **TodoWrite tool** 跟踪产出物的进度。 按依赖顺序循环遍历产出物（没有待处理依赖项的产出物优先）： a. **对于每个 `ready`（依赖项已满足）的产出物**： - 获取指令： ```bash openspec-cn instructions <artifact-id> --change "<name>" --json ``` - 指令 JSON 包括： - `context`：项目背景（对你的约束 - 不要包含在输出中） - `rules`：产出物特定规则（对你的约束 - 不要包含在输出中） - `template`：用于输出文件的结构 - `instruction`：此产出物类型的模式特定指导 - `outputPath`：写入产出物的位置 - `dependencies`：已完成的产出物，用于读取上下文 - 读取任何已完成的依赖文件以获取上下文 - 使用 `template` 作为结构创建产出物文件 - 应用 `context` 和 `rules` 作为约束 - 但不要将它们复制到文件中 - 显示简短进度："✓ 已创建 <artifact-id>" b. **继续直到所有 `applyRequires` 产出物完成** - 创建每个产出物后，重新运行 `openspec-cn status --change "<name>" --json` - 检查 `applyRequires` 中的每个产出物 ID 在 artifacts 数组中是否具有 `status: "done"` - 当所有 `applyRequires` 产出物完成时停止 c. **如果产出物需要用户输入**（上下文不清楚）： - 使用 **AskUserQuestion tool** 进行澄清 - 然后继续创建 5. **显示最终状态** ```bash openspec-cn status --change "<name>" ``` **输出** 完成所有产出物后，总结： - 变更名称和位置 - 已创建产出物的列表及简要描述 - 准备就绪："所有产出物已创建！准备好实现。" - 提示："运行 `/opsx:apply` 或要求我实现以开始处理任务。" **产出物创建指南** - 遵循每个产出物类型的 `openspec-cn instructions` 中的 `instruction` 字段 - 模式定义了每个产出物应包含的内容 - 遵循它 - 在创建新产出物之前阅读依赖产出物以获取上下文 - 使用 `template` 作为输出文件的结构 - 填充其各个部分 - **重要提示**：`context` 和 `rules` 是对你的约束，而不是文件内容 - 不要将 `<context>`、`<rules>`、`<project_context>` 块复制到产出物中 - 这些引导你编写内容，但不应出现在输出中 **护栏** - 创建实现所需的所有产出物（由 Schema 的 `apply.requires` 定义） - 在创建新产出物之前始终阅读依赖产出物 - 如果上下文极其不清楚，询问用户 - 但倾向于做出合理的决定以保持势头 - 如果同名变更已存在，建议继续处理该变更 - 在继续下一个之前，验证写入后每个产出物文件是否存在