Appearance
Everything Claude Code Team Builder Skill 是一项专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）设计的交互式多 Agent 团队组建与并行任务派发能力。它允许开发者在项目中动态浏览、筛选、组合多个专业 AI 代理（Agent），并一键并行分配任务，极大提升多领域协作和复杂问题解决的效率。本文将详解其使用场景、配置步骤、实际操作流程及输出示例，帮助你在实际项目中高效用好这一 Skill。
Everything Claude Code Team Builder Skill：交互式多 Agent 团队配置与并行任务派发
在 AI 辅助编程逐步深入团队协作、跨领域审查与多任务并行的今天，如何灵活、高效地组织和调度多个专业 Agent 成为开发者关注的核心问题之一。Team Builder Skill 正是为此而生：它提供了一个交互式菜单，让你可以像组建真实团队一样，按需浏览、筛选、组合来自不同领域的 AI 代理，并一键并行派发任务，最终自动合成多视角的结果报告。
本指南将结合 Everything Claude Code 的生产级 Agent/Skill/Hook 体系，详细介绍 Team Builder Skill 的实际用法、典型场景、配置细节与注意事项，帮助你充分发挥 AI 团队的协同效能。如果你还不熟悉 ECC 的整体架构和 Agent 体系，建议先阅读 Everything Claude Code 完全指南 和 Claude Code 快速上手指南。
1. Team Builder Skill 解决了什么问题？
传统做法的局限：
- 需要多 Agent 协作时，往往只能手动查找、复制粘贴每个 Agent 配置，逐一派发任务，流程繁琐且易出错。
- 很难直观了解当前有哪些可用 Agent，尤其是随着项目扩展，Agent 数量激增时。
- 多领域任务（如安全+SEO+架构评审）需要跨目录、跨插件动态组队，手动操作极其低效。
- 并行派发和结果综合耗时，缺乏自动化。
Team Builder Skill 带来的提升：
- 一键动态发现所有可用 Agent（支持本地、全局、插件等多来源，自动去重）。
- 交互式菜单浏览、筛选、组合 Agent，支持按领域、名称、模糊匹配等多种方式选人。
- 最多支持 5 人团队，自动并行派发任务，失败自动提示并不中断整体流程。
- 自动合成各 Agent 输出，突出共识、冲突与下一步建议，极大提升团队决策效率。
2. 何时触发 Team Builder Skill？
Team Builder Skill 适用于以下典型场景：
- 你有多个 Agent（如安全审查、架构师、SEO、代码评审等），需要为某个复杂任务临时组建跨领域团队。
- 希望先浏览所有可用 Agent，再决定组队方案。
- 需要对同一项目/代码/需求进行多角度并行评审，并获得综合性建议。
- 需要快速对比不同 Agent 的观点、发现潜在冲突或协同机会。
触发方式：
- 在 Claude Code 等支持 ECC 的助手中输入
team builder或相关命令，即可激活交互式团队组建流程。
3. Step by Step：实际操作流程
步骤 1：自动发现所有可用 Agent
Team Builder Skill 会自动通过两种方式发现所有 Agent：
claude agents命令：首选，自动获取所有已知 Agent（包括本地、插件、内置），无需手动配置路径。- Markdown 文件扫描：回退方案，自动读取
./agents/和~/.claude/agents/下的所有.md文件，支持扁平或子目录结构。
目录结构支持：
- 子目录模式（推荐，适合多领域/多团队项目）：
agents/ engineering/ security-engineer.md software-architect.md marketing/ seo-specialist.md sales/ discovery-coach.md - 扁平模式（适合小型项目）：
agents/ engineering-security-engineer.md marketing-seo-specialist.md sales-discovery-coach.md
注意： 只需新增/修改 Agent 文件，无需手动同步列表，Team Builder Skill 会动态实时发现。
步骤 2：交互式领域与 Agent 菜单
Skill 会自动归类所有 Agent 到不同领域（如 Engineering、Marketing、Sales），并展示如下菜单：
Available agent domains:
1. Engineering (2) — Software Architect, Security Engineer
2. Marketing (1) — SEO Specialist
3. Sales (2) — Discovery Coach, Outbound Strategist
Pick domains or name specific agents (e.g., "1,3" or "security + seo"):选择方式灵活：
- 输入数字（如
1,3）选择多个领域下所有 Agent - 输入关键词（如
security + seo）模糊匹配指定 Agent - 输入
all from engineering选择某领域全部 Agent
Skill 会自动跳过无 Agent 的领域，并显示每个领域下的 Agent 数量和名称。
步骤 3：确认与精细筛选
- Skill 会根据你的选择列出所有被选中的 Agent。
- 如果超过 5 个，自动要求缩小范围（如“first 5”或手动勾选）。
- 确认后，Skill 会询问本次团队要完成的具体任务描述。
Selected: Security Engineer + SEO Specialist
What should they work on? (describe the task):步骤 4：并行派发任务
- Skill 会自动读取每个 Agent 的 Markdown 文件，拼接任务描述，采用并行方式调用 Agent 工具（
subagent_type: "general-purpose"）。 - 每个 Agent 独立运行，无需互相通信，最大化并行效率。
- 若某 Agent 执行失败（如超时、报错、无输出），会在结果中直接标注原因，不影响其他 Agent 正常输出。
步骤 5：自动合成与输出报告
- Skill 会自动收集所有 Agent 的输出，按 Agent 分组展示。
- 自动生成 Synthesis 综合分析区，突出各 Agent 共识、冲突与下一步建议。
- 若仅有 1 个 Agent，直接输出该 Agent 结果，无需合成。
实际输出示例：
## Security Engineer Findings
- [安全审查结论...]
## SEO Specialist Findings
- [SEO 优化建议...]
## Synthesis
共识：两位专家均建议优化页面结构，提升用户体验。
冲突：安全建议启用 CSP 禁止内联样式，SEO 需保留结构化数据内联脚本。
建议：采用 nonce-based CSP，兼顾安全与 SEO。4. 常见配套 Agent 与 Skill 协作关系
Team Builder Skill 适合与以下专业 Agent 组合使用：
- Security Reviewer Agent：安全审查
- Code Reviewer Agent：代码质量评审
- Architect Agent：架构决策
- SEO Specialist Agent：SEO/数据库优化等
也可以与 Agentic Engineering Skill、Agent Eval Skill 等协作，实现更复杂的多 Agent 评测与工程流。
5. 注意事项与最佳实践
- 动态发现：Agent 列表绝不硬编码，新增/删除文件自动生效。
- 团队规模建议：最多 5 个 Agent，防止 token 浪费与信息冗余。
- 并行调度：所有 Agent 独立并行执行，适合多角度独立评审，不适合需要团队内部辩论的场景（此时建议用 TeamCreate 工具）。
- Agent 文件规范：每个 Agent 必须有
# Heading（作名称）和首段简介，便于菜单展示和筛选。 - 多领域协作：建议优先采用子目录结构，便于后期扩展和领域归类。
6. 输出示例
plaintext
User: team builder
Claude:
Available agent domains:
1. Engineering (2) — Software Architect, Security Engineer
2. Marketing (1) — SEO Specialist
3. Sales (2) — Discovery Coach, Outbound Strategist
Pick domains or name specific agents:
User: security + seo
Claude:
Selected: Security Engineer + SEO Specialist
What should they work on?
User: Review my Next.js e-commerce site before launch
[并行运行两个 Agent，独立输出]
Claude:
## Security Engineer Findings
- 检查到 CSP 配置缺失，建议启用 nonce-based CSP
- 检查到部分 API 暴露敏感信息
## SEO Specialist Findings
- 建议完善结构化数据，提升产品页排名
- 指定 canonical URL，防止重复收录
## Synthesis
共识：均建议优化页面结构和安全配置
冲突：CSP 配置需兼容结构化数据脚本
建议：采用 nonce-based CSP，兼顾安全与 SEOFAQ
Q: Team Builder Skill 支持哪些类型的 Agent？ A: 支持本地、全局用户自定义 Agent、插件 Agent（如 everything-claude-code:architect）、以及所有符合 Markdown 规范的专业 Agent，自动归类、去重。
Q: 如何限制团队成员数量？为什么有上限？ A: Skill 默认最多支持 5 个 Agent 并行，超过会提示缩小范围。这样可以防止 token 浪费和输出冗余，保证每个 Agent 的贡献都能被有效吸收。
Q: Team Builder Skill 和 TeamCreate 有什么区别？ A: Team Builder Skill 用于独立并行派发任务、收集多视角输出；TeamCreate 适合需要 Agent 之间相互辩论、协作的场景，两者适用场景不同。