用途:在 OpenSpec 中为一个新变更生成完整规划产物。用户给出 kebab-case 变更名或想构建/修复的内容描述后,本工作流创建变更目录并逐一生成 schema 定义的产物;默认 spec-driven schema 产出 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么,为增量而非主 spec)、design.md(怎么做)、tasks.md(实施步骤)。
主要能力与用法:用 openspec new change "<name>" 创建变更脚手架,可加 --schema "<schema-name>";用 openspec status --change "<name>" --json 获取 applyRequires、artifacts 及其依赖 edges、路径与作用域上下文;按依赖顺序用 openspec instructions <artifact-id> --change "<name>" --json 取模板与规则,写入 resolvedOutputPath,并反复 status 检查直到必需产物齐全。若指定了注册的 store,用 openspec store list --json 查 id,并在能读写规格与变更的命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)追加 --store "<id>",选定后保持粘性;未指定则在最近的本地 openspec/ 根上操作。探索可用 schema 时,用 openspec context --json(必要时带 --store)取 root.path,在该目录运行 openspec schemas --json(该命令不接受 --store)。
限制:仅规划,禁止改代码或开始 apply;上下文与规则是约束,不写入产物文件;每步须重新从磁盘读取依赖文件;材料性歧义须先询问;同名变更已存在时先询问继续还是新建。实施需用户再次请求并显式启动 apply 工作流(Codex 为 $openspec-apply-change,其他代理为 /openspec-apply-change)。