用途:openspec-propose 是 OpenSpec 的规划类工作流技能,用于把用户想构建或修复的内容,一次性转化为完整的变更提案与规划产物。它只负责规划,不修改项目代码;即使用户请求中包含实施意图,该请求也只授权规划,产物完成后应停止并等待用户新的请求再进入 apply 工作流。
主要能力:按所选 schema 生成产物。默认 spec-driven schema 包含 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么,是增量而非主规格)、design.md(怎么做)、tasks.md(实施步骤)。capability-path 是相对 specs/ 的目录路径,需保留已有能力的完整路径。
使用方式:输入需包含 kebab-case 变更名或需求描述,否则先向用户询问。创建变更目录:openspec new change "<name>",指定 schema 时加 --schema "<schema-name>"。用 openspec status --change "<name>" --json 获取 applyRequires、artifacts 及其 requires 依赖边、planningHome、changeRoot、artifactPaths 等。按依赖顺序逐个用 openspec instructions <artifact-id> --change "<name>" --json 获取 context、rules、template、instruction、resolvedOutputPath、dependencies,读取已完成的依赖文件后写入产物,并显示进度。全部完成后运行 openspec status --change "<name>" 并汇总变更名、位置、产物清单与跳过项。
Store 选择:若用户指定 store 或工作位于某个 store,先运行 openspec store list --json 获取已注册 store id,再在读写规格与变更的命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)上追加 --store <id>,选定后保持粘性;其他命令不接受该标志。未指定 store 时作用于最近的本地 openspec/ 根目录。
限制:不得编辑项目代码、不得启动 apply 工作流;必须创建 apply 阶段传递依赖的全部产物,而不只是 apply.requires 列出的 id;status 仅反映文件是否存在,需依据 requires 边判断依赖;标记为 skipped 的产物不得创建;对影响范围、外部可观察行为、兼容性或验收标准的歧义应先询问用户,次要细节可合理假设并记录;同名变更已存在时需询问是继续还是新建。