Agent 团队技能

通过技能、角色与任务委派机制，管理 AI Agent 团队成员。

团队成员

列出所有团队成员信息：

python3 scripts/team.py list

常见使用场景：

• 确认当前团队负责人（Leader）是谁
• 在分配任务前，查找具备特定专长的成员
• 审查团队结构及可用角色

输出示例：

## 团队成员

**Alice** ⭐ 负责人 — 协调、规划、决策
- agent_id: alice
- 专长: 任务拆解、综合决策、Agent 协调
- 不擅长: 代码开发、投资分析

**Bob** — 后端开发工程师 — 后端、API、数据库
- agent_id: bob
- 专长: Python、Go、PostgreSQL
- 不擅长: 前端、设计

# 总计：2 名成员，负责人：Alice (alice)

⚡ 任务委派规则（核心原则）

委派时机：

1. 首先完成准备工作：理解需求、明确目标、确认约束条件
2. 进入实施阶段时：识别最适合执行该任务的成员，并将任务委派给其负责
3. 委派后跟进：检查产出质量，确保满足原始需求

委派上下文（需传递的内容）：
每次委派时，必须提供以下内容：

• 原始需求与成功标准
• 相关背景与上下文信息
• 你制定的执行计划及任何限制条件
• 期望的输出格式

委派失败应对机制（Failover）：
若被委派成员未能完成任务：

1. 首次尝试：退回并附上具体反馈，要求修订
2. 二次尝试：调整上下文后，重新委派给另一位成员
3. 三次尝试：升级至负责人处理，或由你自己执行

🔄 任务处理流程（最高优先级）

计划 → 执行 → 检查 → 行动

重要提示：这是一个持续改进循环。若在“行动”阶段发现任务未完成，则需返回“计划”阶段重新开始。

1. 计划 — 规划阶段

目标：充分准备，避免盲目执行

• 理解需求并澄清疑问
• 定义目标与成功标准
• 识别风险并明确责任人
• 制定可落地的执行计划

2. 执行 — 实施阶段

目标：按计划推进，同时保持进度可控

• 根据责任归属，自行执行或进行委派
• 跟踪进展与关键决策点

3. 检查 — 验证阶段

目标：对照原始需求验证结果

• 验证完整性与质量是否达标
• 检查是否符合既定规范与标准

4. 行动 — 决策阶段

目标：总结成果并决定后续步骤

• ✅ 任务已完成 → 流程终止
• ❌ 任务未完成 → 返回“计划”阶段重新启动流程

新增/更新成员

添加新成员或更新现有成员信息：

python3 scripts/team.py update 
  --agent-id "agent-001" 
  --name "Alice" 
  --role "Backend Developer" 
  --is-leader "true" 
  --enabled "true" 
  --tags "backend,api,database" 
  --expertise "python,go,postgresql" 
  --not-good-at "frontend,design" 
  --load-workflow "true" 
  --group "backend-team"

参数说明：

• --agent-id：成员唯一标识符（必填）
• --name：成员姓名（必填）
• --role：角色/职位（必填）
• --is-leader：是否为团队负责人（必填，值为 true/false；每支团队仅允许一名负责人）
• --enabled：启用状态（true/false，必填）
• --tags：标签，逗号分隔（必填）
• --expertise：专长技能，逗号分隔（必填）
• --not-good-at：不擅长领域，逗号分隔（必填）
• --load-workflow：是否加载工作流提示词（选填，true/false；默认：负责人设为 true，其余成员为 false）
• --group：分组名称，用于归类（选填，用于组织和管理团队成员）

重置数据

清空全部团队数据，恢复至初始状态：

python3 scripts/team.py reset

输出：

Team data has been reset.

⚠️ 警告：该操作不可逆。~/.agent-team/team.json 中的所有数据将被永久删除。

数据存储

团队数据保存在 ~/.agent-team/team.json 文件中，全局共享。若目录不存在，系统将自动创建。

常见使用场景

为某项任务匹配合适成员

# 列出团队成员，寻找具备相关专长的成员
python3 scripts/team.py list
# 在输出中查找匹配的标签或专长字段

更换团队负责人

设置新负责人时，原负责人身份将自动移除：

python3 scripts/team.py update --agent-id "alice" --name "Alice" --role "Team Lead" --is-leader "true" --enabled "true" --tags "coordination,planning" --expertise "management,decision-making" --not-good-at "specialized-development"

临时禁用某位成员

设置 --enabled "false" 可禁用成员，无需删除其记录：

python3 scripts/team.py update --agent-id "bob" --name "Bob" --role "Backend Developer" --is-leader "false" --enabled "false" --tags "backend,api" --expertise "Python,Go" --not-good-at "frontend"

新增团队成员

python3 scripts/team.py update --agent-id "charlie" --name "Charlie" --role "Frontend Developer" --is-leader "false" --enabled "true" --tags "frontend,ui" --expertise "React,TypeScript" --not-good-at "backend,database"

错误处理

数据文件未找到

若 ~/.agent-team/team.json 不存在，脚本将返回空团队状态（不抛出错误）。

JSON 格式无效

若数据文件损坏，脚本将记录错误日志并返回空状态：

[agent-team] Error loading team data: 

缺失必需参数

运行 update 命令但未提供必需参数时：

error: the following arguments are required: --agent-id, --name, --role, --is-leader, --enabled, --tags, --expertise, --not-good-at

单负责人约束

每支团队仅允许存在一名负责人。设置新负责人时，系统将自动取消前任负责人的身份：

Note: Removed leader status from 

参考文档

插件安装指南 — 如何安装与配置 OpenClaw 插件