openspec-ff-change

快速推进工件创建——一次性生成开始实施所需的一切。

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

步骤

1. 如果未提供清晰的输入，询问要构建什么

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

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

   根据描述派生 kebab-case 名称（例如 "add user authentication" → add-user-auth）。

   重要：在理解用户想构建什么之前不要继续。

2. 创建变更目录

   openspec new change "<name>"
   

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

3. 获取工件构建顺序

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

   解析 JSON 以获得：

   • applyRequires：实施前所需的工件 ID 数组（例如 ["tasks"]）
   • artifacts：所有工件及其状态和依赖

4. 按顺序创建工件，直到可实施

   使用 TodoWrite 工具 跟踪工件进度。

   按依赖顺序循环工件（先处理没有未满足依赖的工件）：

   a. 对每个处于 ready 的工件（依赖已满足）：

   • 获取说明：

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

   • 说明 JSON 包含：
     • template：要使用的模板内容
     • instruction：该工件类型的 schema 指导
     • outputPath：写入位置
     • dependencies：需要读取的已完成工件
   • 读取已完成依赖文件获取上下文
   • 按 schema 的 instruction 创建工件文件
   • 简短展示进度："✓ 已创建 <artifact-id>"

   b. 持续直到 applyRequires 全部完成

   • 每创建一个工件后，重新运行 openspec status --change "<name>" --json
   • 检查 applyRequires 中的每个工件 ID 在 artifacts 数组里是否为 status: "done"
   • 当所有 applyRequires 工件完成后停止

   c. 如果工件需要用户输入（上下文不清晰）：

   • 使用 AskUserQuestion 工具 澄清
   • 然后继续创建

5. 显示最终状态

   openspec status --change "<name>"
   

输出

完成所有工件后，总结：

• 变更名称与位置
• 已创建工件列表（简短描述）
• 当前就绪情况："所有工件已创建！可以开始实施。"
• 提示："运行 /opsx:apply 或让我开始实现来处理任务。"

工件创建指南

• 对每种工件类型遵循 openspec instructions 返回的 instruction
• schema 定义了每个工件应包含什么——遵循它
• 在创建新工件之前先读依赖工件
• 使用 template 作为起点，并根据上下文填充

护栏

• 创建实施所需的全部工件（由 schema 的 apply.requires 定义）
• 在创建新工件之前始终阅读依赖工件
• 如果上下文关键不清晰，询问用户——但尽量做出合理判断以保持进度
• 如果已存在同名变更，建议继续该变更
• 写入后确认工件文件存在再继续