SuperAPI AI 工具集

openspec-propose

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

用途:该技能面向 OpenSpec 的规划阶段。当用户想快速描述要构建或修复的内容并获得完整提案时,它会在一步内创建变更并生成 schema 定义的规划产物,不进入实现。

主要能力:依据配置的 schema 创建变更目录及其规划文件。默认 spec-driven schema 下包括 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么,规格增量而非主规格)、design.md(如何做)、tasks.md(实现步骤)。会先通过 openspec status --change "<name>" --json 获取 applyRequires 与各产物的 requires 依赖边,再按依赖顺序逐个获取 instructions 并生成文件。

使用方式:用户请求需含 kebab-case 变更名或描述;缺失时以开放式提问确认。创建命令为 openspec new change "<name>",指定 schema 时加 --schema "<schema-name>"。若涉及已注册的 store,先运行 openspec store list --json 获取 id,并在读取或写入规格与变更的相关命令上附加 --store "<id>",该选择在后续工作流中保持。

适用场景与限制:适用于已使用 OpenSpec 的项目中做变更规划。作者明确限定只做规划:即使请求要求实现或修复,也不得编辑项目代码、不得在同一次回复中启动 apply,须等用户新请求后再进入应用流程。产物创建需读取依赖文件(从磁盘重读)、遵循 instructions 的 context 与 rules 作为约束但不写入文件。存在会影响范围、外部可观察行为、兼容性或验收标准的歧义时应先询问;次要细节可做合理假设并记录。若同名变更已存在,需询问继续还是新建。相关命令、URL 与文档未提供的细节,本资料未给出。