SuperAPI AI 工具集

openspec-propose

编程与开发

查看项目

更新于 11-16 17:09

技能介绍

openspec-propose 是一个面向变更提案的技能,目标是在一步内完成变更创建与全部产出物生成。

用途 当用户想快速描述要构建的内容并获得完整提案时使用。用户输入应包含变更名称(kebab-case)或对想构建内容的描述;若输入不明确,技能会先询问“你想处理什么变更?描述你想构建或修复的内容。”,并从描述中推导 kebab-case 名称(如 add user authentication → add-user-auth)。在未理解用户意图前不会继续。

主要能力

  • 创建变更目录:执行 openspec new change "<name>",在 openspec/changes/<name>/ 下生成含 .openspec.yaml 的脚手架。
  • 获取构建顺序:执行 openspec status --change "<name>" --json,解析 applyRequires(实施前所需产出物 ID 数组)与 artifacts(含状态与依赖的产出物列表)。
  • 按依赖顺序生成产出物:对依赖已满足的产出物,执行 openspec instructions <artifact-id> --change "<name>" --json 获取 context、rules、template、instruction、outputPath、dependencies;读取已完成的依赖文件作为上下文,以 template 为结构创建产出物文件,并把 context 与 rules 作为约束而非写入内容。
  • 使用 TodoWrite 跟踪进度,创建每个产出物后重新运行 status 并检查 applyRequires 中各项是否均为 done。
  • 若某产出物需要用户输入且上下文不清,会询问澄清后继续。
  • 最终运行 openspec status --change "<name>" 展示状态,并汇总变更名称与位置、产出物列表及说明,提示“所有产出物已创建,可以实施”,并建议运行 /opsx:apply 或让助手开始实现。

使用方式 典型流程为:接收用户请求→必要时询问→创建变更目录→获取状态与构建顺序→按依赖顺序逐个生成产出物→展示最终状态与汇总。产出物创建须遵循 openspec instructions 给出的 instruction 字段与 schema 内容;不得把 context、rules、project_context 等约束块复制进文件;若同名变更已存在,会询问继续该变更还是新建。

适用场景 适用于希望在实现前快速获得结构化提案、设计与任务拆分的开发工作流,尤其适合需要按依赖顺序保证产出物完整性的变更管理。

限制 资料未说明该技能的收费、价格、平台兼容性或具体效果;产出物内容依赖项目上下文,若上下文严重不清会向用户询问,但整体倾向做出合理决策以保持推进。