SuperAPI AI 工具集

openspec-new-change

办公与效率

查看项目

更新于 10-16 08:01

技能介绍

用途:以实验性的工件驱动方式启动一个 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 <name>;若用户提到“show workflows”或“what workflows”,运行 openspec schemas --json 让其选择。
  3. 创建变更目录:openspec new change "<name>"(仅在用户指定工作流时加 --schema <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)时请求有效名称;同名变更已存在时建议继续该变更。其他细节(平台、收费、价格等)暂未提供。