
1. 装上 Superpowers 却不触发头脑风暴问题多半出在模型通道你按官方 README 装好了 Superpowers兴冲冲地给 Claude Code 丢了一句「帮我做个用户登录功能」然后等着它像教程里那样反问需求、拆解边界、逼你确认设计——结果它二话不说直接开始写代码了。这个场景我见过太多次也踩过这个坑。Superpowers 的核心卖点之一就是「头脑风暴」AI 不急着动手而是先通过苏格拉底式提问把需求挖干净再进入 TDD 和子代理开发流程。如果这一步没触发整套纪律基本就废了你得到的还是一个「裸奔版」的 AI 编程助手。需要先明确一个边界Superpowers 本身是一套写给 AI 的工程纪律手册它由一堆 Markdown 技能文件SKILL.md组成负责定义「什么时候该反问、什么时候该写测试、什么时候该派子代理」。它不负责提供模型也不负责管理 API 通道。而 Claude Code 这类宿主工具需要一条模型通道才能跑起来——这条通道指向哪里直接决定了 Superpowers 的技能能不能被正确加载和执行。很多人装完 Superpowers 后不触发头脑风暴根因不是技能没装对而是宿主工具的模型通道没配对或者会话没重启导致旧配置还在生效。这篇就按「先定位问题、再配通道、再验证、最后排障」的顺序讲清楚。核心动作只有一个把宿主工具的 Base URL 指向 TaoToken 的https://taotoken.net/api让模型通道稳定可用Superpowers 的 Skill 逻辑才有机会正常跑起来。TaoToken 在这里只做模型通道不替代 Superpowers 的任何技能逻辑——这个定位要先摆正否则后面容易误判。2. 先搞清楚 Superpowers 的头脑风暴为什么依赖模型通道2.1 头脑风暴不是「插件功能」是技能被正确加载后的行为Superpowers 的头脑风暴brainstorming是一个 SKILL.md 技能文件它的触发依赖宿主工具在会话开始时把技能体系注入上下文然后由路由技能using-superpowers根据你的请求匹配最合适的技能。这个过程需要模型真正读到技能文件内容并按照里面的指令去执行「先反问、再设计」。如果模型通道不稳定、返回被截断、或者根本没连上正确的模型宿主工具可能拿不到完整的技能上下文AI 就会退化成「看到需求直接写代码」的默认行为。所以「不触发头脑风暴」往往不是技能写错了而是通道层出了问题。2.2 宿主工具、模型通道、技能逻辑三者关系可以用一个类比Superpowers 是「操作规程」宿主工具Claude Code 等是「车间」模型通道是「电力供应」。操作规程写得再好车间再规范电供不上或者电压不稳机器照样不按规程转。TaoToken 提供的就是这条稳定的「电力通道」Base URL 填对了模型才能稳定读到技能、执行技能。2.3 为什么强调 Base URL 而不是别的宿主工具连接模型靠的是 API 地址Base URL Key。Base URL 决定了请求发到哪里、用哪条通道。如果这里填的是默认地址或者一个不可用的地址请求要么失败、要么走到一个不加载 Superpowers 技能的环境里。把 Base URL 统一指向https://taotoken.net/api是让通道可控、可复现的第一步。3. TaoToken 前置准备创建 Key 并确认通道地址在改宿主工具配置之前先把通道侧的准备工作做完。这一步不复杂但顺序别搞反。3.1 创建 API Key打开 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end注册或登录后进入控制台在 API Keys 页面创建一个新的 Key。创建时建议给它起一个能认出用途的名字比如superpowers-claude-code方便以后区分不同项目或工具的 Key。创建完成后立刻复制保存——多数平台只在创建时完整显示一次。控制台入口在这里https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理页在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite。3.2 确认 Base URL 写法TaoToken 的 API 地址是https://taotoken.net/api。注意两点一是不要带末尾多余的斜杠路径二是不要把它和官网首页地址混用。宿主工具里填的应该是 API 地址不是网页地址。有些工具会在 Base URL 后面自动拼接/v1/messages之类的路径所以填的时候保持干净让工具自己去拼。3.3 确认你要用的模型名不同宿主工具对模型名的写法要求不一样。Claude Code 通常用 Anthropic 风格的模型标识你在配置时按工具文档要求的格式填。如果不确定当前有哪些模型可用可以先到模型对话页面确认一下通道是否正常https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite。能正常对话说明 Key 和通道没问题再去配宿主工具。4. 可复制配置把宿主工具的 Base URL 指向 TaoToken下面以 Claude Code 为例讲配置思路其他宿主工具Cursor、Codex CLI 等逻辑一致只是配置文件位置和字段名不同。4.1 通过环境变量配置推荐最通用Claude Code 读取的是 Anthropic 风格的环境变量。你可以在 shell 配置文件如~/.zshrc或~/.bashrc里加上export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你刚才创建的Key保存后执行source ~/.zshrc按你实际用的 shell 调整让配置生效。这样每次启动 Claude Code 都会走这条通道。4.2 通过项目级配置文件配置如果你不想污染全局环境可以在项目里放配置文件。Claude Code 支持在项目目录下用.claude/settings.json之类的配置来指定通道。具体字段名以你所用版本的官方文档为准核心就是把 base URL 指向https://taotoken.net/api把 key 填进去。项目级配置的好处是团队可以共享同一套通道设置避免每个人环境不一致导致「我这能触发头脑风暴、你那不能」。4.3 配置后必须重启会话这是最容易被忽略的一步。环境变量或配置文件改完后已经打开的 Claude Code 会话不会自动重新读取。你需要完全退出当前会话再重新启动。如果只是新开一个对话窗口但进程没重启旧配置可能还在内存里生效表现就是「我明明改了 Base URL怎么还是不触发头脑风暴」。4.4 一个配置对照表配置项填什么说明Base URLhttps://taotoken.net/api模型通道地址不要带多余路径API Key控制台创建的 Key只显示一次注意保存模型名按宿主工具要求格式不确定先用模型对话验证生效方式重启会话改完必须重启进程5. 验证请求确认头脑风暴真的被触发配置完不要凭感觉判断用可复现的方式验证。5.1 用一个「模糊需求」测试重启会话后给一个故意留白的需求比如「帮我加一个导出功能」。正确表现是 AI 先反问你导出什么格式、数据量多大、要不要分页、权限怎么控制。如果它直接开始写代码说明技能没被加载或通道没走对。5.2 手动触发头脑风暴技能如果自动触发不稳定可以显式调用。Superpowers 的头脑风暴技能通常有对应的触发命令或关键词你可以在会话里直接说「用 brainstorming 技能帮我梳理这个需求」。如果显式调用能触发、自动触发不能说明技能本身装好了问题在路由或通道的上下文注入环节。5.3 检查通道是否真的在返回一个更底层的验证方法在宿主工具里让它做一个需要多轮推理的任务观察响应是否完整、是否中途截断。如果响应经常断、或者报连接错误说明通道层有问题先解决通道再谈技能触发。你也可以回到模型对话页面https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite发一条消息确认通道本身是通的。5.4 成功结果长什么样成功触发头脑风暴时你会看到 AI 的回复里包含针对你代码库的具体问题而不是通用模板。比如它会提到「你项目里已经有 auth 模块是扩展现有的还是重新设计」。这种「读了代码再提问」的行为是 Superpowers 头脑风暴的典型特征也是判断通道和技能都正常工作的最直接信号。6. 本篇常见错排查6.1 改了 Base URL 但没重启会话症状配置看起来对但行为没变化。原因旧会话进程还在用内存里的旧配置。解决完全退出宿主工具进程重新启动。6.2 Base URL 填成了官网首页症状请求失败或行为异常。原因把https://taotoken.net当成了 API 地址。解决API 地址是https://taotoken.net/api两者不要混。6.3 Key 没生效或填错症状报鉴权错误。原因Key 复制不完整、有多余空格、或者用了已删除的 Key。解决回控制台https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite重新确认必要时新建一个。6.4 技能装了但路由没匹配上症状通道正常但 AI 还是不反问。原因请求描述太明确路由技能判断不需要头脑风暴或者技能文件没被正确注入。解决换一个模糊需求测试或显式调用 brainstorming 技能。6.5 把 TaoToken 当成 Superpowers 的替代品症状以为配了通道就等于有了纪律。原因概念混淆。解决TaoToken 只提供模型通道Superpowers 的 Skill 逻辑、TDD 门禁、子代理审查都还是由 Superpowers 自己负责。通道是必要条件不是充分条件。6.6 多工具共用 Key 导致混乱症状这个工具正常、那个工具异常。原因不同工具对模型名、路径拼接的要求不同。解决给不同工具建不同的 Key方便定位问题配置时严格按各工具文档来。7. 通道配好之后把 Superpowers 的纪律真正跑起来Base URL 指向https://taotoken.net/api、会话重启、头脑风暴被触发——这三步做完你才算真正进入了 Superpowers 的工作流。接下来它会带你走完七个阶段头脑风暴、设计确认、Git Worktree 隔离、编写计划、子代理开发、代码审查、分支收尾。每一步都有硬性门禁不通过不放行。如果你打算长期用这套流程做编码和 Agent 开发可以了解一下 Coding Plan它更适合持续性的编码场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite。接入过程中遇到通道或鉴权问题先查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite需要管理多个 Key 就去 API Keys 页面。Claude Code 相关的接入细节可以看这里https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite。最后留一个我自己的经验每次换工具或升级版本后先用一个模糊需求测一遍头脑风暴是否触发再开始正式开发。这个三十秒的检查能帮你省掉后面几小时的返工。