优化 Claude Code：用 3 个插件替代 39 个智能体
一位拥有 3000+ 小时 Claude Code 实战经验的开发者，将原本臃肿的单体系统——含 39 个智能体、38 项能力与 25 条斜杠命令——精简为仅 3 个插件。这一转变极大降低了维护成本，也使系统能敏捷响应 Anthropic 的快速迭代，例如上下文窗口从 10 万 tokens 扩展至惊人的 100 万 tokens。新方案摒弃过度设计，专注无缝集成经实战验证的成熟工具。
过去，“编排工具包”（Orchestrator Kit）通过隔离子智能体来缓解上下文衰减问题：每个子智能体在独立上下文中运行并返回结果，从而保障主会话的清晰性。但随着 API 频繁更新、新型智能体范式涌现，以及上下文容量呈数量级跃升，这套架构已显冗余。
单体智能体系统的痛点
维护 39 个智能体意味着每次 Claude Code 发布新版后都需手动更新。能力与斜杠命令迅速过时，无法适配新功能带来的性能优化。最大转折点正是免费上下文从 10 万 tokens 跃升至 90 万 tokens：上下文隔离策略已失去战略意义。
核心弊端包括：
- 范式失效：2025 年 10 月编写的智能体，无法利用 2026 年 1 月推出的全新 Agent 工具 API；
- 人工验证耗时：每次更新后测试全部 25 条命令需数小时；
- 基础设施膨胀：工程师精力从功能开发，被迫转向“抢救技术栈”。
这正是经典陷阱：昨日的解法，终成明日的瓶颈。
Superpowers：将测试驱动开发（TDD）固化为纪律
杰西·文森特（Jesse Vincent）开发的 Superpowers 插件，将严谨的软件工程规范直接嵌入 Claude Code。它摒弃即兴编码，强制执行标准流程：头脑风暴 → 制定计划 → 测试驱动开发（TDD）→ 代码评审 → 结果验证。
以“添加 JWT 认证”为例：
- Claude 先执行
brainstorming：厘清需求，提出多种实现路径； - 进入
writing-plans：将任务拆解为聚焦明确、耗时 2–5 分钟的微任务； - 执行强制 TDD 循环：RED（编写失败测试）→ GREEN（产出最小可行代码）→ REFACTOR（重构优化）。
TDD 规则不可妥协：生产级代码必须在确认功能缺失的失败测试通过后，方可编写。此举从根源上阻断大模型幻觉渗入交付逻辑。
完成前必验证
verification-before-completion 能力强制执行四步验证：
- 明确定义用于验证结果的命令；
- 全新执行该命令——禁用缓存；
- 全量分析输出内容，而非仅截取片段；
- 显式声明成功与否。
缺失此环节，Claude 常凭主观假设宣告“完成”，而非基于实证。
Beads：基于 Git 的任务追踪系统
史蒂夫·叶格（Steve Yegge）设计的 Beads 将任务以版本化 Git 文件形式持久化存储，确保跨会话状态不丢失。核心命令如下：
bd create -t feature "JWT 认证"—— 创建任务并自动提交至 Git；bd ready—— 列出当前无阻塞、可立即执行的任务；bd prime—— 在会话启动时一键还原项目完整状态。
优势显著：
- 多终端安全：独占锁机制杜绝并发冲突；
- 依赖图谱：自动识别任务依赖关系，智能排序与阻塞判断；
- Git 历史：完整记录所有决策过程——上下文压缩再也不会导致信息丢失。
它彻底取代了散乱的规格文档和脆弱的 plan.json，让任务导航直观、可靠。
模板桥接器（Template Bridge）：统一模板集成与目录
我们自研的 Template Bridge 插件，通过 unified-workflow 能力，将 Superpowers 与 Beads 深度协同。工作流如下：
- 创建史诗级任务：
bd create -t epic "JWT 认证"； - 启动头脑风暴与计划制定；
- 拆解为具备依赖感知的子任务：
bd create "tokens 表结构"
bd create "认证中间件验证"
bd dep add middleware tokens- 执行
bd ready，实时刷新就绪任务看板。
template-catalog 提供对 [davila7/claude-code-templates](https://github.com/davila7/claude-code-templates) 中 413+ 预置智能体的即时访问，覆盖 26 大类场景。按需安装任意智能体：npx claude-code-templates@latest --agent security/security-auditor --yes。所有智能体均动态拉取、使用后自动清理——零本地存储开销。
为何至关重要
- 可扩展性：3 个插件替代 102 个组件，更新由维护者自动推送，无需人工打补丁；
- TDD 强制落地：“红-绿-重构”成为硬性要求，从源头掐灭幻觉引发的缺陷；
- 状态持久化：Git 支持的任务追踪，保障会话连续性与全量项目历史；
- 灵活适配：模板按需加载，杜绝本地仓库膨胀与版本漂移；
- 高效聚焦：团队精力始终锚定方法论与业务成果，而非基础设施运维。
方案对比
| 维度 | 编排工具包（Orchestrator Kit） | 新插件架构 |
|------|-------------------------------|------------|
| 组件规模 | 39 个智能体 + 38 项能力 + 25 条命令 | 3 个插件 + 2 项能力 + 1 条命令 |
| 更新机制 | 手动维护 | 自动同步 |
| 上下文管理 | 子智能体隔离 | 90 万 tokens 窗口 + Git 持久化 |
| 开发范式 | 可选 | 强制 TDD + 结果验证 |
新架构解决的是同一组问题——但以极低的运维负担，自然演进，与 Claude Code 的高速创新同频共振。
— Editorial Team
暂无评论。