SuperAPI AI 工具集

openspec-plus-design

设计与创作

查看项目

更新于 10-16 08:36

技能介绍

用途:这是OpenSpec设计阶段的强制技能(RIGID),在/opsx-new或/opsx-continue等触发时激活,目标是在写design.md之前避免过早收敛架构,先探索备选方案、比较取舍、给出推荐并让用户选择,再增量构建设计、校验与proposal(及已有spec)的一致性。

主要能力与流程:分五个阶段——Phase 0架构与模板解析,运行openspec instructions design --change <name> --json获取template、instruction、rules,并读取openspec/.plus/config.yaml(缺失则用默认,questionMode默认sequential);Phase 1探索2到3个可行设计途径,逐一给出名称、核心思路、优缺点、复杂度与关键假设,并推荐其一;Phase 2由用户选择方向;Phase 3按设计关切逐节构建(架构、组件结构、数据流、错误处理与失效模式、测试策略,必要时迁移/发布,以及模板缺口与变更性质带来的额外关切),逐节经用户确认;Phase 4生成设计文档。

使用方式要点:写入前必须先完成前三个阶段并获批准;每节用question工具确认Continue/Revise/Revisit;sequential模式一次一节,batch模式一次性生成全部后合并确认;新引入或替换任何库须经用户批准(已使用库无需再批准);写完后必须交给reviewer子代理评审,跳过即违规;设计须对齐proposal与已有spec,冲突要停下上报,不得掩盖。

适用场景:需要为变更制定架构级设计、希望保留人类决策权并防止一次性输出整份设计的OpenSpec工作流。

限制:设计只停留在架构层(HOW),不承载详细需求、场景与验收标准(属spec阶段);技能为RIGID,禁止跳过、合并或重排阶段;测试策略属设计层,不写测试用例。资料未提供该技能的安装命令、价格、平台支持范围与具体输出文件路径等细节。