介绍
# Agents Manager
集中管理所有 Clawdbot 代理:发现可用代理,分析其能力,定义路由层级(谁可以指派给谁,谁向谁汇报),并通过升级链智能路由新任务。
## 🤖 针对代理
### 系统提示词(复制粘贴) 将此提示词提供给任何代理以教会它们此技能: > “你拥有 `agents-manager` 技能。使用它来发现对等代理(`scan_agents`),检查权限(`can_assign.js`),并路由任务。始终遵循握手协议:在指派前检查 `requires_approval`。如果为 true,请先询问我。”
### 核心规则 1. **发现:** 在假设某个代理存在之前,始终检查 `scan_agents.js`。 2. **权限:** 在未检查 `can_assign.js` 或 `agent-registry.md` 的情况下,切勿指派任务。 3. **协议:** - 如果 `requires_approval` 为 FALSE -> 直接指派。 - 如果 `requires_approval` 为 TRUE -> 询问主管(人类或代理)。
## 👤 针对人类
### 快速开始 | 目标 | 命令 | |------|---------| | **设置** | `node scripts/setup_wizard.js` (先运行此命令!) | | **列表** | `node scripts/scan_agents.js` | | **健康** | `node scripts/health_check.js` | | **统计** | `node scripts/log_analyzer.js` |
### 1. 代理发现与分析 列出并分析所有代理,以了解其能力和路由配置。
```bash # List all agents node {baseDir}/scripts/scan_agents.js
# Profile specific agent node {baseDir}/scripts/generate_card.js <agent_id> ```
### 2. 验证与健康 确保你的代理生态系统健康且有效。
```bash # Validate registry integrity node {baseDir}/scripts/validate_registry.js
# Check permissions (Agent A -> Agent B) node {baseDir}/scripts/can_assign.js <source_id> <target_id>
# Visualize hierarchy node {baseDir}/scripts/visualize_agents.js ```
### 3. 任务路由与升级 使用 `references/task-routing-rules.md` 定义任务如何在代理之间流转。
- **直接:** 代理 → 代理(如果 `can_assign_to` 允许) - **握手:** 如果 `requires_approval` 为 true,则请求批准。 - **升级:** 助手 → 主管 → 人类
## 资源
- **[agent-profile-schema.md](references/agent-profile-schema.md)**:包含路由和卡片字段的标准配置文件。 - **[agent-registry.md](references/agent-registry.md)**:所有代理的实时注册表。 - **[task-routing-rules.md](references/task-routing-rules.md)**:决策矩阵和握手协议。
## 脚本
- `scan_agents.js`:发现工具 - `validate_registry.js`:架构验证器 - `can_assign.js`:权限检查器 - `generate_card.js`:代理卡片生成器 - `visualize_agents.js`:层级可视化工具 - `scan_agents.js`:发现工具 - `validate_registry.js`:架构验证器 - `can_assign.js`:权限检查器 - `generate_card.js`:代理卡片生成器 - `visualize_agents.js`:层级可视化工具 - `health_check.js`:状态监控器(健康/缓慢/离线) - `log_analyzer.js`:性能统计(任务/成功率) - `setup_wizard.js`:交互式配置工具