成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Metabase:十条领域子代理,给 50 万行 Clojure 减上下文税

对照团队工程实践:按子系统写约 150 行专家 markdown;披露 10 席、各约 2k–3k token、QP 68 段中间件与并行专家评审;不代你吞吐、不外推。

场景说明

面向超大单体/多方言查询栈、Agent 一换域就烧光上下文的后端团队:把「再开一个通用会话」写成可对账的子代理路由+领域前置知识+并行专家会诊,区别于两触点编排仓与 hooks 工作流引擎。

案例叙事

01他们做了什么

Bryan Maass 在 Metabase 工程博客《How we built ten custom subagents to tame a 500K-line Clojure codebase》(页内 Apr 27, 2026;JSON-LD datePublished 2026-04-27 → 2026-04-27)写明:后端约 50 万行 Clojure,跨查询处理器、权限、驱动、通知、序列化、搜索等;用 Claude Code 时每换子系统就 grep/读文件,把主会话上下文吃光,默认子代理也要重新摸索。

做法是按自然域边界做十条自定义子代理(markdown):YAML frontmatter 含 name/description/model(如 opus)与 memory: user(持久目录 ~/.claude/agent-memory/<name>/);正文按「领域知识 → 代码路径 → 调查法 → 坑点 → 测试策略」。作者用 Claude 协助写「职位描述」再人工审,每条约 2,000–3,000 token(约 150 行)。十席含 mbql-expert、permissions-expert、platform-expert、enterprise-expert、content-expert、notifications-expert、drivers-and-sync、search-expert、ai-expert、transforms-expert。

重点案例 mbql-expert:QP 为约 68 段中间件管线(预处理约 44、执行约 8、后处理约 13 等),跨约 18 种 SQL 方言;专家已内化「部分中间件因后续引入结构需再跑」等不可从目录名推断的坑,故问 Redshift 嵌套 join 错结果时先推理阶段与驱动覆盖,而非盲目 grep。用法可口语委托或 @ 点名,并可让查询与权限专家并行会诊以免上下文串味。本场景据此输出「领域子代理减税」提纲。禁止建议无人值守合入权限/驱动改动。

02实际效果

  • 源披露约 50 万行 Clojure、十条子代理、各约 2k–3k token(约 150 行)、QP 约 68 段中间件与可并行专家会诊等团队口径;属 Metabase 后端叙事,不可外推为你的会话成本、缺陷率或发版吞吐。
  • 能把「再开通用 Agent」与「按域前置知识 + 路由描述 + 持久 memory」拆开。
  • 为 description 过泛导致不委派、目录改名与跨域改动漏会诊提供提问清单。

03值得知道

  • 数字与管线结构绑定 Metabase QP/权限模型;换语言栈不可照搬席位数与 token 预算。
  • 子代理仍可能错;并行专家输出需人整合,合入必须人审。
  • 上面写的是 Metabase 工程实践帖,不是 Anthropic 子代理产品官文。

04可复制提示词

领域子代理编队简报

你是大仓 Claude Code 子代理顾问。只根据用户约束写提问清单,不要编造已上线编队。

仓规模与语言:{{repo_scale}}
自然域边界:{{domains}}
是否允许并行会诊:{{parallel_ok}}

输出 Markdown:
1. 拟设席位与 frontmatter description 路由词
2. 每席「知识/路径/坑点/测法」提纲
3. 口语委托与 @ 并行示例
4. 人工合入与描述审阅清单
禁止建议自动 merge;禁止声称上下文税已为零。

跨域改动漏会诊复盘提纲

一次改动同时碰查询编译与权限图,只问了单一专家后合入翻车,请写复盘提纲。

改动摘要:{{change}}
翻车现象:{{symptom}}

输出:
1. 是 description 路由失败、未并行会诊,还是人跳过专家意见
2. 最小门禁补丁(触发词/清单)
3. 下次验收标准
4. 人工确认清单
不要伪造「子代理已永久正确」。

怎么做

  1. 粘贴代码库大致行数、自然域边界,以及希望并行会诊的子系统
  2. Agent 按实践帖输出:子代理 frontmatter 路由词→领域知识/路径/坑点/测法结构→并行 @ 专家提问清单
  3. 人工保留合入与领域描述审阅;Agent 不代你声称已消灭上下文税

实用提示

  • 源帖:把 frontmatter description 写成路由规则(含 MBQL/HoneySQL 等触发词),比写空泛职位名更重要
  • 与 batuhan-yika-orchestrator-two-touchpoints / nick-tune-claude-hooks-workflow-engine 不同:本条是大仓子系统专家子代理减探索税,不是编排仓两触点或 hooks 引擎
#Claude Code 子代理#Clojure#领域专家#上下文窗口#MBQL