SuperAPI AI 工具集

openspec-propose

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

用途:在 OpenSpec 中提出一个新变更,并一步生成该变更所需的全部规划产物。默认的 spec-driven 模式会生成 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么的增量规格)、design.md(怎么做)、tasks.md(实现步骤)。

主要能力:根据用户描述推导 kebab-case 变更名;创建变更目录并读取产物构建顺序;按依赖顺序逐个生成产物,每步读取已完成的依赖文件;完成后汇总变更名称、位置与产物清单。

使用方式:先明确用户要构建或修复的内容;用 openspec new change "<name>" 创建变更(可加 --schema "<schema-name>");用 openspec status --change "<name>" --json 获取 applyRequires 与依赖关系;用 openspec instructions <artifact-id> --change "<name>" --json 获取模板与指引,写入 resolvedOutputPath;最后运行 openspec status --change "<name>" 查看结果。若涉及已注册 store,先执行 openspec store list --json 获取 id,并在读写的命令上加 --store "<id>"。查看工作流可先执行 openspec context --json,再在其 root.path 下运行 openspec schemas --json。

适用场景:需要快速把想法转成完整、可评审的规划文档并交给后续 apply 工作流时。

限制:仅授权规划,不实现变更、不启动 apply、不修改项目代码;存在影响范围、外部行为、兼容性或验收标准的歧义时须先询问用户;产物齐全后停止并等待新的用户请求。若同名变更已存在,需询问是继续还是新建。