openspec-ff-change

快速完成产出物创建 – 一次性生成开始实现所需的一切。

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

步骤

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

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

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

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

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

2. 创建变更目录

   openspec-cn new change "<name>"
   

   这将在 openspec/changes/<name>/ 创建一个脚手架变更。

3. 获取产出物构建顺序

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

   解析 JSON 以获取：

   • applyRequires: 实现前所需的产出物 ID 数组（例如：["tasks"]）
   • artifacts: 所有产出物及其状态和依赖项的列表

4. 按顺序创建产出物直到准备好应用

   使用 TodoWrite tool 跟踪产出物的进度。

   按依赖顺序循环遍历产出物（没有待处理依赖项的产出物优先）：

   a. 对于每个 ready（依赖项已满足）的产出物：

   • 获取指令：

     openspec-cn instructions <artifact-id> --change "<name>" --json
     

   • The instructions JSON includes:
     • context: Project background (constraints for you – do NOT include in output)
     • rules: Artifact-specific rules (constraints for you – do NOT include in output)
     • template: The structure to use for your output file
     • instruction: Schema-specific guidance for this artifact type
     • outputPath: Where to write the artifact
     • dependencies: Completed artifacts to read for context
   • Read any completed dependency files for context
   • Create the artifact file using template as the structure
   • Apply context and rules as constraints – but do NOT copy them into the file
   • Show brief progress: “✓ Created “

   b. 继续直到所有 applyRequires 产出物完成

   • 创建每个产出物后，重新运行 openspec-cn status --change "<name>" --json
   • 检查 applyRequires 中的每个产出物 ID 在 artifacts 数组中是否具有 status: "done"
   • 当所有 applyRequires 产出物完成时停止

   c. 如果产出物需要用户输入（上下文不清楚）：

   • 使用 AskUserQuestion tool 进行澄清
   • 然后继续创建

5. 显示最终状态

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

输出

完成所有产出物后，总结：

• 变更名称和位置
• 已创建产出物的列表及简要描述
• 准备就绪：”所有产出物已创建！准备好实现。”
• 提示：”运行 /opsx:apply 或要求我实现以开始处理任务。”

产出物创建指南

• Follow the instruction field from openspec instructions for each artifact type
• The schema defines what each artifact should contain – follow it
• Read dependency artifacts for context before creating new ones
• Use template as the structure for your output file – fill in its sections
• IMPORTANT: context and rules are constraints for YOU, not content for the file
  • Do NOT copy <context>, <rules>, <project_context> blocks into the artifact
  • These guide what you write, but should never appear in the output

护栏

• 创建实现所需的所有产出物（由 Schema 的 apply.requires 定义）
• 在创建新产出物之前始终阅读依赖产出物
• 如果上下文极其不清楚，询问用户 – 但倾向于做出合理的决定以保持势头
• 如果同名变更已存在，建议继续处理该变更
• 在继续下一个之前，验证写入后每个产出物文件是否存在