1. 为什么 AI 编程助手需要 Superpowers 技能系统你可能遇到过这种情况让 AI 编程助手写一个功能它三秒钟就吐出一大段代码看起来挺像回事跑起来却报错你让它修 bug它东改一处西改一处改完旧问题没解决又冒出三个新问题。这不是模型不够聪明而是它太急于求成——直接跳到写代码这一步跳过了需求理解、测试设计、根因分析这些软件工程里最关键的环节。Superpowers 就是来解决这个问题的。它是一套为 AI 编程助手设计的结构化工作流技能系统核心思路是把资深工程师的工作习惯固化成 AI 必须遵循的流程。比如 TDD 技能强制先写失败的测试再写实现systematic-debugging 技能强制先找到根因再动手修brainstorming 技能强制先探索需求再写代码。它适合个人开发者提升代码质量也适合团队统一 AI 助手的产出规范更适合所有希望 AI 编程助手从能写代码进化到会做工程的人。我试过把这套技能接到 Claude Code 和 Qwen Code 上配合 TaoToken 统一管理 API 通道整个配置过程大概二十分钟。下面把可复制的配置片段和验证步骤完整写出来你跟着做就能跑通。2. TaoToken 前置准备统一 Key 与 API 通道Superpowers 本身是技能系统它需要挂载在一个 AI 编程助手上才能工作。而 AI 编程助手要调用大模型就需要一个稳定的 API 通道。TaoToken 在这里扮演的角色是统一入口你只需要一个 Key就能在 Claude Code、Codex、Qwen Code 等多个客户端之间切换不用每个平台单独申请和管理密钥。先注册并拿到 Key。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 进去之后左侧菜单找 API Keys点新建复制那串 sk- 开头的字符串。这个 Key 后面要填到多个配置文件里先存好。接下来确认你要接入的模型。TaoToken 支持多种模型 ID在模型对话页面可以先试一下哪个模型适合你的场景https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。对于 Superpowers 这种需要多轮推理和工具调用的技能系统建议选推理能力强的模型。记下你选定的 Model ID比如 claude-sonnet-4-20250514 这类格式。如果你打算长期用 AI 做编码和 Agent 任务可以看一下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它针对高频编码场景做了额度优化比按量计费更划算。前置准备的核心是三件套Base URL、API Key、Model ID。Base URL 统一用 https://taotoken.net/api 注意这个地址不加任何 UTM 参数直接写进配置文件。API Key 就是你刚才复制的那串。Model ID 是你选定的模型标识。这三样东西后面在 Claude Code 的 settings.json、Codex 的 auth.json、Cline 的 MCP 配置里都会用到格式略有不同但本质一样。有一点要提醒TaoToken 是合规的 API 聚合通道不是让你去搞什么网络代理。你只需要在配置文件里把请求地址指向它剩下的它帮你路由到对应的模型服务。整个链路是干净的 HTTP 请求不涉及任何网络层的东西。3. 可复制配置Claude Code Superpowers TaoToken这一节给出完整的配置文件片段你直接复制改 Key 就能用。分三部分Claude Code 的模型接入配置、Superpowers 插件安装、以及 MCP 方式的备用配置。3.1 Claude Code settings.json 配置Claude Code 的配置文件在 ~/.claude/settings.jsonmacOS/Linux或 %USERPROFILE%.claude\settings.jsonWindows。如果文件不存在就新建一个。内容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Bash(git*), Bash(npm*), Bash(pytest*), Read, Write, Edit ] } }这里三个关键字段ANTHROPIC_BASE_URL 指向 TaoToken 的 API 地址ANTHROPIC_API_KEY 填你的 KeyANTHROPIC_MODEL 填你选定的模型 ID。permissions.allow 里放开了一些常用命令因为 Superpowers 的 TDD 技能需要跑测试、systematic-debugging 需要看 git 日志不放权限的话每次都要手动确认很烦。如果你用的是 Codex配置文件在 ~/.codex/auth.json格式不同但三件套一样{ base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514 }Codex 的 auth.json 对字段名比较敏感base_url 不要写成 baseUrlapi_key 不要写成 apiKey否则会报 401。这个坑我踩过排查了半天才发现是大小写问题。3.2 Superpowers 插件安装Claude Code 支持插件市场安装 Superpowers 最省事。在 Claude Code 对话里依次执行/plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace第一条命令注册插件市场第二条安装 Superpowers。装完之后执行 /help如果看到 /superpowers:brainstorm、/superpowers:write-plan、/superpowers:execute-plan 这三个命令说明插件加载成功了。如果你用的是 Qwen Code 或其他 MCP 客户端走 MCP 方式配置。在 MCP 配置文件里加{ mcpServers: { superpowers: { command: npx, args: [-y, superpowers-mcp], env: { TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: sk-你的TaoToken密钥 } } } }MCP 方式的技能调用和 Claude Code 原生方式不同需要用 mcp__superpowers__list_skills 列出技能再用 mcp__superpowers__read_skill 读取具体技能内容。功能一样只是调用语法有区别。3.3 本地开发安装可选如果你想改 Superpowers 源码或者用最新开发版可以本地克隆构建git clone https://github.com/obra/superpowers.git cd superpowers npm install npm run build构建完成后在 MCP 配置里把 command 改成 nodeargs 指向本地构建产物{ mcpServers: { superpowers: { command: node, args: [/你的路径/superpowers/dist/index.js] } } }本地方式的好处是技能更新即时生效不用等插件市场同步。缺点是每次更新要手动 git pull 再 build。4. 验证请求确认技能加载与调用成功配置写完不代表就能用得逐项验证。这一节给出具体的验证步骤和预期结果你照着跑一遍就知道哪里没配对。4.1 验证 API 通道连通先确认 TaoToken 的 API 通道是通的。在终端里跑一条 curlcurl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -d { model: claude-sonnet-4-20250514, max_tokens: 100, messages: [{role: user, content: 回复 OK 两个字母}] }如果返回的 JSON 里 content 字段有 OK说明 Key 和 Base URL 都对。如果返回 401检查 Key 有没有复制错如果返回 model not found检查 Model ID 拼写。4.2 验证 Superpowers 技能加载在 Claude Code 里执行 /help确认三个 superpowers 命令存在。然后试一下 brainstorming 技能使用 brainstorming 技能帮我设计一个用户登录功能预期行为AI 不会直接写代码而是先问你问题比如这个登录功能用于什么类型的应用一次只问一个问题等你回答后再问下一个。如果 AI 直接开始写代码说明技能没加载成功回去检查插件安装步骤。4.3 验证 TDD 技能强制生效这是最能体现 Superpowers 价值的验证。给 AI 一个明确的功能需求用 TDD 方式实现一个 retryOperation 函数失败重试 3 次预期行为AI 第一步是写一个失败的测试然后运行测试确认它失败再写最小实现让测试通过最后提交。整个过程你会看到 RED-GREEN-REFACTOR 的循环。如果 AI 直接写实现代码再补测试说明 TDD 技能没被触发。4.4 验证 systematic-debugging 技能故意给 AI 一个有 bug 的代码片段然后说这段代码偶尔报错帮我修function divide(a, b) { return a / b; }预期行为AI 不会直接改成 if (b 0) return 0而是先问你要错误信息、复现步骤、最近的变更然后形成假设、写失败测试、再修复。这个流程走完你就能确认 systematic-debugging 技能在工作。5. 本篇常见错排查401、local proxy failed、reading choices配置过程中最容易卡在几个报错上这一节逐个拆解。5.1 401 Unauthorized这是最常见的。原因通常是三个Key 复制时带了空格、Key 过期、或者配置文件字段名写错。先检查 Key 有没有多余空格然后去 TaoToken 控制台确认 Key 状态正常。如果都没问题检查配置文件里的字段名——Claude Code 用 ANTHROPIC_API_KEYCodex 用 api_keyCline 用 apiKey大小写和前缀都不一样。写错了不会报字段名错误只会报 401很迷惑。5.2 local proxy failed这个报错通常出现在你之前配过其他代理工具环境变量里残留了 HTTP_PROXY 或 HTTPS_PROXY。TaoToken 是直连的不需要任何代理。检查你的 shell 配置echo $HTTP_PROXY echo $HTTPS_PROXY如果有输出在配置文件里清掉或者在启动 Claude Code 前 unset 掉。另外检查 ~/.claude/settings.json 里有没有多余的 proxy 字段有的话删掉。5.3 reading choices 报错这个报错一般出现在 MCP 方式调用时返回的 JSON 结构不符合预期。原因可能是 Model ID 填错了或者 TaoToken 的 API 版本和客户端不匹配。先确认 Model ID 在模型对话页面能正常返回结果然后把 MCP 配置里的 env 字段检查一遍确保 TAOTOKEN_BASE_URL 是 https://taotoken.net/api 而不是带路径的完整地址。5.4 OAuth 相关报错如果你之前用 Claude Code 官方登录过本地可能残留了 OAuth token。切到 TaoToken 之后旧的 token 会干扰。解决办法是删掉 ~/.claude/ 下的 credentials 相关文件然后重新用 API Key 方式配置。具体文件名因版本而异一般是 credentials.json 或 auth.json删之前先备份。5.5 技能不触发配置都对了但 AI 还是不按 Superpowers 的流程走。检查两点一是技能有没有正确加载用 /help 确认命令存在二是你的提问方式。Superpowers 的设计是如果有一丝可能某个技能适用就必须调用但 AI 有时候会偷懒。你可以在提问时显式指定技能名比如使用 systematic-debugging 技能来调查这个问题强制它走流程。6. 把 Superpowers 接入你的日常开发流配置跑通之后Superpowers 会自动融入你的开发流程。新功能开发走 brainstorming → writing-plans → TDD → verification-before-completion 这条链路bug 修复走 systematic-debugging多任务并行走 dispatching-parallel-agents。你不需要每次手动指定AI 会根据任务类型自动选择技能。有一个实用技巧在项目根目录放一个 CLAUDE.md 或 AGENTS.md里面写清楚本项目使用 Superpowers 技能系统所有功能开发必须先走 brainstorming所有 bug 修复必须先走 systematic-debugging。这样 AI 每次进入项目都会读到这个约束技能触发率会高很多。另外Superpowers 的技能是可以自定义的。用 writing-skills 技能可以创建新技能比如你们团队有自己的代码审查规范可以写成一个技能文件放到 skills 目录下AI 就会按你们的规范来审查。技能文件本质是 Markdown写起来不复杂。最后提醒一点Superpowers 正在积极开发中技能列表和安装方式可能会有调整。如果遇到配置不生效的情况先去 GitHub 仓库看最新文档或者在 TaoToken 的接入文档页面确认 API 地址有没有变化https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。API Key 的管理在控制台https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。把这两个页面存书签后面排查问题会用到。