txyzznc 提案新变更——一步创建变更并生成所有 artifact。
我会创建包含以下 artifact 的变更：
- proposal.md（内容和原因）
- design.md（如何实现）
- tasks.md（实现步骤）
准备好实现时，运行 /opsx:apply
输入：用户的请求应包含变更名称（kebab-case）或对他们想要构建内容的描述。
步骤
若未提供明确输入，询问要构建什么
使用 AskUserQuestion 工具（开放式，无预设选项）提问：
"您想处理什么变更？描述您想构建或修复的内容。"
从他们的描述中推导出 kebab-case 名称（例如"添加用户认证" →
add-user-auth）。重要：在不了解用户想构建什么的情况下，不要继续。
创建变更目录
openspec new change "<name>"这会在
openspec/changes/<name>/创建带有.openspec.yaml的脚手架变更。获取 artifact 构建顺序
openspec status --change "<name>" --json解析 JSON 以获取：
applyRequires：实现前所需的 artifact ID 数组（例如["tasks"]）artifacts：所有 artifact 的列表，包含状态和依赖关系
按顺序创建 artifact 直到可以应用
使用 TodoWrite 工具跟踪 artifact 的处理进度。
按依赖顺序循环处理 artifact（无待处理依赖的 artifact 优先）：
a. 对每个
ready状态（依赖已满足）的 artifact：- 获取指令：
openspec instructions <artifact-id> --change "<name>" --json - 指令 JSON 包含：
context：项目背景（对您的约束——不要包含在输出中）rules：特定 artifact 的规则（对您的约束——不要包含在输出中）template：输出文件使用的结构instruction：针对此 artifact 类型的 schema 特定指导outputPath：artifact 的写入路径dependencies：需要读取的已完成 artifact
- 读取所有已完成的依赖文件以获取上下文
- 使用
template作为结构创建 artifact 文件 - 将
context和rules作为约束——不要将其复制到文件中 - 显示简短进度："已创建 "
b. 继续直到所有
applyRequires中的 artifact 完成- 每次创建 artifact 后重新运行
openspec status --change "<name>" --json - 检查
applyRequires中的每个 artifact ID 是否在 artifacts 数组中有status: "done" - 所有
applyRequiresartifact 完成后停止
c. 若 artifact 需要用户输入（上下文不明确）：
- 使用 AskUserQuestion 工具澄清
- 然后继续创建
- 获取指令：
显示最终状态
openspec status --change "<name>"
输出
完成所有 artifact 后，总结：
- 变更名称和位置
- 已创建的 artifact 列表及简短描述
- 就绪内容："所有 artifact 已创建！可以开始实现了。"
- 提示："运行
/opsx:apply或让我实现，开始处理任务。"
Artifact 创建指南
- 遵循每种 artifact 类型的
openspec instructions中的instruction字段 - Schema 定义了每个 artifact 应包含什么——遵循它
- 创建新 artifact 前读取依赖 artifact 以获取上下文
- 使用
template作为输出文件的结构——填写各节内容 - 重要：
context和rules是对您的约束，不是文件内容- 不要将
<context>、<rules>、<project_context>块复制到 artifact 中 - 这些指导您写什么，但绝不应出现在输出中
- 不要将
注意事项
- 创建实现所需的所有 artifact（由 schema 的
apply.requires定义） - 创建新 artifact 前始终读取依赖 artifact
- 若上下文极不明确，询问用户——但倾向于做出合理决策以保持推进势头
- 若该名称的变更已存在，询问用户是继续还是创建新的
- 写入后验证每个 artifact 文件存在再继续下一个