设计先行
在编写代码前澄清需求、比较方案并形成可审批的设计规格。
技能明确要求先获用户设计批准,并将可视化伴侣设为经批准后才启动;辅助脚本包含会话密钥、文件权限、跨源限制和停止流程,降低了未授权访问风险。扣分原因是流程强制写入并提交设计文档,却未说明提交前确认、回滚或失败恢复;可视化伴侣涉及本地服务器、浏览器和事件写入,数据流与遥测边界未在该技能内完整说明。
流程、阶段顺序、终止状态和异常时的服务器重启提示较具体,且脚本对重连、无效参数和过期 PID 有处理。扣分原因是依赖 writing-plans、实现环境工具和浏览器伴侣,但未定义这些依赖不可用时的替代流程;静态材料未证明完整关键路径可运行,按校准上限限制为不超过10分。
目标场景清楚:编码代理在实现前进行需求澄清和设计确认;同时区分文本问题与视觉问题,并覆盖多种代理环境。扣分原因是触发条件过于绝对,几乎所有改动都必须走完整流程,未明确不适用场景;未提供中文交互支持说明,视觉伴侣在远程或受限网络环境中的可达性也依赖额外主机配置。
文档结构清晰,包含硬门槛、清单、流程图、限制、示例、视觉伴侣指南和清理方式;仓库上下文提供 MIT 许可证、版本号和维护入口。扣分原因是该技能文件没有自己的版本、变更记录、依赖安装说明或明确维护责任;对 writing-plans 等后续技能的可用性假设较多,故未接近满分。
该技能能把模糊需求转化为经用户确认的设计、规格文档和后续计划入口,核心产出定义较明确。扣分原因是强制流程可能对简单任务成本过高,且设计文档写入、提交和后续技能调用仍依赖外部工具与用户配合;源文件未提供可静态验证的代表性完整输出,按静态校准不超过7分。
流程图、脚本接口、事件格式和停止行为提供了可审计材料;仓库还提供与视觉伴侣服务器相关的安全测试。扣分原因是没有针对该技能对话流程、用户批准门控和设计产出的独立执行证据或覆盖测试,且本评估未执行任何内容,因此仅给有限静态可验证性。
- 安装或使用前确认 writing-plans 及相关代理工具可用,并为不可用时准备纯文本降级流程。
- 在远程或容器环境中启动视觉伴侣前,确认绑定地址、访问控制、会话密钥和网络暴露范围;不要默认将服务暴露到公共网络。
- 对简单配置或单行修复,评估完整头脑风暴、文档提交和审批链的成本是否合理。
- 技能未明确中文交互、敏感项目信息处理和提交失败后的恢复策略。
这个 Skill 能做什么,适合哪些场景?
Brainstorming 是 obra/superpowers 中专门用于设计澄清的技能。它通过逐个提问了解项目背景、目标、约束和成功标准,再提出多个方案并协作形成设计。设计获得批准前,它要求停止实施动作。最终设计会被整理为规格文档,并进入实现计划阶段。
读取项目文件、文档和近期提交记录;通过一次一个问题的对话细化用户意图;提出 2–3 种实现方向及取舍;分段展示架构、组件、数据流、错误处理和测试设计;在批准后生成设计规格文档并提交到 Git;随后转入实现计划流程。
- 开发者准备新增功能,但需求和边界尚未明确时,用它先完成设计讨论。
- 团队面对多个技术方案,需要在编码前比较取舍并获得确认时使用。
- 维护旧项目时,需要先了解现有结构、文档和近期变更再规划修改时使用。
- 即使是简单的配置或小型工具变更,也希望先检查未声明假设时使用。
这个 Skill 有哪些优点和局限?
- 把需求澄清、方案比较和设计审批设为编码前的明确阶段。
- 强制覆盖架构、组件、数据流、错误处理和测试等设计内容。
- 要求先检查现有项目上下文,适合已有代码库中的功能变更。
- 设计获批前不会执行代码、脚手架或其他实现动作,可能增加简单任务的前置时间。
- 依赖后续的 writing-plans 技能完成实现计划,单独使用时流程不完整。
- 源材料没有提供该技能独立的测试套件或跨平台验证结果。
如何安装这个 Skill?
该技能随 Superpowers 集合发布,仓库包含 14 个技能。按所用编码代理分别安装集合:Claude Code 可使用 /plugin install superpowers@claude-plugins-official;Antigravity 可使用 agy plugin install https://github.com/obra/superpowers;Pi 可使用 pi install git:github.com/obra/superpowers。其他代理的安装方式见仓库 README;该技能没有单独安装命令。
如何使用这个 Skill?
安装集合后,在提出创建功能、构建组件、增加功能或修改行为的请求时使用该技能。它会先询问项目背景和需求,再比较方案、展示设计并等待批准。SKILL.md 未提供特定触发提示词或独立运行命令。