快速创建实现所需的所有产出物。当用户想要快速创建实现所需的所有产出物,而不是逐个创建时使用。
快速完成产出物创建 - 一次性生成开始实现所需的一切。
输入:用户的请求应包含变更名称(kebab-case)或对他们想要构建内容的描述。
步骤
如果没有提供明确的输入,询问他们想要构建什么
使用 AskUserQuestion tool(开放式,无预设选项)询问:
"您想要处理什么变更?请描述您想要构建或修复的内容。"
根据他们的描述,推导出一个 kebab-case 名称(例如:"add user authentication" → add-user-auth)。
重要提示:在不了解用户想要构建什么的情况下,请勿继续。
创建变更目录
openspec-cn new change "<name>"
这将在 openspec/changes/<name>/ 创建一个脚手架变更。
获取产出物构建顺序
openspec-cn status --change "<name>" --json
解析 JSON 以获取:
applyRequires: 实现前所需的产出物 ID 数组(例如:["tasks"])artifacts: 所有产出物及其状态和依赖项的列表按顺序创建产出物直到准备好应用
使用 TodoWrite tool 跟踪产出物的进度。
按依赖顺序循环遍历产出物(没有待处理依赖项的产出物优先):
a. 对于每个 ready(依赖项已满足)的产出物:
openspec-cn instructions <artifact-id> --change "<name>" --json
context:项目背景(对你的约束 - 不要包含在输出中)rules:产出物特定规则(对你的约束 - 不要包含在输出中)template:用于输出文件的结构instruction:此产出物类型的模式特定指导outputPath:写入产出物的位置dependencies:已完成的产出物,用于读取上下文template 作为结构创建产出物文件context 和 rules 作为约束 - 但不要将它们复制到文件中b. 继续直到所有 applyRequires 产出物完成
openspec-cn status --change "<name>" --jsonapplyRequires 中的每个产出物 ID 在 artifacts 数组中是否具有 status: "done"applyRequires 产出物完成时停止c. 如果产出物需要用户输入(上下文不清楚):
显示最终状态
openspec-cn status --change "<name>"
输出
完成所有产出物后,总结:
/opsx:apply 或要求我实现以开始处理任务。"产出物创建指南
openspec-cn instructions 中的 instruction 字段template 作为输出文件的结构 - 填充其各个部分context 和 rules 是对你的约束,而不是文件内容
<context>、<rules>、<project_context> 块复制到产出物中护栏
apply.requires 定义)