☰
Agent Teams Lite Token 经济学深度剖析:为什么委托子代理能在大功能上省下 100,000+ Tokens
2026/10/13 15:30:53 网站建设 项目流程

【免费下载链接】agent-teams-lite

Spec-Driven Development with AI Sub-Agents. An orchestrator + 9 specialized sub-agents for structured feature development. Zero dependencies. Pure Markdown. Works with Claude Code, OpenCode, Cursor, and more.

项目地址:https://gitcode.com/gh_mirrors/ag/agent-teams-lite
点击查看免费下载

在 AI 编程助手中,Token 消耗是最容易被忽视的成本黑洞。agent-teams-lite采用"编排器(Orchestrator)+ 9 个专职子代理"的 Spec-Driven Development(SDD)架构,通过上下文隔离机制,在大功能开发中相比内联(Inline)模式可节省100,000+ Tokens。这篇文章基于项目官方实测数据,深度剖析其 Token 经济学原理、盈亏平衡点与委托决策规则,帮你把钱花在刀刃上 💰。


一、问题的本质:为什么 AI 会话越聊越"贵"

很多人不知道:LLM 的每一个回合,都要重新处理完整对话历史。可以简单理解为:

第 N 轮成本 = 系统提示词 + 前面所有消息之和 + 当前消息

这意味着内联模式下存在三个恶性循环:

陷阱说明
⚠️ 上下文污染每次文件读取、grep 搜索、编辑确认都永久留在历史里
⚠️ 压缩有损上下文撞线后模型会摘要压缩,丢失文件内容;恢复时再读文件,上下文进一步膨胀
⚠️ 滚雪球效应内联工作 → 上下文增长 → 触发压缩 → 重读文件 → 更多增长 → 更快触发压缩

委托(Delegation)正是打破这个飞轮的关键:子代理读取的文件内容,在子代理结束时彻底从编排器的上下文中消失——它们从未进入过编排器的历史。

📖 完整分析见官方文档:docs/token-economics.md


二、一次委托的真实成本:约 11,850 Tokens 固定开销

委托并非免费。每次启动子代理都有固定开销,项目团队用真实文件字节数(÷ 3.5 字符/Token)测得:

组件Token 消耗
系统提示词(CLAUDE.md)7,554
AGENTS.md 工作区规则651
Skill 文件(各技能区间值)1,796 – 2,812
Engram 技能注册表查找1,028
启动提示词 + 结果信封300 – 500
单次委托总计约 11,850 – 12,866

💡 一个有趣的纠错:早期估算约 3,700T 用的是示例版 CLAUDE.md(2,440T),而实际安装版高达 7,554T——系统提示词才是最大变量。


三、盈亏平衡点:8 个文件是"分界线"

委托是否划算,不是固定数字,而是依赖数量的函数:

crossover(N_deps) = (系统提示词 + 技能文件 + N_deps × 平均依赖大小) ÷ 平均文件大小
场景盈亏平衡点(文件数)
无 SDD 依赖约 8 个文件
读 1–2 个 SDD 工件约 10 个文件
4 个 SDD 依赖(sdd-apply)约 12 个文件

一句话总结:改动 8 个文件以内,内联更划算;8 个以上,委托开始赢。📊


四、省钱的真正来源:不是"更聪明",而是"隔离"

这是全文最核心的发现。Token 节省来自四个来源,但权重差异巨大:

驱动因素节省占比机制
🏆 上下文范围隔离约 60%子代理读取的文件从不进入编排器历史
压缩规避约 25%编排器 Token 更少 = 更少触发压缩
错误减少约 10%子代理故障域更小,失败只影响自身
并行红利约 5%独立阶段可并发执行

主驱动因素不是技能指引或错误减少,而是——子代理读过的文件在它们返回时消失了。

压缩成本对比(大功能场景)

模式单次压缩成本大功能中触发次数总成本
内联15,000 – 55,000T2 – 4 次约 75,000T
委托约 4,500T0 – 1 次约 4,500T

委托模式的恢复靠 Engram 引用(约 300T),而不是重读文件(每个工件 3,000 – 15,000T)。仅此一项,大功能就拉开了 10 万+ Tokens 的差距🚀。


五、已落地的六大优化:固定开销直降 38%

项目团队实施了 6 项优化,使完整 SDD 流水线的固定开销下降约 38%:

#优化项每流水线节省原理
1移除persistence-contract.md读取约 22,000T子代理已有内联指令,文件读取冗余
2工件大小预算(字数上限)约 14,000T冗长工件会在所有下游阶段复利放大
3技能注册表预解析约 11,400T编排器解析一次,子代理跳过搜索
4公共样板抽取约 4,200T共享文件承载返回信封 + 更新说明
5编排器文档压缩约 4,200 字符查找型数据用表格替代散文
6Engram 并行读取约 800T批量执行mem_search/mem_get_observation调用

值得注意:这些优化还经过了三轮独立 AI 评审——包括统一注册表叙事、恢复被压缩到一行的反模式为显式DO NOT条目、用字数(跨模型稳定)替代 Token 数做预算等细节修正。评审记录见 docs/token-economics.md。


六、委托决策速查表:什么时候该委托?

官方给出了清晰的决策规则,直接抄作业 ✅:

场景涉及文件数建议
琐碎修改(重命名等)1内联
需要上下文的小修复2 – 7预期 <6 轮则内联
中等功能8 – 15委托
大功能 / SDD 流程15+委托(必选)
跨天工作任意完整 SDD 流水线 + 委托

⚠️按文件委托是浪费(单文件任务开销放大约 1,209%)。按阶段(Phase)委托才是甜点区——每个 SDD 阶段(探索、提案、规格、设计、任务、实现、验证、归档)恰好是一个自然的委托单元。

9 个子代理的分工详见:docs/sub-agents.md;整体架构与 DAG 阶段编排见:docs/architecture.md


七、五条关键洞察:写给想自建多代理系统的你

  1. 编排器是 O(1) 状态的事件循环;子代理是无状态工人——请保持这种设计。
  2. 委托不会让子代理变聪明——它让故障域变小。子代理失败只影响自身;内联失败会污染编排器状态。
  3. Engram 传引用,不传内容。每个 SDD 工件引用传递成本约 50T,而内联传内容每个工件要 3,000 – 15,000T。
  4. 系统提示词大小是主导变量。若能把 CLAUDE.md 从 7,554T 压缩到 4,000T,盈亏平衡点将从约 8 个文件降到约 5 个文件——更多任务会变得"值得委托"。
  5. 每次优化都在移动盈亏平衡点。优化是乘数,不是一次性修复 📈。

写在最后

agent-teams-lite 的 Token 经济学给我们一个反直觉但坚实的结论:省钱的核心不是让模型少干活,而是让干过活的内容"消失"。通过按阶段委托、上下文隔离与引用式记忆,大功能开发可省下 100,000+ Tokens,同时换来更小的故障域和更稳的多阶段流水线。

如果你的项目涉及8 个以上文件的功能开发,不妨参考 skills/ 目录下的 SDD 技能与 examples/claude-code/CLAUDE.md 等配置模板,在自己的工作流里落地这套"轻量子代理团队"模式 🤖。

【免费下载链接】agent-teams-lite

Spec-Driven Development with AI Sub-Agents. An orchestrator + 9 specialized sub-agents for structured feature development. Zero dependencies. Pure Markdown. Works with Claude Code, OpenCode, Cursor, and more.

项目地址:https://gitcode.com/gh_mirrors/ag/agent-teams-lite
点击查看免费下载

相关推荐

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询