en un clic
openspec-new-change
// 使用实验性的产出物工作流启动一个新的 OpenSpec 变更。当用户想要通过结构化的分步方法创建新功能、修复或修改时使用。
// 使用实验性的产出物工作流启动一个新的 OpenSpec 变更。当用户想要通过结构化的分步方法创建新功能、修复或修改时使用。
实现 OpenSpec 变更中的任务。当用户想要开始实现、继续实现或处理任务时使用。
归档实验性工作流中已完成的变更。当用户想要在实现完成后最终确定并归档变更时使用。
一次归档多个已完成的变更。用于归档多个并行变更。
通过创建下一个产出物继续处理 OpenSpec 变更。当用户想要推进其变更、创建下一个产出物或继续其工作流程时使用。
进入探索模式 - 一个用于探索想法、调查问题和澄清需求的思考伙伴。当用户想要在进行更改之前或期间深入思考某事时使用。
快速创建实现所需的所有产出物。当用户想要快速创建实现所需的所有产出物,而不是逐个创建时使用。
| name | openspec-new-change |
| description | 使用实验性的产出物工作流启动一个新的 OpenSpec 变更。当用户想要通过结构化的分步方法创建新功能、修复或修改时使用。 |
| license | MIT |
| compatibility | 需要 openspec CLI。 |
| metadata | {"author":"openspec","version":"1.0","generatedBy":"1.1.1-1"} |
使用实验性的产出物驱动方法启动新变更。
输入:用户的请求应当包含变更名称(kebab-case)或对想要构建内容的描述。
步骤
如果没有提供明确的输入,询问用户想要构建什么
使用 AskUserQuestion Tool(开放式,无预设选项)询问:
"您想要处理什么变更?请描述您想要构建或修复的内容。"
根据他们的描述,推导出一个 kebab-case 名称(例如:"add user authentication" → add-user-auth)。
重要提示:在不了解用户想要构建什么的情况下,请勿继续。
确定工作流 Schema
除非用户明确要求不同的工作流,否则使用默认 Schema(省略 --schema)。
仅当用户提到以下内容时才使用不同的模式:
--schema <name>openspec-cn schemas --json 并让他们选择否则:省略 --schema 以使用默认值。
创建变更目录
openspec-cn new change "<name>"
仅当用户请求特定工作流时才添加 --schema <name>。
这将在 openspec/changes/<name>/ 下使用所选 Schema 创建一个脚手架变更。
显示产出物状态
openspec-cn status --change "<name>"
这会显示哪些产出物需要创建,以及哪些已就绪(依赖项已满足)。
获取第一个产出物的指令
第一个产出物取决于所使用的 schema(例如:spec-driven 通常先生成 proposal)。
检查 status 输出,找到第一个状态为 "ready" 的产出物。
openspec-cn instructions <first-artifact-id> --change "<name>"
这会输出创建第一个产出物所需的模板和上下文。
停止并等待用户指示
输出
完成上述步骤后,进行总结:
护栏