SuperAPI AI 工具集

openspec-propose

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

用途:在 OpenSpec 中提出一个新变更,并一次性生成该变更所需的全部规划产物。适用于用户想快速描述要构建的内容并获得完整提案的场景。

主要能力:按所选 schema 生成产物。默认 spec-driven schema 包括 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么,是增量而非主 spec)、design.md(怎么做)、tasks.md(实施步骤)。<capability-path> 是相对 specs/ 的 spec 目录,如 user-auth 或 identity/user-auth;已有能力保留完整路径,新能力遵循项目既有组织方式。

使用方式:输入需包含 kebab-case 变更名或需求描述;若描述不清需先向用户确认。默认使用已配置 schema,用户明确指定时用 --schema <schema-name>。创建变更目录:openspec new change "<name>"(指定 schema 时加 --schema)。随后用 openspec status --change "<name>" --json 获取 applyRequires、artifacts 及其 requires 依赖边、planningHome、changeRoot、artifactPaths、actionContext。按依赖顺序逐个产物执行 openspec instructions <artifact-id> --change "<name>" --json,读取 context、rules、template、instruction、resolvedOutputPath、dependencies,先重读磁盘上的依赖产物,再按 template 写入 resolvedOutputPath。若用户指定 store,先运行 openspec store list --json 获取 id,并在支持 --store 的命令上追加 --store "<id>",选定后保持粘性。

限制:本工作流仅授权规划,不得编辑项目代码、不得启动 apply 工作流,产物完成后即停止,等待用户新请求。必须创建 apply 阶段传递依赖的全部产物,而非仅 apply.requires 列出的 id。status 仅反映文件是否存在,需依据 requires 边构建必需集合。status 为 skipped 的产物视为已满足,不得创建。仅当 instruction 标明可选时才可跳过条件产物。若同名变更已存在,需询问用户是继续还是新建。写入后需确认文件存在再继续。