用途:当用户想快速描述要构建或修复的内容,并希望一步得到完整提案时使用。它会创建变更并生成实现所需的全部产物。
主要能力:生成 proposal.md(做什么与为什么)、design.md(怎么做)、tasks.md(实现步骤);通过 openspec 命令创建变更目录、查询产物构建顺序与状态,并按依赖顺序逐个生成产物。
使用方式:输入需包含 kebab-case 变更名或对要构建内容的描述;若输入不明确,会用 AskUserQuestion 询问“What change do you want to work on? Describe what you want to build or fix.”,并从描述推导名称(如 add user authentication → add-user-auth)。随后执行 openspec new change "<name>" 创建脚手架,执行 openspec status --change "<name>" --json 获取 applyRequires 与 artifacts,再对每个就绪产物执行 openspec instructions <artifact-id> --change "<name>" --json,读取 context、rules、template、instruction、outputPath、dependencies,读取已完成依赖文件后按 template 结构写入产物。每完成一个产物重新运行 status,直到 applyRequires 中所有产物状态为 done。最后运行 openspec status --change "<name>" 并汇总变更名、位置、产物列表,提示运行 /opsx:apply 或要求实现。
限制与注意:context 与 rules 是约束,不得复制进产物文件;不得在未理解用户意图时继续;若同名变更已存在,需询问继续还是新建;写入后需确认文件存在再继续。资料未提供收费、平台与效果信息。