跳转至

团队构建器

按需浏览和配置 Agent 团队的交互式菜单。支持按扁平结构或域子目录组织的 Agent 集合。

使用场景

  • 存在多个 Agent 角色（Markdown 文件），希望为某个任务选择使用哪个 Agent 时
  • 希望从不同域（例如：安全 + SEO + 架构）组建临时团队时
  • 在决定之前希望浏览可用 Agent 时

前提条件

Agent 文件必须是包含角色、Prompt（身份、规则、工作流、产出）的 Markdown 文件。第一个 # Heading 用作 Agent 名称，第一个段落用作描述。

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

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

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

扁平布局 —— 域从共享的文件名前缀推断。当两个或更多文件共享相同前缀时，该前缀被视为域。具有唯一前缀的文件被归类到“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

配置

Agent 目录按顺序搜索，结果合并：

  1. ./agents/**/*.md + ./agents/*.md —— 项目本地 Agent（两种深度）
  2. ~/.claude/agents/**/*.md + ~/.claude/agents/*.md —— 全局 Agent（两种深度）

所有位置的结果合并，并按 Agent 名称去重。同名时，项目本地 Agent 优先于全局 Agent。如果用户指定自定义路径，则改用该路径。

工作原理

步骤 1：发现可用 Agent

使用上述搜索顺序在 Agent 目录中执行全局搜索。排除 README 文件。对于找到的每个文件：

  • 子目录布局： 从父文件夹名提取域
  • 扁平布局： 收集所有文件名前缀（第一个 - 之前的文本）。仅当前缀出现在两个或更多文件名中时，才作为域合格（例如：engineering-security-engineer.md 和 engineering-software-architect.md 都以 engineering 开头 → Engineering 域）。具有唯一前缀的文件（例如：code-reviewer.md、tdd-guide.md）被归类到“General”类别
  • 从第一个 # Heading 提取 Agent 名称。如果找不到标题，则从文件名派生名称（移除 .md，将连字符替换为空格，并转换为标题大小写）
  • 从标题后的第一个段落提取一行摘要

搜索所有位置后仍未找到 Agent 文件时，通知用户：“未找到 Agent 文件。已检查：[已搜索路径列表]。预期：这些目录中的 Markdown 文件。”然后停止。

步骤 2：显示域菜单

利用可能なエージェントドメイン：
1. エンジニアリング — ソフトウェアアーキテクト、セキュリティエンジニア
2. マーケティング — SEOスペシャリスト
3. セールス — ディスカバリーコーチ、アウトバウンドストラテジスト

ドメインを選択するか、特定のエージェントを指定してください（例：「1,3」または「security + seo」）：
  • 跳过 Agent 数量为零的域（空目录）
  • 显示每个域的 Agent 数量

步骤 3：处理选择

接受灵活输入：

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

如果选择了 5 个或更多 Agent，按字母顺序列出并要求筛选：“已选择 N 个 Agent（最多 5 个）。请选择保留哪些，或者说 'first 5' 使用字母顺序的前 5 个。”

确认选择：

選択済み：セキュリティエンジニア + SEOスペシャリスト
どのようなタスクに取り組む予定ですか？（タスクを説明してください）

步骤 4：并行启动 Agent

  1. 读取每个所选 Agent 的 Markdown 文件
  2. 如果尚未提供，请求任务描述
  3. 使用 Agent 工具并行启动所有 Agent：
  4. subagent_type: "general-purpose"
  5. prompt: "{agent file content}\n\nTask: {task description}"
  6. 每个 Agent 独立运行——无需 Agent 之间通信
  7. 如果 Agent 失败（错误、超时或空输出），内联记录失败（例如：“Security Engineer: failed — [原因]”），并继续处理成功 Agent 的结果

步骤 5：整合结果

收集所有输出并呈现统一报告：

  • 按 Agent 分组的结果
  • 在整合部分强调：
  • Agent 之间的共识
  • 建议之间的冲突或矛盾
  • 推荐的下一步

如果仅选择 1 个 Agent，则跳过整合部分并直接呈现输出。

规则

  • 仅动态发现。 不要硬编码 Agent 列表。目录中的新文件会自动显示在菜单中。
  • 每个团队最多 5 个 Agent。 超过 5 个会导致收益递减和 Token 使用量增加。在选择时强制。
  • 并行分发。 所有 Agent 同时运行——使用 Agent 工具的并行调用模式。
  • 并行 Agent 调用（不是 TeamCreate）。 此技能使用并行 Agent 工具调用来处理独立任务。仅当 Agent 需要讨论或相互回答时，才需要 TeamCreate（用于多 Agent 对话的 Claude Code 工具）。

示例

ユーザー: team builder

Claude:
利用可能なエージェントドメイン：
1. エンジニアリング (2) — ソフトウェアアーキテクト、セキュリティエンジニア
2. マーケティング (1) — SEOスペシャリスト
3. セールス (4) — ディスカバリーコーチ、アウトバウンドストラテジスト、プロポーザルストラテジスト、セールスエンジニア
4. サポート (1) — エグゼクティブサマリー

ドメインを選択するか、特定のエージェントを指定してください：

ユーザー: security + seo

Claude:
選択済み：セキュリティエンジニア + SEOスペシャリスト
どのようなタスクに取り組む予定ですか？

ユーザー: リリース前に私のNext.jsのeコマースサイトをレビューしてほしい

[2つのエージェントが並列で起動され、それぞれがコードベースに専門知識を適用する]

Claude:
## セキュリティエンジニアの発見事項
- [発見内容...]

## SEOスペシャリストの発見事項
- [発見内容...]

## 統合分析
両エージェントが同意：[...]
衝突点：セキュリティが推奨するCSPがインラインスタイルをブロックし、SEOはインラインのschemaマークアップを必要とする。解決策：[...]
次のステップ：[...]

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 ev/ECC