SuperAPI AI 工具集

openspec-ff-change

编程与开发

查看项目

更新于 10-22 10:57

技能介绍

用途 该技能用于在 OpenSpec 工作流中“快进”工件创建过程,目标是先生成实现所需的一切工件,再进入编码阶段。适用于用户希望快速创建实现所需的全部工件、而不想逐步走流程的场景。

主要能力

  • 根据用户请求推导 kebab-case 变更名称(如“add user authentication”转为 add-user-auth)。
  • 创建脚手架化的变更目录:openspec new change "<name>",生成于 openspec/changes/<name>/。
  • 通过 openspec status --change "<name>" --json 获取 applyRequires(实现前所需工件 ID 列表)以及全部工件及其状态、依赖。
  • 按依赖顺序逐个创建工件:先处理无待完成依赖的工件;对每个就绪工件执行 openspec instructions <artifact-id> --change "<name>" --json,获取 context、rules、template、instruction、outputPath、dependencies 等信息。
  • 读取已完成的依赖工件作为上下文,按 template 结构写入工件文件,并以 context 和 rules 作为约束(不写入输出文件)。
  • 使用 TodoWrite 跟踪工件创建进度,并以“✓ Created ”形式显示简短进度。
  • 每创建一个工件后重新运行状态查询,检查 applyRequires 中所有工件是否均为 done,达到后停止。
  • 若某工件上下文不清晰,使用 AskUserQuestion 工具向用户澄清后继续。
  • 最后显示最终状态并汇总变更名称与位置、已创建工件及简述,提示“All artifacts created! Ready for implementation.”,并建议运行 /opsx-apply 或请求实现。

使用方式 用户请求应包含变更名称(kebab-case)或对想构建内容的描述;若未提供清晰输入,技能会用无预设选项的开放问题询问“What change do you want to work on? Describe what you want to build or fix.”,并从描述推导名称。之后技能自动执行上述命令序列。工件创建时遵循 openspec instructions 返回的 instruction 字段与 schema 定义,使用 template 作为输出文件结构并填充各节;context、rules、project_context 等块仅作为写作约束,不得复制进工件文件。若同名变更已存在,建议继续该变更而非新建。

适用场景 适用于已在 OpenSpec 流程中、需要快速产出一组完整实现前工件的开发任务,例如从一句需求描述直接生成任务清单等开始实现所需材料。

限制

  • 若缺少清晰输入且用户未回应澄清问题,不应继续。
  • 每次创建工件前必须先读取依赖工件。
  • 需确保每个工件文件写入成功后,再进入下一个工件。
  • 对上下文严重不清的情况应询问用户,但整体倾向于做出合理决定以保持推进节奏。
  • 其他细节(如具体支持的 OpenSpec 版本、安装方式、收费情况)暂未提供。