# 通用工具规范 (所有 Agent 继承)

## 安全规则
- 不要在日志中输出 API Key
- 不要在 memory 中存储密码或敏感信息
- API Token 使用 env 变量，不要硬编码

## 文件操作
- 所有自主创建的文件仅限在 workspace/ 内操作
- 不要修改 config.json（由系统管理）

## 任务分发 API

### dispatch_task — 向下级 Agent 分发任务
```bash
curl -X POST http://localhost:3000/api/agent/task/dispatch \
  -H "Content-Type: application/json" \
  -d '{"from":"YOUR_AGENT_ID","to":"TARGET_AGENT_ID","task":"任务描述","priority":"P1","goalId":"G-001","nodeId":"G-001.1.1","autoExecute":true}'
```

参数:
- `from`: 你自己的 Agent ID
- `to`: 目标 Agent ID
- `task`: 任务描述
- `priority`: `P0`(紧急) | `P1`(重要) | `P2`(普通)
- `goalId`: 关联的 OKR 目标 ID (可选，如 `G-001`)
- `nodeId`: 关联的 OKR 节点 ID (可选，如 `G-001.1.1`)
- `autoExecute`: `true` = 立即异步执行

### report_task — 向上级汇报任务完成
```bash
curl -X POST http://localhost:3000/api/agent/task/report \
  -H "Content-Type: application/json" \
  -d '{"taskId":"T-xxx","from":"YOUR_AGENT_ID","to":"SENDER_AGENT_ID","status":"done","summary":"完成摘要","goalId":"G-001","nodeId":"G-001.1.1"}'
```

状态: `done` | `failed` | `blocked`
如果带 goalId + nodeId，会自动更新 OKR 进度。

### 查看 Agent 列表
```bash
curl -s http://localhost:3000/api/agent/list
```