brainstorming
AI 编程 agent 的「动手前门禁」:把创意/功能请求分类为 spike / bounded / architectural 三路径,用逐问澄清、分段设计、书面 spec 与硬性人工批准门把模糊想法打磨成可执行规格,批准前禁止写任何代码,并配浏览器可视化伴侣展示 mockup。
仓库:obra/superpowers
热度证据:所属仓库 obra/superpowers 271402 star,Claude Code 官方插件市场可装,社区最火开发方法论
五维评分
热度5/5
质量5/5
创新4/5
易用4/5
文档5/5
优秀点拆解
- HARD-GATE 批准门禁:未获用户批准禁止任何实现动作,且明确「简单任务缩放的是设计长度、永不缩放批准」,配合 7 条 Red Flags 反模式表做认知防御,直接命中 AI 编程最大浪费源(错假设白写代码)
- 三路径分类 + 单向棘轮:spike/bounded/architectural 各自独立 checklist 控制流程成本与任务规模匹配,中途发现隐藏复杂度只许升级不许降级,堵住 agent「快做完了不用升级」的自我欺骗
- Spec 三重审查(agent 四查自审 + 带校准规则与固定输出格式的子代理审查模板 + 用户审读门)防止自说自话与过度挑剔,且审查口径跨会话可复现
- Visual Companion 即需即供 + 逐问题决策:默认不启用,只在「看图比读字更清楚」的问题出现时才独立消息 offer,拒绝后不再推销;每问题过「seeing vs reading」测试,避免 token 浪费
- 浏览器伴侣工程完整度:?key= 会话密钥 + 常量时间比较 + cookie 镜像鉴权、端口/密钥持久化自动重连、4 小时空闲退出 + 父进程看门狗、Claude Code/Codex/Gemini CLI/Copilot CLI 跨平台适配
可复用的设计模式
- 批准门禁模式:所有实现动作收敛到单一 HARD-GATE,产物随任务缩放而批准永不缩放
- 分类路由 + 单向棘轮:按 spike/bounded/architectural 分派不同颗粒度流程,运行时只升级不降级
- 认知防御表(Thought → Reality):把 agent 最常犯的自我欺骗预写为对照表注入纠错
- 技能链终态绑定:明确定义每条路径终态只许调用指定下一技能(如 architectural → writing-plans),防止跳步;子代理任务用带校准与固定输出格式的模板派发
适用场景
新功能/新项目动手写代码前的需求澄清与设计确认(architectural 路径)仓库内小改动(bounded):逐问澄清 + 聊天内短设计 + 批准后直接实现可行性验证(spike):2-3 句探针计划 + 快速调查 + 给建议,产出物标 throwawayUI 布局/设计方向/架构图的可视化对比讨论(配 Visual Companion 浏览器 mockup)超大请求拆分:先分解为独立子项目,再逐个走 spec → plan → 实现循环
边界与注意:只面向软件开发场景,强触发描述(MUST use before any creative work)易在非编码任务上误触发拖慢节奏;architectural 路径多轮批准门繁琐、与 superpowers 上游技能(writing-plans 等)强耦合,单独拆用终态跳转会落空;Visual Companion 为自建 node 服务、文档自认 token-intensive
完整拆解分析文档
本页为摘要版,完整精读分析(核心机制、逐条优秀点拆解、写作过程)见本地 Markdown 文档:
analysis/superpowers-brainstorming.md