SuperAPI AI 工具集

openspec-propose

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:根据用户描述创建一个新变更(change),并在一步内生成 schema 定义的全部规划产物。默认 spec-driven schema 产出 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(能力增量)、design.md(怎么做)、tasks.md(实现步骤)。

主要能力:从描述推导 kebab-case 变更名;读取 status 判定产物依赖顺序并按序生成;对每个产物先用 openspec instructions <artifact-id> --change "<name>" --json 获取 template、instruction、rules、context 与 resolvedOutputPath,再据此写入文件。

使用方式:用 openspec new change "<name>" 创建目录(可加 --schema "<schema-name>");用 openspec status --change "<name>" --json 获取 applyRequires、artifacts 依赖边与路径;最后 openspec status --change "<name>" 查看结果。若指定了 store,先运行 openspec store list --json 获取 id,并在接受该参数的读写命令上追加 --store "<id>",且后续保持粘性;未指定 store 时作用于最近的本地 openspec/ 根目录。

限制:本工作流只授权规划,不编辑项目代码、不进入 apply 流程,产物完成后应停止并等待用户新请求;存在影响范围、外部可见行为、兼容性或验收标准的歧义时需先询问用户;同名变更已存在时需询问继续还是新建;status 仅反映文件是否存在,需按 requires 依赖边判断必需产物集合。