Brainstorming（需求澄清与设计）
写代码前先把需求逼问清楚，禁止在没有确认设计前直接动手实现
为编码代理在实施前澄清目标、约束、成功标准并形成设计文档提供了明确流程，适用对象和边界较清楚。硬性要求先获用户批准再实施、提出多种方案及分段确认具有实际价值。但“所有项目无论多简单都必须经过完整流程”可能降低小改动和紧急修复的效率；该技能也依赖 writing-plans 等其他技能，单独使用时终态和后续能力不完整。
流程顺序、状态图、用户批准门和规范自检步骤较具体，有助于重复执行；视觉伴侣指南还描述了服务器启动、重连、空闲超时和停止流程。配套脚本包含参数校验、会话隔离、PID 身份校验和失败状态输出，仓库还提供了服务器安全测试文件作为支持信号，但本评估未执行测试。缺少对项目上下文不可访问、用户长期不回复、设计文档写入或提交失败、writing-plans 不可用等情况的完整降级路径；关键 server.cjs、模板和实际运行环境也未在所给材料中完整提供。
明确要求在实施前取得用户设计批准，并且视觉伴侣必须单独征得同意，体现了同意和外部效果控制。默认绑定 127.0.0.1，会话密钥、HttpOnly/SameSite cookie、文件权限、跨源 WebSocket 拒绝和可停止服务器等机制在配套材料中提供了较好的防护信号。风险在于允许使用 0.0.0.0 远程绑定，客户端使用 ws:// 而非加密传输，URL 中包含会话密钥；持久化项目目录会保留 mockup 和事件相关状态，HTML 内容由代理写入且事件会传回代理。对远程网络暴露、敏感数据、密钥泄露后的轮换，以及已提交设计文档的撤销或恢复没有充分说明。
技能文本包含详细步骤、流程图、检查清单、设计覆盖范围和视觉伴侣操作说明，具有较好的可追溯性。配套 helper、启动/停止脚本和仓库中的认证测试提供了实现与测试线索，但这些材料不能证明本次修订已实际执行或测试通过；所给测试主要覆盖服务器认证，不覆盖完整的头脑风暴行为、用户批准门、文档提交和跨平台流程。README 中的宣传性描述与实际验证结果没有明确分离，缺少版本化行为规范、失败案例和独立评估。
输入、对话步骤、设计文档默认路径、视觉伴侣启动参数、输出 URL、事件目录和停止命令均有说明，且对多个编码代理环境提供了操作差异。成本和兼容性仍取决于特定 harness、Node、浏览器、git 和未提供的其他技能；Windows、远程容器和后台进程虽有说明，但诊断信息和常见错误排查不够系统。流程没有清晰定义用户拒绝设计、取消任务、无法提交或不希望继续时的退出语义。
仓库提供 MIT 许可证、package.json 版本号和较明确的社区/问题反馈渠道，能支持基础维护判断。发布者身份按题设未验证，不能作为额外信任依据。选定技能自身没有版本、变更记录、兼容性矩阵、负责人、发布责任或明确更新路径；依赖其他技能和未随材料完整展示的运行组件，长期维护风险因此较高。
- 不要在未经用户明确同意时使用 --open 或启动视觉伴侣；远程场景应谨慎使用 0.0.0.0，并避免通过不加密的 ws:// 传输敏感内容。
- 会话密钥出现在 URL 和浏览器状态中，分享日志、截图或完整 URL 可能导致会话访问；持久化 .superpowers/brainstorm/ 目录也可能保存敏感设计材料。
- 该技能的强制流程可能不适合低风险小改动、故障恢复或用户明确要求立即止损的场景；下游 writing-plans 技能不可用时应停止并向用户说明。
- 本评估为静态审查，未执行技能、服务器或测试；不要将仓库测试文件视为本次修订已通过的独立验证。
它能做什么 & 适用场景
这是 Superpowers 方法论的第一道关卡：在任何创造性工作（新功能、新组件、行为变更）开始前，强制 Claude 先通过一次次单一问题的对话澄清用户真实意图，提出 2-3 个方案并说明权衡，展示分段设计并逐段确认，最后把定稿的设计写成文档再进入下一步。它的核心机制是一个「硬性关卡」：在设计被用户批准之前，不允许调用任何实现类 skill、写任何代码。
先探查项目现状（文件、文档、最近提交）；判断需求规模是否需要拆成多个子项目；每次只问一个问题（优先用选择题）来摸清目的、约束和成功标准；提出 2-3 个备选方案并给出推荐理由；按小节展示设计并逐节获得确认；把最终设计写入 docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md 并提交 git；对着写好的 spec 做一次自查（占位符、内部矛盾、范围、歧义）；请用户复核 spec 文件；最后统一转交给 writing-plans skill 生成实现计划。还内置一个可选的浏览器可视化配套功能，用于展示原型图和布局对比。
- 在 Claude Code 里说「帮我加一个用户认证功能」，先被反问需求细节而不是直接开始写代码
- 一个看似很小的需求（比如「改一下配置项」）也会被要求先过一遍设计确认流程，避免隐藏假设
- 把一个「做一个带聊天、文件存储、计费、分析的平台」这种过大的需求拆解成多个独立子项目分别过设计
- 设计涉及 UI 布局/线框图时，按需打开浏览器可视化配套展示 mockup
优缺点一览
- 「硬性关卡」写得很明确（HARD-GATE 标签），比一般的「建议先设计」类文档更难被绕过
- 强调一次只问一个问题、优先选择题，符合真实对话节奏，不会一次甩给用户十个问题
- 设计文档落盘到固定路径并提交 git，形成可追溯记录，而不是聊天记录里说过就忘
- 只在会自动读取和遵循 SKILL.md 指令的 harness 里可靠工作（Claude Code、Codex CLI 等）；纯聊天式界面里等于一份说明文档，需要人工照做。
- 流程本身要求较多轮对话确认，简单任务如果用户只想要「快速写完」，会感觉流程偏重
- 可视化配套功能依赖启动本地浏览器服务，token 消耗和额外复杂度需要用户自行判断是否需要
如何安装
作为 obra/superpowers 插件的一部分安装，不能单独安装某一个 skill：
- Claude Code：官方市场
/plugin install superpowers@claude-plugins-official；或先注册 Superpowers 自建市场/plugin marketplace add obra/superpowers-marketplace，再/plugin install superpowers@superpowers-marketplace - 也支持 Antigravity、Codex App/CLI、Cursor、Factory Droid、GitHub Copilot CLI、Kimi Code、OpenCode、Pi 等 harness，具体命令见仓库 README
装好后这个 skill 会和其余 13 个 Superpowers skill 一起启用，由 using-superpowers 统一引导、按场景自动触发，无需单独调用。
如何使用
无需手动触发，harness 识别到你在做「创造性工作」时会自动调用。典型用法：直接说「我想做一个 XXX 功能」，Claude 会先探查项目、然后逐条提问，而不是立刻写代码。
对比同类
跟直接在系统提示里写「写代码前先确认需求」相比，这个 skill 提供了具体的检查清单、流程图和落盘路径，而不是一句笼统的提醒。它是整个 Superpowers 工作流的起点，下游依赖 writing-plans、subagent-driven-development 等其余 13 个 skill 共同构成一条从需求到落地的完整流水线，单独装它意义有限。