SuperAPI AI 工具集

openspec-propose

通用与其它

查看项目

更新于 10-16 05:47

技能介绍

用途:在已使用 OpenSpec 的项目中快速发起一个新变更,并一次性生成该变更所需的所有规划产物,便于后续评审与实施。

主要能力:按项目配置的架构(默认 spec-driven)创建变更目录并逐个生成产物:proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(能力规格增量)、design.md(怎么做)、tasks.md(实施步骤)。支持通过命令查询架构、产物依赖与指令,支持已注册 store(用 --store <id> 指定)。

使用方式:调用者需给出 kebab-case 变更名或需求描述,模糊之处需先澄清;先运行 openspec context --json 确认根路径并读取 config.yaml 的 context 字段作为约束;用 openspec new change "<name>" 创建变更,用 openspec status --change "<name>" --json 获取必须产物及依赖顺序,再对每个产物运行 openspec instructions <artifact-id> --change "<name>" --json,按其 template 与 resolvedOutputPath 写入文件,最后汇总变更名、位置与产物清单,提示可运行 /openspec-apply-change。

限制:本流程只做规划,不编辑项目代码、不进入 apply;若项目未初始化 OpenSpec,仅在用户明确要求时才建议 openspec init 并等待确认;config.yaml 不可读或 context 字段非法/超限时按无项目上下文继续;若同名变更已存在应先询问是继续还是新建。