如何把Token花刀刃上:BuilderIO/skills /efficient-fable前沿模型编排降本秘籍
【免费下载链接】skillsSkills for coding agents项目地址: https://gitcode.com/gh_mirrors/skills39/skills
用 AI 编码智能体啃大型代码库时,Token 成本是最现实的痛点。本文带你用 BuilderIO/skills 项目中的/efficient-fable技能,掌握一套前沿模型编排方法论:把昂贵的 Token 只花在判断与最终评审上,把吃 Token 的重活交给更便宜的子代理,最高可换得 3-5 倍成本效率。
💡 一句话核心思想:Fable 负责编排,轻量代理负责收集信号和写代码。
为什么前沿模型"全干"会浪费Token?
用最贵的模型去读每个文件、缩减每份日志、手动跑每个浏览器检查,等于让首席架构师去干快递的活。/efficient-fable 解决的就是这个浪费问题:判断力留在前沿模型,重活外包给子代理。
| 💎 昂贵Token只该花在 | 🪫 便宜子代理应该干 |
|---|---|
| 架构 / 产品 / 安全权衡 | 大规模仓库搜索、长日志缩减 |
| 把模糊任务拆成干净并行切片 | 文档扫描、搜索摘要、盘点 |
| 裁决相互冲突的子代理报告 | 有边界的代码编辑、机械重构 |
| 把部分实现整合成一致方案 | 浏览器测试、截图、日志聚类 |
| 最终评审、风险评估、面向用户的综合 | 狭窄的 bug 排查、问题复现 |
编排架构图:昂贵的大脑 + 便宜的手
图中居中的 Claude Fable 同时扮演编排者 + 评审 + 整合者三个角色:用户目标、仓库上下文与约束从左侧进入;下方三个轻量子代理分别负责研究扫描、有边界的编码、测试跑批;最终由 Fable 输出整合结果、完成最终评审。
这张图的可编辑源文件是 fable-orchestrator.excalidraw,完整的技能规则定义在 SKILL.md 中。
五步委派模式:降本流程拆解
完整的委派流程见 SKILL.md:
- 点名昂贵Token风险—— 大仓库搜索、长日志、广文档、重复性编辑,先识别出来;
- 先拆分再动手—— 在读完所有东西之前,先把独立工作切给子代理;
- 用更便宜的模型跑重活—— 研究扫描、盘点、搜索摘要、窄 bug 排查、浏览器/测试跑批、日志缩减、有边界的代码编辑;
- 要求回传简洁证据—— 文件、行号引用、执行的命令、diff、不确定性和触发的停止条件;
- Token 只花在决策层—— 对比结果、解决冲突、选实现路径、评审最终补丁。
⚡ 原则:切片之间互不依赖时优先并行子代理;强耦合的工作留在本地自己干。
交接包:写给子代理的自包含工单
委派质量的关键,是把提示词写得像子代理没有任何聊天上下文一样(见 SKILL.md)。一个完整的"交接包"包含 5 要素:
- 📍仓库路径 + 精确目标—— 别留模糊空间;
- 🎯职责范围—— 明确哪些文件/包在范围内,以及明确排除项;
- 📄证据格式—— 文件、行号引用、命令、diff、失败信息、截图、不确定点;
- ✅验证方式—— 要跑哪些命令或浏览器流程,成功时应该是什么样;
- 🛑停止条件—— 代码与预期不符、命令重试后仍失败、需要范围外文件时:停下并汇报,而不是自行发挥。
复核环节:把子代理报告当线索,不当事实
这是最容易被忽略、却最关键的一步(SKILL.md):在采用高影响结论、开 PR、或告诉用户"做完了"之前,Fable 必须重新打开被引用的关键文件,确认行号和失败信息,并把最终 diff 与任务对照评审。
🧠 让轻量代理收集信号,把对事实的判断权留在 Fable 手里。
常见场景:研究/编码/测试/调试的分工对照
SKILL.md 给出四个"软性默认",可按需调整:
| 场景 | 子代理负责 | Fable 负责 |
|---|---|---|
| 🔍 研究 | 扫文档、先例、API、仓库面 | 判断哪些证据会改变计划 |
| 💻 编码 | 有边界的编辑、候选补丁 | 共享文件协调、整合、最终评审 |
| 🧪 测试 | 跑定向测试、浏览器流程、截图与日志缩减 | 定验证方向,判断失败是真实/flaky/环境所致 |
| 🐛 调试 | 聚类日志、复现问题、尝试小修复 | 挑出最可信的诊断结论 |
⚠️ 注意:如果任务很小,或验证本身需要细腻判断,就保留给 Fable—— 此时委派的协调成本比省下的 Token 还贵。
真实降本效果:最高 3-5 倍成本效率
官方在 SKILL.md 中给出了诚实的区间:对于代码库密集型工作,当独立的研究、编码或测试切片可以并行时,这个模式最高可达 3-5 倍成本效率、2-4 倍速度提升。
请把它当作随工作量变化的估算,而不是保证。
一分钟安装与启用
官方安装方式(见 README.md):
npx @agent-native/skills@latest add --skill efficient-fable --update-instructions加上--update-instructions后,Fable 委派约定会被自动写入AGENTS.md或CLAUDE.md,让这套编排习惯在所有会话中长期生效。
相关技能:前沿模型降本组合拳
- skills/efficient-frontier/SKILL.md —— 把同一套编排推广到任意高成本前沿模型,并给出了更完整的停止条件与护栏清单;
- skills/stay-within-limits/ —— 长任务前检查 5 小时/每周用量窗口,95% 时干净暂停;
- skills/quick-recap/ —— 用绿/黄/红状态信号收尾,让每次工作有明确交付信号。
完整技能目录可查阅根目录 README.md,安装入口同样在 package.json 中定义。
【免费下载链接】skillsSkills for coding agents项目地址: https://gitcode.com/gh_mirrors/skills39/skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考