SuperAPI AI 工具集

openspec-propose

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

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

主要能力:按所选 schema(默认 spec-driven)生成 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么的增量)、design.md(怎么做)、tasks.md(实现步骤)。支持通过 --schema 指定其他工作流,也支持已注册 store(用 openspec store list --json 发现 id,并在读写命令上追加 --store <id>,选定后保持粘性)。

使用方式:先明确用户请求并推导 kebab-case 变更名;用 openspec new change "<name>" 创建变更目录;用 openspec status --change "<name>" --json 获取 applyRequires、artifacts 依赖边及路径上下文;按依赖顺序对每个产物运行 openspec instructions <artifact-id> --change "<name>" --json,读取 template、instruction、resolvedOutputPath 与依赖文件后写入产物;每写完一个重新运行 status,直到必需集合(applyRequires 及其传递依赖)全部完成或跳过;最后运行 openspec status --change "<name>" 并汇总。

限制:该工作流只授权规划,禁止编辑项目代码、禁止在同一响应中开始实现或 apply,需等待用户新请求。context 与 rules 是约束,不得写入产物文件。status 仅反映文件是否存在,需依据 requires 边判断依赖。若变更已存在同名,需询问用户是继续还是新建。资料未提供具体收费、平台支持范围等信息。