SuperAPI AI 工具集

openspec-propose

编程与开发

查看项目

更新于 11-06 17:04

技能介绍

用途:openspec-propose 面向快速提案场景,用户只需描述想要构建的内容,即可在一次流程中创建变更并生成实现所需的全部工件,避免逐一手动编写。

主要能力:生成 proposal.md(说明做什么与为什么)、design.md(说明如何实现)和 tasks.md(实现步骤)三类工件;根据 openspec status 返回的 applyRequires 与依赖关系,按顺序完成从依赖到被依赖的构建;生成后校验文件存在并汇总状态。

使用方式:输入应包含 kebab-case 变更名或对要构建内容的描述;若无清晰输入,技能会询问“What change do you want to work on? Describe what you want to build or fix.”,并从描述推导名称(如 add user authentication → add-user-auth)。随后执行 openspec new change "<name>" 创建脚手架,运行 openspec status --change "<name>" --json 获取构建顺序,使用 TodoWrite 跟踪进度;对每个就绪工件运行 openspec instructions <artifact-id> --change "<name>" --json,读取已完成依赖文件,按 template 结构写入 outputPath,并将 context 与 rules 作为约束而非写入内容。每个工件完成后重跑状态检查,待 applyRequires 全部为 done 即停止。最终输出变更名称与位置、工件清单及描述,并提示“Run /opsx:apply or ask me to implement to start working on the tasks.”

适用场景:需要快速把想法转成结构化变更提案、并准备进入实现阶段的开发流程;适合希望一次生成提案、设计与任务清单的团队协作。

限制与注意事项:必须先理解用户要构建的内容才继续;不得将 context、rules、project_context 等约束块写入工件文件;如上下文严重不清应询问用户,但倾向于合理决策以保持推进;同名变更存在时需询问继续或新建;工件需按依赖顺序创建并验证存在。