团队构建器
用于按需浏览和组合智能体团队的交互式菜单。适用于扁平化或按领域子目录组织的智能体集合。
使用场景
- 你拥有多个智能体角色(markdown 文件),并希望为某项任务选择使用哪些智能体
- 你希望从不同领域(例如,安全 + SEO + 架构)临时组建一个团队
- 你希望在决定前先浏览有哪些可用的智能体
前提条件
智能体文件必须是包含角色提示(身份、规则、工作流程、交付物)的 markdown 文件。第一个 # Heading 用作智能体名称,第一段用作描述。
支持扁平化和子目录两种布局:
子目录布局 — 领域从文件夹名称推断:
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
配置
智能体目录按顺序探测,结果会被合并:
./agents/**/*.md+./agents/*.md— 项目本地智能体(两种深度)~/.claude/agents/**/*.md+~/.claude/agents/*.md— 全局智能体(两种深度)
所有位置的结果会合并,并按智能体名称去重。同名情况下,项目本地智能体优先于全局智能体。如果用户指定了自定义路径,则使用该路径代替。
工作原理
步骤 1:发现可用智能体
使用上述探测顺序在智能体目录中进行全局搜索。排除 README 文件。对于找到的每个文件:
- 子目录布局: 从父文件夹名称提取领域
- 扁平化布局: 收集所有文件名前缀(第一个
-之前的文本)。一个前缀只有在出现在 2…