用途:在 OpenSpec 工作流中快速提出一个新变更,并在一步内生成实施所需的全部产物。适用于用户希望快速描述要构建的内容并获得完整提案的场景。
主要能力:根据变更名称(kebab-case)或需求描述创建变更目录,生成 proposal.md(做什么与为什么)、design.md(如何实现)、tasks.md(实施步骤),并可在产物齐备后进入实施阶段。
使用方式:若输入不明确,先询问用户想构建或修复什么,再从描述中推导 kebab-case 名称,例如 "add user authentication" 对应 add-user-auth;不要在未理解需求前继续。随后创建变更目录:openspec new change "<name>",该命令在 openspec/changes/<name>/ 下生成带 .openspec.yaml 的脚手架。接着获取产物构建顺序:openspec status --change "<name>" --json,解析其中的 applyRequires(实施前需要的产物 ID,如 ["tasks"])和 artifacts(全部产物及状态与依赖)。按依赖顺序逐个创建产物,可用 TodoWrite 跟踪进度:对每个依赖已满足的产物,先获取指令 openspec instructions <artifact-id> --change "<name>" --json,其中包含 context、rules、template、instruction、outputPath、dependencies;阅读已完成的依赖产物作为上下文,按 template 结构写入产物文件,将 context 与 rules 作为约束而非复制进文件;每创建一个产物后重新运行状态命令,直到 applyRequires 中所有产物状态为 done。若某产物缺少上下文,用提问工具澄清。最后运行 openspec status --change "<name>" 展示最终状态,并汇总变更名称与位置、已创建产物及简要说明,提示可运行 /opsx:apply 或要求实施以开始任务。
限制:必须创建实施所需的全部产物并逐个验证文件存在;新建产物前务必阅读依赖产物;context、rules、project_context 等块是给执行者的约束,不得写入产物输出。若同名变更已存在,需询问用户继续还是新建。官方页面未提供收费、价格或平台信息。