SuperAPI AI 工具集

openspec-new-change

编程与开发

查看项目

更新于 10-15 22:38

技能介绍

用途:以实验性工件驱动方式启动一个新的 OpenSpec 变更,适用于用户想创建新功能、修复或修改,并希望采用结构化流程的场景。

主要能力与用法:

  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 <name>;用户说“show workflows”或“what workflows”时运行 openspec schemas --json 让其选择。
  3. 创建变更目录:openspec new change "<name>",仅在用户要求特定工作流时加 --schema <name>。
  4. 查看工件状态:openspec status --change "<name>" --json,使用返回的 planningHome、changeRoot、artifactPaths、nextSteps,不要假设仓库本地路径。
  5. 获取首个工件说明:首个工件取决于 schema(如 spec-driven 的 proposal),从状态输出找状态为 ready 的首个工件,运行 openspec instructions <first-artifact-id> --change "<name>",输出模板与上下文。
  6. 停止并等待用户指示。

Store 选择:若用户指定 store(本机注册的独立 OpenSpec 仓库)或工作位于其中,先运行 openspec store list --json 发现已注册 store id,再在读写 specs 与 changes 的命令(new change、status、instructions、list、show、validate、archive、doctor、context)上传 --store <id>;其他命令不接受该标志。命令打印的提示已带该标志,后续命令需保留。无 store 时,命令作用于最近的本地 openspec/ 根目录。

输出:完成后总结变更名与位置、所用 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。