用途:Team Builder 是一个交互式菜单,用于浏览和按需组合智能体团队,适合拥有多个智能体角色(markdown 文件)并想挑选其中若干用于某项任务的场景,也可跨领域临时组队(如安全 + SEO + 架构),或在决定前先浏览可用智能体。
前提:智能体文件须为包含角色提示(身份、规则、工作流、交付物)的 markdown 文件。第一个 # 标题用作智能体名称,第一段用作描述。支持子目录布局(领域由文件夹名推断)和扁平布局(领域由共享文件名前缀推断,前缀需被 2 个以上文件共享,唯一前缀归入 General;算法在第一个 - 处分割,多词领域建议用子目录布局)。
配置:智能体通过两种方式发现并按名称合并去重。主方式是运行 claude agents 获取 CLI 已知的全部智能体,包括用户、插件和内置智能体;回退方式是文件 glob,从 ./agents//.md、./agents/.md、~/.claude/agents//.md、~/.claude/agents/.md 读取。名称冲突时优先级为用户 > 插件 > 内置。
用法:先发现智能体,插件智能体带 plugin-name: 前缀,用户智能体无前缀需读取对应 markdown 提取名称与描述,内置智能体默认跳过。随后展示领域菜单(跳过空目录、显示每领域数量),接受数字、名称模糊匹配或“all from engineering”等输入。选中超过 5 个时按字母列出并要求缩小范围。确认后读取所选智能体文件,用 Agent 工具以 subagent_type: "general-purpose" 并行启动,各智能体独立运行。最后汇总结果,按智能体分组,并给出共识、冲突与建议下一步;仅选 1 个时跳过综合直接输出。
限制:仅动态发现,不硬编码列表;每队最多 5 个智能体;使用并行 Agent 调用而非 TeamCreate;单个智能体失败时内联标注并继续。若未找到智能体,提示运行 claude agents 检查配置后停止。