
关于
交互式代理选择器,用于组建和调度并行团队。
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
配置
代理通过两种方式发现,按代理名称合并去重:
claude agents命令(主要方式) — 运行claude agents获取 CLI 已知的所有代理,包括用户代理、插件代理(如everything-claude-code:architect)和内置代理。这自动覆盖 ECC marketplace 安装,无需路径配置。- 文件 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:并行启动代理
- 读取每个选定代理的 markdown 文件
- 如果尚未提供,提示输入任务描述
- 使用 Agent 工具并行启动所有代理:
subagent_type: "general-purpose"- `prompt:
兼容工具
Claude CodeCursor
标签
AI与机器学习
