AgentSkillsCN

agent-teams

创建和管理 Claude Code Agent Teams - 多 Agent 协作完成复杂任务。支持远程管理、快捷回复、风险评估。

中文原作
SKILL.md
--- frontmatter
name: agent-teams
description: 创建和管理 Claude Code Agent Teams - 多 Agent 协作完成复杂任务。支持远程管理、快捷回复、风险评估。

Agent Teams 专家

创建专家团队来完成复杂的编码任务。每个团队由多个 Claude Code Agent 组成,可以并行工作、协作完成任务。

核心能力

1. 创建专家团队

根据任务自动分析需要的角色,创建团队并启动对应的 Agent。

code
用户: 帮我在 /Users/admin/workspace/myapp 做代码审查
助手: 好,创建专家团队...

✅ 已创建 Team: myapp-review
   项目: /Users/admin/workspace/myapp
   成员:
   - developer (代码分析)
   - reviewer (代码审查)

2. 远程管理

通过 Telegram/WhatsApp 远程管理团队,无需打开终端。

  • 接收权限请求通知
  • 快捷回复 (y/n/1/2/3)
  • 查看团队进度
  • 分配任务

3. 风险评估

自动评估权限请求的风险等级:

风险示例显示
✅ 低ls, cat, /tmp 文件安全操作
⚠️ 中npm install, 项目文件请确认
🔴 高rm -rf, sudo, 系统文件高风险警告

MCP 工具

Team 编排工具

工具描述参数
team_orchestrate根据任务描述创建团队task_desc, project
team_spawn_agent在团队中启动 Agentteam, name, agent_type, initial_prompt
team_progress获取团队聚合进度team
team_shutdown优雅关闭团队team
team_assign_task分配任务给成员team, member, task

快捷回复工具

工具描述参数
get_pending_confirmations获取待处理确认-
reply_pending回复待处理确认reply, target (可选)
handle_user_reply处理自然语言回复reply, context (可选)

基础 Team 工具

工具描述参数
team_create创建空团队name, description, project_path
team_delete删除团队name
team_status获取团队状态name
inbox_read读取成员消息team, member
inbox_send发送消息给成员team, member, message

自然语言意图映射

创建团队

用户说的意图操作
"启动一个团队做 xxx"创建团队team_orchestrate
"帮我在 xxx 项目做 yyy"创建团队team_orchestrate
"组个团队修复 bug"创建团队team_orchestrate
"在 xxx 加个 developer"添加成员team_spawn_agent

查看状态

用户说的意图操作
"团队进度怎样"查看进度team_progress
"xxx team 在干嘛"查看状态team_status
"有什么等着我"待处理确认get_pending_confirmations
"看看消息"查看 inboxinbox_read

快捷回复

用户说的意图操作
"y" / "yes" / "是" / "好" / "可以" / "批准"批准reply_pending("y")
"n" / "no" / "否" / "不" / "取消" / "拒绝"拒绝reply_pending("n")
"1" / "2" / "3"选择选项reply_pending("1")

任务管理

用户说的意图操作
"给 developer 分配 xxx"分配任务team_assign_task
"告诉 xxx 去做 yyy"分配任务team_assign_task
"停掉团队" / "关闭 xxx team"关闭团队team_shutdown

完整示例对话

示例 1:创建专家团队完成任务

code
用户: 帮我在 /Users/admin/workspace/myapp 实现用户认证功能

助手: 好,创建专家团队处理这个任务...

✅ 已创建 Team: myapp-8234
   项目: /Users/admin/workspace/myapp
   任务: 实现用户认证功能
   成员:
   - developer (负责实现)

   developer 正在分析项目结构...

[几分钟后]

助手: ⚠️ myapp-8234/developer 请求权限

   操作: 安装依赖
   命令: npm install jsonwebtoken bcrypt
   风险: 中 ⚠️

   回复 y 允许 / n 拒绝

用户: y

助手: 已发送,developer 继续执行中...

[任务完成]

助手: ✅ myapp-8234 任务完成

   完成内容:
   - 创建 src/auth/login.ts
   - 创建 src/auth/register.ts
   - 更新 package.json
   - 添加 JWT 认证中间件

   要查看详细变更吗?

示例 2:多成员协作

code
用户: 组个团队做代码审查,需要 reviewer 和 tester

助手: 好,创建多成员团队...

✅ 已创建 Team: review-team-5678
   成员:
   - reviewer (代码审查)
   - tester (测试验证)

   reviewer 正在分析代码...
   tester 正在准备测试环境...

[几分钟后]

助手: 📊 团队进度

   review-team-5678
   ├── reviewer: 执行中 (context 35%)
   │   最近: 审查 src/api/
   ├── tester: 等待输入
   │   等待: 确认测试范围
   └── 任务: 1/3 完成

用户: 告诉 tester 只测 API 模块

助手: 已发送任务给 tester:
   "只测 API 模块"

   tester 开始执行测试...

示例 3:远程快捷回复

code
[Telegram 通知]
🔐 myapp-8234 请求权限

执行: Bash
rm -rf node_modules && npm install

风险: 高 🔴

回复 y 允许 / n 拒绝 `cam-1770529396`

用户: y

助手: 已批准 myapp-8234/developer 的请求
   developer 继续执行中...

示例 4:查看待处理请求

code
用户: 有什么等着我

助手: 2 个待处理确认:

   1. [myapp-8234/developer]
      执行: git push origin main
      风险: 中 ⚠️

   2. [review-team/tester]
      创建: test/api.test.ts
      风险: 低 ✅

   回复 "y 1" 批准第一个,或 "y" 批准全部

用户: y 1

助手: 已批准 myapp-8234/developer 的 git push 请求

CLI 命令

bash
# 在团队中启动 Agent
cam team-spawn <team> <name> [-t type] [-p prompt] [--json]

# 获取团队进度
cam team-progress <team> [--json]

# 关闭团队
cam team-shutdown <team>

# 查看待处理确认
cam pending-confirmations [--json]

# 快捷回复
cam reply <reply> [--target <id>]

角色自动分配规则

根据任务描述自动分配角色:

任务关键词分配角色
默认developer
测试、testdeveloper + tester
审查、reviewdeveloper + reviewer
重构、refactordeveloper + reviewer
文档、docsdeveloper + tech-writer

通知格式

权限请求

code
🔐 myapp 请求权限

执行: Bash
npm install && npm test

风险: 中 ⚠️

回复 y 允许 / n 拒绝 `cam-1770529396`

等待选择

code
⏸️ myapp 等待选择

1. 学习/练习项目
2. 个人实用工具
3. 演示/面试项目

回复数字选择 `cam-1770529396`

任务完成

code
✅ myapp 已完成

修改了 3 个文件:
- src/auth/login.ts (新建)
- src/auth/register.ts (新建)
- package.json (更新)

最佳实践

1. 任务描述要清晰

code
❌ "帮我改改代码"
✅ "帮我在 /Users/admin/workspace/myapp 修复登录页面的表单验证 bug"

2. 及时响应权限请求

高风险操作会阻塞 Agent,及时回复可以提高效率。

3. 使用快捷回复

  • y - 批准
  • n - 拒绝
  • 1/2/3 - 选择选项

4. 定期检查进度

code
用户: 团队进度怎样

5. 任务完成后关闭团队

code
用户: 停掉 myapp-8234 团队