为什么 Superpowers 的 brainstorming skill 坚决不写代码？我翻了它的源文件，顺手配好了 TaoToken

1. 为什么 brainstorming skill 坚决不写代码如果你最近在折腾 Claude Code、Cline 或者 Codex 这类本地 AI 编码工作流大概率听过 Superpowers 这个名字。它不是一个插件也不是一个模型而是一套用 Markdown 写成的工程纪律文本包。核心思路很朴素AI 编程 Agent 缺的从来不是能力而是纪律。Claude 知道该写测试但在“快速给我跑一遍看看”的语境下它会跳过Claude 知道 debug 要找根因但你说“快帮我改一下”它就直接猜着改了。Superpowers 用纯文本的行为约束把这些纪律“焊死”在流程里。其中被讨论最多、也最容易被用浅的就是 brainstorming skill。很多人喊一句/brainstorming回答几个问题然后直接让它开写——相当于只走了前三步最关键的后六步全跳过了。我翻了它的SKILL.md源文件发现它开头就有一道硬门HARD-GATE Do NOT invoke any implementation skill, write any code, scaffold any project, or take any implementation action until you have presented a design and the user has approved it. /HARD-GATE注意这是HARD-GATE不是“建议”。不管你觉得这个需求多简单过不了这道门一行代码都不许写。它的完整流程是 9 步探索项目现状、必要时提供可视化伴侣、逐条问澄清问题每次只问一个、提出 2-3 个方案并给推荐理由、按章节展示设计并逐段确认、把设计写入docs/superpowers/specs/YYYY-MM-DD-topic-design.md并 commit、自检 spec 扫描 TBD/TODO 与内部矛盾、让用户审阅 spec 文件、最后移交给 writing-plans skill。这里有个反直觉的设计brainstorming 的终态只有一个——移交 writing-plans。不许调用 frontend-design不许调用 mcp-builder只能移交 writing-plans。它强制你走完“设计→计划→实现”的完整链条而不是跳着来。源文件里还有一句话我印象很深“如果你觉得这个项目太简单、不需要设计那更要走流程。简单项目里的隐含假设是浪费工作的最大来源。”那这套东西跟 TaoToken 有什么关系关系在于Superpowers 的 skill 是文本约束但真正执行这些约束的 Claude subagent 需要一个稳定的模型通道。你在本地跑 Claude Code、Cline、CC Switch 这些工具时如果每个工具各配一套 Key、各走一套网络调试成本会非常高。TaoToken 提供的就是一个统一的 Key 通道让 Superpowers 工作流里的主 agent 和 subagent 都走同一个入口配置一次全链路复用。下面我把 settings.json、config.toml 和 CC Switch、Cline 的配置片段都给你直接抄。2. TaoToken 前置统一 Key 通道怎么理解在讲配置之前先把 TaoToken 的定位说清楚避免你把它想复杂。你可以把它理解成一个“模型调用的统一入口”本地这些 AI 编码工具Claude Code、Cline、CC Switch 等不再各自去记不同的地址和 Key而是统一指向同一个 API 地址用同一个 Key 去请求。这样做的直接好处是Superpowers 工作流里主 agent 派发 subagent 时subagent 拿到的模型通道和主 agent 完全一致不会出现“主 agent 能跑、subagent 报 401”这种割裂问题。需要准备的东西只有两样一个 API Key和对应的接入地址。地址分两个别搞混用途地址官网注册、看文档、领 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 接入地址写进配置文件https://taotoken.net/apiAPI 地址后面不加任何 UTM 参数配置文件里就写干净的https://taotoken.net/api。Key 的获取入口在控制台的 API Keys 页面路径是console/api-keys完整 deep link 是https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite拿到 Key 之后先别急着配一堆工具。我的建议是先用模型对话页面做一次最小验证确认 Key 和地址是通的再去配 Claude Code 和 Cline。模型对话的入口是https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite注意API Key 属于敏感凭证不要写进会提交到 Git 仓库的文件里。下面配置里我用sk-你的Key占位你替换成自己的真实 Key并且把配置文件加进.gitignore。如果你打算长期用 Superpowers 跑编码和 Agent 任务可以顺带看一下 Coding Plan它更适合高频、长会话的场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite3. 可复制配置settings.json / config.toml / CC Switch / Cline这一节是全文的技术核心四个配置片段我都给全你按自己用的工具挑。所有片段里的地址统一是https://taotoken.net/apiKey 统一替换。3.1 Claude Code 的 settings.jsonClaude Code 读取的是~/.claude/settings.jsonWindows 是%USERPROFILE%\.claude\settings.json。Superpowers 的 skill 依赖 Claude Code 的 subagent 能力所以这个文件是主战场。核心是配置环境变量让 Claude Code 走 TaoToken 的通道{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514, ANTHROPIC_SMALL_FAST_MODEL: claude-3-5-haiku-20241022 }, permissions: { allow: [ Read, Write, Edit, Bash(git *), Bash(npm test), Bash(pytest *) ] } }这里ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN填你的 Key。ANTHROPIC_MODEL是主模型ANTHROPIC_SMALL_FAST_MODEL是给轻量任务用的快模型——Superpowers 的 subagent 派发时一些审查类的小任务会走快模型能省不少开销。permissions.allow里我特意放了Bash(git *)和测试命令因为 brainstorming 流程第 6 步要 commit spec 文件writing-plans 和 test-driven-development 要跑测试这些权限不放开skill 会在半路卡住。3.2 config.tomlCodex / 通用 TOML 风格工具如果你用的是 Codex 或其它读 TOML 的工具配置长这样[model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY [profiles.superpowers] model_provider taotoken model claude-sonnet-4-20250514 approval_policy on-request [profiles.superpowers.limits] max_tokens 8192然后在 shell 里导出 Keyexport TAOTOKEN_API_KEYsk-你的KeyWindows PowerShell 用$env:TAOTOKEN_API_KEYsk-你的Key这种写法的好处是 Key 不落在配置文件里配置文件可以放心提交。approval_policy on-request是为了配合 Superpowers 的 HARD-GATE——设计没批准前工具不会自动执行实现动作。3.3 CC Switch 配置片段CC Switch 是用来在多个 Claude 配置之间切换的工具很多人用它管理“官方通道”和“自建通道”。加一个 TaoToken 的 profile{ profiles: [ { name: taotoken-superpowers, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, model: claude-sonnet-4-20250514, description: Superpowers 工作流专用通道 } ] }切换过去之后Claude Code 的请求就走 TaoToken 了。CC Switch 的价值在于你可以给“日常问答”和“Superpowers 编码”配两个不同 profile编码时切到带完整权限的那个。3.4 Cline 配置片段Cline 是 VS Code 里的 Agent 插件配置在设置面板里选 “OpenAI Compatible” 或 “Anthropic Compatible”然后填{ apiProvider: anthropic, anthropicBaseUrl: https://taotoken.net/api, anthropicApiKey: sk-你的Key, anthropicModel: claude-sonnet-4-20250514, enableSubagents: true }enableSubagents这个开关很关键。Superpowers 的 subagent-driven-development 依赖 subagent 能力Cline 里如果不开这个writing-plans 给出的“选项 1”就用不了只能退回 executing-plans 串行执行。4. 验证请求确认 skill 触发与 API 调用都正常配置写完别急着上大项目。先做两步验证一步验证 API 通道通不通一步验证 Superpowers 的 skill 能不能正常触发。4.1 验证 API 通道最直接的方式是用 curl 打一次请求确认地址和 Key 都对curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的Key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: 回复两个字通了}] }如果返回里能看到正常的content字段和文本说明通道没问题。如果返回 401检查 Key 有没有多余空格返回 404检查地址是不是写成了带路径的变体正确地址就是https://taotoken.net/api。4.2 验证 brainstorming skill 触发在 Claude Code 里先确认 Superpowers 的 skill 文件已经放到正确位置。brainstorming 的源文件路径通常是~/.claude/skills/brainstorming/SKILL.md然后开一个新会话输入一个模糊需求比如“我想给项目加一个配置热加载功能”观察 Claude 的反应。如果 skill 正常触发它不会直接写代码而是先问你澄清问题而且一次只问一个。你可以故意催它“别问了直接写。” 如果它仍然坚持先出设计、并提示需要你批准说明 HARD-GATE 生效了。再验证 subagent 通道。让 Claude 走一次 writing-plans看它给出的执行选项里有没有“subagent-driven-development”。如果有说明你的配置支持 subagent 派发subagent 也会走同一个 TaoToken 通道。这一步能过整套工作流就打通了。5. 本篇常见错排查配置过程中踩坑是常态我把几个高频问题列出来对照着查。报错一401 Unauthorized。九成是 Key 的问题。先确认 Key 没有过期再确认配置文件里没有把 Key 写成sk-你的Key这种占位符没替换。还有一个隐蔽情况某些工具会优先读系统环境变量你改了配置文件但环境变量里还是旧 Key结果一直 401。用echo $ANTHROPIC_AUTH_TOKEN检查一下。报错二skill 不触发Claude 直接开始写代码。这通常是 skill 文件没放对位置或者会话上下文太长导致 Claude “忘记”自己有 skill。Superpowers 源文件里专门提到这个坑解法是显式喊一下/using-superpowers帮 Claude 重置 skill 优先级。另外确认SKILL.md的文件名大小写正确Linux 和 macOS 是区分大小写的。报错三subagent 派发失败。如果你在 writing-plans 之后选了 subagent-driven-development但报错说无法创建 subagent先检查工具本身是否支持。Cline 要开enableSubagentsClaude Code 要确认版本支持。还有一个原因是权限subagent 需要读 plan 文件如果permissions.allow里没放Read它会卡在读取阶段。报错四brainstorming 走到第 6 步 commit 失败。这一步要把 spec 写入docs/superpowers/specs/并 commit。如果目录不存在skill 会尝试创建但如果你没给Write权限就会失败。另外 git 没初始化、或者当前目录不在 git 仓库里commit 也会报错。先git status确认一下仓库状态。报错五模型名不识别。配置里写的模型名必须是通道支持的。如果你不确定先用模型对话页面测一下确认某个模型名可用再写进配置。写错模型名通常返回 400 或 404错误信息里会带模型名对着改就行。提示排查时把日志级别调高。Claude Code 可以用claude --debug启动能看到每次请求的实际地址和返回码比猜快得多。6. 把统一通道接进你的 Superpowers 工作流回到最开始那个问题为什么 brainstorming skill 坚决不写代码因为它的价值不在“帮你写”而在“逼你想清楚”。它用 Markdown 里的HARD-GATE把“设计未批准不许实现”这条纪律固化下来再用 9 步流程保证设计一定落到 spec 文档里。而 spec 文档正是后续 writing-plans、subagent-driven-development、test-driven-development 全部环节的质量地基。你要做的是让这套文本纪律有一个稳定的执行环境。把 Claude Code、Cline、CC Switch 的模型通道统一到 TaoToken主 agent 和 subagent 走同一个入口配置一次全链路复用。Key 在 API Keys 页面拿接入细节看接入文档https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你主要用 Claude Code 跑 SuperpowersClaudeCodeAnthropic 这份说明值得先过一遍https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite配置这件事第一次跑通要花点时间但跑通之后你每次开新会话、每次派发 subagent都不用再碰 Key 和地址。省下来的注意力留给设计和调试本身——那才是真正决定代码质量的地方。