用途:把用户想构建或修复的内容快速转化为一套完整的规划产物。该工作流仅授权规划,不编辑项目代码;产物完成后即停止,等待用户新的请求再进入 apply 工作流。
主要能力:按 schema 生成 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么,属于增量而非主规格)、design.md(如何做)、tasks.md(实现步骤)。支持指定 --schema,或通过 openspec context --json 与 openspec schemas --json 查看可用工作流。已注册 store 时可用 openspec store list --json 发现 id,并在读写规格与变更的命令上加 --store "<id>"(选定后保持粘性)。
使用方式:输入变更名(kebab-case)或描述;先澄清会实质影响范围、外部可观察行为、兼容性或验收标准的歧义。用 openspec new change "<name>"(可加 --schema "<schema-name>")创建目录,再用 openspec status --change "<name>" --json 获取产物构建顺序与路径上下文。按依赖顺序对每个就绪产物运行 openspec instructions <artifact-id> --change "<name>" --json,读取已完成依赖文件后按 template 写入 resolvedOutputPath;若 instruction 委托给特定技能或命令,则调用它并确认文件存在。最后运行 openspec status --change "<name>" 汇总变更名与位置、已创建产物、跳过项及原因。
适用场景:需要快速产出供评审的变更规划、规格增量与任务分解时。
限制:不实现变更、不启动 apply、不编辑代码;context 与 rules 是约束,不应写入产物;status 仅反映文件是否存在,须按 requires 边构建必需集合;被标记 skipped 或说明为条件性的产物不要创建;同名变更已存在时先询问继续还是新建。原文未提供具体安装命令、收费、价格或平台信息。