---

name: team-builder description: 用于组建和调度并行团队的交互式代理选择器 origin: community

Team Builder

用于按需浏览和组建代理团队的交互式菜单。支持扁平或域名子目录代理集合。

何时使用

• 你有多个代理角色（markdown 文件），想选择用于某个任务的代理
• 你想从不同领域组建临时团队（例如 Security + SEO + Architecture）
• 你想在决定之前浏览可用的代理

前提条件

代理文件必须是包含角色提示（身份、规则、工作流、交付物）的 markdown 文件。第一个 # 标题 用作代理名称，第一段用作描述。

支持扁平和子目录两种布局：

子目录布局 — 域名从文件夹名推断：

agents/
├── engineering/
│   ├── security-engineer.md
│   └── software-architect.md
├── marketing/
│   └── seo-specialist.md
└── sales/
    └── discovery-coach.md

扁平布局 — 域名从共享文件名前缀推断。当2个以上文件共享前缀时，该前缀视为域名。具有唯一前缀的文件归入"General"。注意：算法在第一个 - 处分割，因此多词域名（如 product-management）应使用子目录布局：

agents/
├── engineering-security-engineer.md
├── engineering-software-architect.md
├── marketing-seo-specialist.md
├── marketing-content-strategist.md
├── sales-discovery-coach.md
└── sales-outbound-strategist.md

配置

代理通过两种方式发现，按代理名称合并去重：

1. claude agents 命令（主要方式） — 运行 claude agents 获取 CLI 已知的所有代理，包括用户代理、插件代理（如 everything-claude-code:architect）和内置代理。这自动覆盖 ECC marketplace 安装，无需路径配置。
2. 文件 glob（备选，用于读取代理内容） — 从以下位置读取代理 markdown 文件：
   • ./agents/**/*.md + ./agents/*.md — 项目本地代理
   • ~/.claude/agents/**/*.md + ~/.claude/agents/*.md — 全局用户代理

较早的来源在名称冲突时优先：用户代理 > 插件代理 > 内置代理。如果用户指定了自定义路径，也可使用。

工作原理

步骤1：发现可用代理

运行 claude agents 获取完整代理列表。解析每一行：

• 插件代理以 plugin-name: 为前缀（如 everything-claude-code:security-reviewer）。使用 : 后面的部分作为代理名称，插件名称作为域名。
• 用户代理无前缀。从 ~/.claude/agents/ 或 ./agents/ 读取对应的 markdown 文件以提取名称和描述。
• 内置代理（如 Explore、Plan）除非用户明确要求包含，否则跳过。

对于从 markdown 文件加载的用户代理：

• **子目录布局：**从父文件夹名提取域名
• **扁平布局：**收集所有文件名前缀（第一个 - 之前的文本）。前缀仅在出现于2个或更多文件名中时才视为域名（如 engineering-security-engineer.md 和 engineering-software-architect.md 都以 engineering 开头 → Engineering 域名）。具有唯一前缀的文件（如 code-reviewer.md、tdd-guide.md）归入"General"
• 从第一个 # 标题 提取代理名称。如果未找到标题，从文件名派生名称（去除 .md，将连字符替换为空格，首字母大写）
• 从标题后的第一段提取单行摘要

如果运行 claude agents 和探测文件位置后未找到代理，通知用户："未找到代理。运行 claude agents 验证你的设置。"然后停止。

步骤2：展示域名菜单

Available agent domains:
1. Engineering — Software Architect, Security Engineer
2. Marketing — SEO Specialist
3. Sales — Discovery Coach, Outbound Strategist

Pick domains or name specific agents (e.g., "1,3" or "security + seo"):

• 跳过无代理的域名（空目录）
• 显示每个域名的代理数量

步骤3：处理选择

接受灵活输入：

• 数字："1,3" 选择 Engineering 和 Sales 的所有代理
• 名称："security + seo" 对已发现的代理进行模糊匹配
• "all from engineering" 选择该域名中的所有代理

如果选择超过5个代理，按字母顺序列出并要求用户缩小范围："你选择了 N 个代理（最多5个）。选择要保留的，或说 'first 5' 使用前五个。"

确认选择：

Selected: Security Engineer + SEO Specialist
What should they work on? (describe the task):

步骤4：并行启动代理

1. 读取每个选定代理的 markdown 文件
2. 如果尚未提供，提示输入任务描述
3. 使用 Agent 工具并行启动所有代理：
   • subagent_type: "general-purpose"
   • `prompt: