SuperAPI AI 工具集

openspec-new-change

编程与开发

查看项目

更新于 10-22 09:57

技能介绍

用途

openspec-new-change 用于以一个 OpenSpec 变更为单位,启动结构化的工作流程。它采用实验性的“产物驱动”方式(artifact workflow),适合用户想要新建功能、修复缺陷或进行改动,并希望整个过程被拆解为有序产物时使用。

主要能力与流程

  1. 明确输入:用户的请求应包含一个 kebab-case 格式的变更名称,或者一段关于想要构建内容的描述。如果输入不清晰,需要通过开放式的 AskUserQuestion 工具询问:“What change do you want to work on? Describe what you want to build or fix.”(你想处理什么变更?描述你想构建或修复的内容。)技能会从描述中推导出 kebab-case 名称(例如 “add user authentication” → add-user-auth),在未理解用户意图前不会继续。

  2. 确定工作流 schema:默认省略 --schema,使用默认 schema。仅当用户明确提到具体 schema 名称时使用 --schema <name>;若用户说“show workflows”或“what workflows”,则运行 openspec schemas --json 让其选择。

  3. 创建变更目录:运行 openspec new change "<name>",在 openspec/changes/<name>/ 下按所选 schema 生成脚手架。

  4. 展示产物状态:运行 openspec status --change "<name>",显示需要创建哪些产物,以及哪些产物已就绪(依赖已满足)。

  5. 获取第一个产物的说明:第一个产物取决于 schema(例如 spec-driven 下为 proposal)。根据状态输出找到第一个状态为“ready”的产物,运行 openspec instructions <first-artifact-id> --change "<name>",输出创建该产物所需的模板与上下文。

  6. 暂停等待:展示第一个产物模板后停止,等待用户指示,不创建任何产物,也不继续推进。

输出内容

完成上述步骤后,需要汇总:变更名称与位置;所用 schema/工作流及其产物顺序;当前状态(0/N 个产物完成);第一个产物的模板;并提示:“Ready to create the first artifact? Just describe what this change is about and I'll draft it, or ask me to continue.”

限制与约束

  • 不创建任何产物,仅展示说明。
  • 不会推进到展示第一个产物模板之后。
  • 名称不符合 kebab-case 时要求提供有效名称。
  • 若同名变更已存在,建议继续该变更而非新建。
  • 使用非默认工作流时需传 --schema。
  • 关于该技能的收费、平台支持范围、具体效果等资料暂未提供。