使用实验性的产出物工作流启动一个新的 OpenSpec 变更。当用户想要通过结构化的分步方法创建新功能、修复或修改时使用。
使用实验性的产出物驱动方法启动新变更。
输入:用户的请求应当包含变更名称(kebab-case)或对想要构建内容的描述。
步骤
如果没有提供明确的输入,询问用户想要构建什么
使用 AskUserQuestion Tool(开放式,无预设选项)询问:
"您想要处理什么变更?请描述您想要构建或修复的内容。"
根据他们的描述,推导出一个 kebab-case 名称(例如:"add user authentication" → add-user-auth)。
重要提示:在不了解用户想要构建什么的情况下,请勿继续。
确定工作流 Schema
除非用户明确要求不同的工作流,否则使用默认 Schema(省略 --schema)。
Use a different schema only if the user mentions:
--schema <name>openspec schemas --json and let them choose否则:省略 --schema 以使用默认值。
创建变更目录
openspec-cn new change "<name>"
仅当用户请求特定工作流时才添加 --schema <name>。
这将在 openspec/changes/<name>/ 下使用所选 Schema 创建一个脚手架变更。
显示产出物状态
openspec-cn status --change "<name>"
这会显示哪些产出物需要创建,以及哪些已就绪(依赖项已满足)。
Get instructions for the first artifact
The first artifact depends on the schema (e.g., proposal for spec-driven).
Check the status output to find the first artifact with status "ready".
openspec-cn instructions <first-artifact-id> --change "<name>"
这会输出创建第一个产出物所需的模板和上下文。
停止并等待用户指示
输出
完成上述步骤后,进行总结:
护栏