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

安全规则

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

文件操作

• 自主创建的文件只写到运行时坐标（提示词开头）给出的绝对路径里，不要写死相对路径 （cwd 是任务态目录，一次性、会被清理，裸相对路径等于没交付）
• 不要修改 config.json（由系统管理）

任务分发 API

dispatch_task — 向下级 Agent 分发任务

curl -X POST http://localhost:3010/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 — 向上级汇报任务完成

curl -X POST http://localhost:3010/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 列表

curl -s http://localhost:3010/api/agent/list