1. 为什么 AI 编程助手需要“纪律”从一次数据同步重构说起AI 编程助手有个通病太快了。快到它根本不问你要解决什么问题就开始写代码快到测试、文档、边界情况统统跳过快到你两分钟就拿到一个“能跑”的功能然后花两天修它留下的坑。我拿一个真实项目说话——重构一个数据同步模块纯 Claude Code 模式下2 小时生成 500 行代码测试覆盖率 0%上线后发现 3 个 Bug。启用 Superpowers 后3.5 小时生成 450 行代码测试覆盖率 85%在测试阶段就发现了 5 个问题。时间增加了 75%但省掉了后期改 Bug、补测试、重构烂代码的两天。Superpowers 是一个为 AI 编程助手设计的“技能框架”GitHub 4.7 万星三个月内从 0 到现在。它不是代码生成工具也不是 AI 模型本身更像一套“工作流程规范”——强制 AI 助手在写代码之前先问清楚需求、设计方案、制定计划然后才动手实现。核心机制是 Skills一组用 Markdown 写成的规则文件每个文件描述了在特定场景下 AI 应该遵循的工作流程。比如 brainstorming 在写代码之前先通过提问细化需求最后生成一份设计文档test-driven-development 强制使用 TDD先写测试再实现功能systematic-debugging 是四阶段调试流程包括根因追踪和防御性编程verification-before-completion 在声称完成之前必须验证功能真的可用。这些 Skills 不是“建议”而是强制执行的流程——只要 AI 助手检测到相关场景就会自动激活对应的 Skill。它解决的核心问题是 AI 助手太“急”了。训练目标是“快速响应”不是“高质量交付”。你说“帮我实现用户登录功能”它立刻开始写代码等你看到成品才发现没考虑密码加密、没做输入验证、也没有错误处理。你让它修一个问题它改了五个文件跑起来好像没问题两天后你发现边界情况全崩了。Superpowers 的思路很简单既然 AI 不会自己慢下来那就强制它慢下来。慢在设计快在执行。这篇文章聚焦 Superpowers 在 Claude Code 中的 TDD 工作流落地从任务拆解、测试先行到提交前自检给出可复制的 Superpowers 配置片段与验证动作帮你跑通一次完整的 TDD 循环并对比无纪律时的代码质量差异。适合正在用 Claude Code 做生产级开发、被 AI 生成的“能跑但不敢上线”代码折磨过的开发者。如果你只是快速修 Bug 或原型验证这篇文章的方法可能会让你觉得束手束脚——但如果你写的代码未来一周还要维护下面的内容值得你花 20 分钟跟做一遍。2. TaoToken 前置给 Claude Code 接上稳定的模型通道在配置 Superpowers 之前你需要先确保 Claude Code 能稳定调用模型。Claude Code 本身是一个 CLI 工具它需要连接到一个兼容 Anthropic API 的服务端点。TaoToken 提供了这个通道让你在国内网络环境下也能稳定使用 Claude Code 的完整能力。先注册并获取 API Key。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 完成注册然后进入控制台创建 API Key。地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在“API Keys”页面点击创建复制生成的 Key 备用。这个 Key 就是你后续所有配置里的核心凭证。接下来确认你要使用的模型 ID。TaoToken 支持 Claude 系列模型在模型对话页面可以查看当前可用的模型列表https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。常见的模型 ID 包括 claude-sonnet-4-20250514、claude-opus-4-20250514 等。记下你打算用的模型 ID后面配置里要填。然后设置环境变量。Claude Code 读取两个关键环境变量ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。在终端里执行export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的API Key如果你用的是 zsh把这两行加到 ~/.zshrc如果是 bash加到 ~/.bashrc。这样每次打开终端都会自动生效。验证环境变量是否设置成功echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_API_KEY应该分别输出 https://taotoken.net/api 和你复制的 Key。如果输出为空说明没生效检查一下配置文件路径和 source 命令。现在验证 Claude Code 能否正常调用模型。在终端里直接运行claude -p 用一句话解释什么是 TDD如果返回了一句关于测试驱动开发的解释说明通道已经打通。如果报错先检查 API Key 是否正确、账户余额是否充足。这一步是整个 Superpowers 配置的基础——模型通道不通后面的 Skills 都无法激活。关于 Coding Plan如果你打算长期用 Claude Code 做开发可以关注 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 页面里面有适合持续编码场景的套餐方案。对于需要长时间自主工作的 Agent 场景Coding Plan 的额度更充裕不用担心中途断掉。3. 可复制配置Superpowers 安装与 TDD 工作流设置Superpowers 在 Claude Code 里的安装只需要两条命令。打开 Claude Code 的交互界面依次执行/plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace第一条命令添加插件市场第二条安装 Superpowers 插件。安装完成后重启 Claude Code然后输入 /help 查看可用命令。你应该能看到 /superpowers:brainstorm、/superpowers:write-plan、/superpowers:execute-plan 等命令。如果没看到说明插件没加载成功检查一下网络连接和插件市场地址是否正确。安装完成后需要配置 Superpowers 的 TDD 工作流。Superpowers 的核心是 Skills每个 Skill 是一个 Markdown 规则文件。你可以在项目根目录创建 .claude/skills/ 目录然后放入自定义的 Skill 文件。不过 Superpowers 已经内置了 TDD 相关的 Skill你只需要在项目里启用它。在项目根目录创建或编辑 .claude/settings.json 文件加入以下配置{ skills: { enabled: [ brainstorming, writing-plans, test-driven-development, systematic-debugging, verification-before-completion ], tdd: { strictMode: true, requireTestFirst: true, minCoverage: 80, maxTaskDuration: 5 } }, superpowers: { autoActivate: true, requireDesignApproval: true, parallelSubagents: true, codeReviewAfterEachTask: true } }这个配置做了几件事启用了五个核心 SkillstrictMode 开启严格 TDD 模式requireTestFirst 强制先写测试minCoverage 设置最低覆盖率 80%maxTaskDuration 限制每个子任务不超过 5 分钟autoActivate 让 Skill 在检测到相关场景时自动激活requireDesignApproval 要求设计文档必须经你确认才能进入实现阶段parallelSubagents 允许并行执行多个子任务codeReviewAfterEachTask 在每个任务完成后自动触发代码审查。如果你用的是 Codex 或 OpenCode配置方式不同。Codex 需要在 auth.json 里配置 Base URL、Key 和 Model ID 三件套{ base_url: https://taotoken.net/api, api_key: 你的API Key, model: claude-sonnet-4-20250514 }auth.json 通常位于 ~/.codex/auth.json 或项目根目录的 .codex/auth.json。OpenCode 的配置类似在 opencode.json 里设置 provider 和 model。无论哪个平台Base URL、Key、Model ID 这三件套缺一不可。配置完成后验证 Superpowers 是否正常工作。在 Claude Code 里输入/superpowers:brainstorm 实现一个用户注册功能如果 Superpowers 正常激活它不会立刻写代码而是开始问你问题这个功能是给谁用的有哪些边界情况需要考虑密码加密用什么算法数据怎么存储问完之后会生成一份设计文档分段展示给你确认。只有你批准设计后它才进入下一步。这就是“纪律”的开始——强制在写代码之前想清楚。4. 验证请求跑通一次完整的 TDD 循环现在用一个具体任务来验证整个 TDD 工作流。假设你要实现一个“用户注册”功能包含邮箱验证、密码哈希、重复邮箱检查。在 Claude Code 里输入/superpowers:brainstorm 实现用户注册功能需要邮箱格式验证、密码 bcrypt 哈希、重复邮箱检查Superpowers 会激活 brainstorming skill开始提问。它会问邮箱验证用正则还是第三方库密码最小长度要求重复邮箱检查是在数据库层还是应用层注册成功后返回什么你逐一回答后它会生成一份设计文档包含数据模型、API 接口定义、错误码、边界情况列表。你确认设计后输入/superpowers:write-planSuperpowers 激活 writing-plans skill把工作拆分成小任务Task 1: 创建 users 表结构 (2 分钟) Task 2: 实现邮箱格式验证函数 (3 分钟) Task 3: 实现密码 bcrypt 哈希函数 (3 分钟) Task 4: 实现重复邮箱检查逻辑 (4 分钟) Task 5: 编写注册 API 端点 (5 分钟) Task 6: 添加集成测试 (5 分钟)每个任务控制在 2-5 分钟这是 Superpowers 的硬性要求。任务太大就继续拆直到每个任务都能在 5 分钟内完成。然后输入/superpowers:execute-planSuperpowers 为每个任务启动一个子代理使用 TDD 流程实现。以 Task 2 为例子代理会先写测试def test_validate_email_format(): assert validate_email(userexample.com) True assert validate_email(invalid-email) False assert validate_email(user.com) False assert validate_email() False assert validate_email(userexample) False运行测试红灯。然后实现功能import re def validate_email(email: str) - bool: if not email or not isinstance(email, str): return False pattern r^[a-zA-Z0-9._%-][a-zA-Z0-9.-]\.[a-zA-Z]{2,}$ return bool(re.match(pattern, email))再次运行测试绿灯。然后重构优化确保代码简洁。每个任务完成后code-review 代理会检查代码质量确认没有遗留问题。所有任务完成后verification-before-completion skill 启动检查所有测试是否通过、文档是否更新、有没有遗留的 TODO、边界情况是否覆盖。最终你得到的结果450 行代码85% 测试覆盖率5 个在测试阶段发现的问题。对比无纪律模式500 行代码0% 覆盖率3 个上线后发现的 Bug。时间从 2 小时增加到 3.5 小时但省掉了后续两天修 Bug 的时间。这就是“慢在设计快在执行”的实际效果。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth配置过程中最容易遇到的几个报错这里逐一排查。401 Unauthorized这是最常见的错误说明 API Key 无效或未正确设置。检查步骤第一确认 ANTHROPIC_API_KEY 环境变量已设置且没有多余空格用 echo $ANTHROPIC_API_KEY 查看第二确认 Key 没有过期或被撤销去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 重新生成一个第三确认 ANTHROPIC_BASE_URL 设置为 https://taotoken.net/api注意末尾没有多余的斜杠。如果三个都正确还是 401尝试重启终端让环境变量重新加载。local proxy failed这个报错通常出现在 Claude Code 启动时说明它尝试连接本地代理但失败了。检查是否有残留的 HTTP_PROXY 或 HTTPS_PROXY 环境变量指向了不存在的本地端口。用 env | grep -i proxy 查看如果有用 unset HTTP_PROXY 和 unset HTTPS_PROXY 清除。另外检查 Claude Code 的配置文件 ~/.claude/config.json 里是否有 proxy 相关设置有的话删掉。reading choices 报错这个错误通常出现在模型返回格式不符合预期时。可能原因模型 ID 写错了比如把 claude-sonnet-4-20250514 写成了 claude-sonnet-4或者 Base URL 配置成了不兼容的端点。检查 .claude/settings.json 或 auth.json 里的 model 字段确认与 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 页面列出的模型 ID 完全一致。如果用的是 Codex检查 auth.json 里的 base_url、api_key、model 三件套是否齐全。OAuth 相关报错Claude Code 有时会尝试 OAuth 流程如果你用的是 API Key 模式需要确保没有触发 OAuth。检查 ~/.claude/ 目录下是否有 oauth.json 或类似文件有的话删掉。然后在 settings.json 里明确设置 authType: api_key。如果报错信息里提到 OAuth token expired说明 Claude Code 在尝试用 OAuth 而不是 API Key检查环境变量 ANTHROPIC_API_KEY 是否被正确读取。Superpowers 插件不激活安装后输入 /superpowers:brainstorm 没反应。检查步骤第一确认插件市场添加成功重新执行 /plugin marketplace add obra/superpowers-marketplace第二确认插件安装成功执行 /plugin list 查看已安装插件第三重启 Claude Code插件需要重启后才能加载第四检查 .claude/settings.json 里的 skills.enabled 列表是否包含你需要的 Skill。如果还是不行尝试删除 ~/.claude/plugins/ 目录下的缓存重新安装。TDD 流程不强制Superpowers 没有强制先写测试。检查 .claude/settings.json 里的 tdd.strictMode 是否设置为 truerequireTestFirst 是否设置为 true。如果配置正确但行为不对可能是 Skill 文件没有正确加载。检查 .claude/skills/ 目录下是否有 test-driven-development.md 文件没有的话从 Superpowers 插件目录复制一份过来。6. 语义一致 CTA从跑通 TDD 到长期编码工作流跑通一次 TDD 循环只是开始。真正让 Superpowers 发挥价值的是把它变成日常开发习惯。每次接到新功能需求先 /superpowers:brainstorm 把需求问清楚再 /superpowers:write-plan 拆任务然后 /superpowers:execute-plan 执行。提交代码前verification-before-completion 会自动检查测试覆盖率、文档更新和边界情况。这套流程跑顺之后你会发现 AI 生成的代码从“能跑但不敢上线”变成了“测试齐全、边界清晰、可以直接合并”。如果你在配置过程中遇到 API Key 或模型通道的问题去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 管理你的 Key接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 有详细的参数说明和示例。想先验证模型是否正常工作可以用模型对话页面快速测试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算长期用 Claude Code 做开发Coding Plan 的额度更适合持续编码场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后说一个实际经验Superpowers 的 TDD 流程在复杂功能开发上效果最明显但如果你只是改一个变量名或修一个单文件的小 Bug它会问你“为什么改影响范围有测试吗”——这时候直接手动改更快。核心判断标准是如果这段代码未来一周还要维护用 Superpowers如果只是临时用一次不用。纪律不是目的交付可靠的代码才是。