团队构建器

交互式菜单，用于按需浏览和组合智能体团队。适用于扁平或领域子目录的智能体集合。

使用时机

• 你拥有多个智能体角色（Markdown 文件），并想为某个任务挑选使用哪些
• 你想从不同领域（如安全 + SEO + 架构）组成一个临时团队
• 你在决定之前想浏览有哪些可用的智能体

先决条件

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

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

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

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

扁平布局 — 领域从共享的文件名前缀推断。当 2 个或更多文件共享前缀时，该前缀被视为一个领域。具有唯一前缀的文件归入“通用”领域。注意：算法在第一个 - 处分割，因此多词领域（例如 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. ./agents/**/*.md + ./agents/*.md — 项目本地智能体（两种深度）
2. ~/.claude/agents/**/*.md + ~/.claude/agents/*.md — 全局智能体（两种深度）

所有位置的结果会合并，并按智能体名称去重。项目本地智能体优先于同名的全局智能体。如果用户指定了自定义路径，则可以使用该路径替代。

工作原理

步骤 1：发现可用智能体

使用上述探测顺序遍历智能体目录。排除 README 文件。对于找到的每个文件：

• 子目录布局： 从父文件夹名称中提取领域
• 扁平布局： 收集所有文件名前缀（第一个 - 之前的文本）。一个前缀仅在 2 个或更多文件名中出现时才被视为领域（例如，engineering-security-engineer.md 和 engineering-software-architect.md 都以 engineering 开头 → 工程领域）。具有唯一前缀的文件（例如 code-reviewer.md、tdd-guide.md）归入“通用”领域
• 从第一个 # 标题 提取智能体名称。如果未找到标题，则从文件名派生名称（去掉 .md，将连字符替换为空格，转为标题大小写）
• 从标题后的第一段提取一行摘要

如果在探测所有位置后未找到智能体文件，则告知用户：“未找到智能体文件。已检查：[路径列表]。预期：上述目录之一中的 Markdown 文件。” 然后停止。

步骤 2：呈现领域菜单

可用智能体领域：
1. 工程 — 软件架构师、安全工程师
2. 营销 — SEO 专家
3. 销售 — 发现教练、外向策略师

请选择领域或指定具体智能体（例如 "1,3" 或 "security + seo"）：

• 跳过没有智能体的领域（空目录）
• 显示每个领域的智能体数量

步骤 3：处理选择

接受灵活的输入：

• 数字：“1,3” 选择工程和销售领域的所有智能体
• 名称：“security + seo” 对发现的智能体进行模糊匹配
• “all from engineering” 选择该领域内的所有智能体

如果选择的智能体超过 5 个，则按字母顺序列出它们，并要求用户缩小范围：“你选择了 N 个智能体（最多 5 个）。请选择保留哪些，或说 ‘first 5’ 来使用字母顺序的前五个。”

确认选择：

已选择：安全工程师 + SEO 专家
他们应该做什么工作？（描述任务）：

步骤 4：并行生成智能体

1. 读取每个选中智能体的 Markdown 文件
2. 如果尚未提供，则提示输入任务描述
3. 使用 Agent 工具并行生成所有智能体：
   • subagent_type: "general-purpose"
   • prompt: "{智能体文件内容}\n\n任务：{任务描述}"
   • 每个智能体独立运行 —— 无需智能体间通信
4. 如果某个智能体失败（错误、超时或输出为空），则在结果中内联注明失败（例如，“安全工程师：失败 — [原因]”），并继续处理成功智能体的结果

步骤 5：整合结果

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

• 按智能体分组的结果
• 整合部分突出显示：
  • 智能体之间的一致意见
  • 建议之间的冲突或张力
  • 推荐的后续步骤

如果只选择了 1 个智能体，则跳过整合部分，直接呈现输出。

规则

• 仅动态发现。 绝不硬编码智能体列表。目录中的新文件会自动出现在菜单中。
• 每个团队最多 5 个智能体。 超过 5 个会产生收益递减和过高的 token 使用量。在选择时强制执行。
• 并行调度。 所有智能体同时运行 —— 使用 Agent 工具的并行调用模式。
• 并行 Agent 调用，而非 TeamCreate。 此技能使用并行的 Agent 工具调用来完成独立工作。TeamCreate（Claude Code 中用于多智能体对话的工具）仅在智能体必须相互辩论或回应时才需要。

示例

用户：团队构建器

Claude：
可用智能体领域：
1. 工程 (2) — 软件架构师、安全工程师
2. 营销 (1) — SEO 专家
3. 销售 (4) — 发现教练、外向策略师、提案策略师、销售工程师
4. 支持 (1) — 执行摘要

请选择领域或指定具体智能体：

用户：security + seo

Claude：
已选择：安全工程师 + SEO 专家
他们应该做什么工作？

用户：审查我的 Next.js 电商网站，准备上线

[两个智能体并行生成，各自将其专长应用于代码库]

Claude：
## 安全工程师发现
- [发现内容...]

## SEO 专家发现
- [发现内容...]

## 整合
两个智能体均同意：[...]
张力点：安全团队推荐 CSP，该策略会阻止内联样式，而 SEO 需要内联 schema 标记。解决方案：[...]
后续步骤：[...]