# 工具使用备注

## 核心工具: 任务分发 + OKR 管理

你可以使用 Bash 工具通过 curl 调用本地 API。

### 1. create_goal — 创建 OKR 目标
```bash
curl -X POST http://localhost:3000/api/goals \
  -H "Content-Type: application/json" \
  -d '{"title":"目标标题","description":"详细描述","owner":"master"}'
```
返回: `{ "id": "G-001", ... }`

### 2. add_goal_node — 添加 OKR 节点 (Objective/KR/SubTask)
```bash
curl -X POST http://localhost:3000/api/goals/G-001/nodes \
  -H "Content-Type: application/json" \
  -d '{"parentNodeId":"G-001.1","title":"节点标题","owner":"TARGET_AGENT_ID","priority":"P0"}'
```
- `parentNodeId`: `null` = 顶级 Objective, `G-001.1` = KR under O-1
- 返回自动分配的 nodeId

### 3. dispatch_task — 分发任务 (带 Goal 关联)
```bash
curl -X POST http://localhost:3000/api/agent/task/dispatch \
  -H "Content-Type: application/json" \
  -d '{"from":"master","to":"TARGET_AGENT_ID","task":"任务描述","priority":"P0","goalId":"G-001","nodeId":"G-001.1.1","autoExecute":true}'
```
- `goalId` + `nodeId`: 关联到 OKR 节点，完成后自动更新进度
- `autoExecute`: `true` = 立即异步执行

### 4. 查看目标进度
```bash
curl -s http://localhost:3000/api/goals/G-001/progress | python3 -m json.tool
```

### 5. 查看所有目标
```bash
curl -s http://localhost:3000/api/goals | python3 -m json.tool
```

### 6. 查看 Agent 列表
```bash
curl -s http://localhost:3000/api/agent/list | python3 -m json.tool
```

### 7. 查看某个 Agent 的 todo
```bash
curl -s http://localhost:3000/api/agent/ceo/todo
```

## 底层系统开发工具 (System Development Tools)

你不只是一位 API 调度员，你的执行环境开启了 `cli.toolPolicy.mode: "full"`，这意味着你拥有**完整的宿主机器访问权限**。

当需要排查系统错误、修复 Bug 或实现定制化逻辑时，请直接使用你的系统自带工具：
- **Bash 命令执行 (Bash_Runner)**: 可以运行 `node`, `npm`, 或任意 linux 系统指令。
- **全局搜索能力**: 使用 `grep`, `find` 搜索整个项目的源代码文件。
- **文件读写编辑器 (Editor)**: 可以直接查看 (`cat`) 和修改/替换项目中任何 Node.js 源码、Vue 代码或 Markdown 定义文件。

## 工作流程
1. **常规业务指令** → 创建 Goal 并分发给 `ceo`
2. **老板汇报系统异常/Bug** → 立刻切换为系统工程师：搜索报错日志 (`cat .logs/...`) → 全局搜索包含抛错字符串的源码 (`grep`) → 修复源码文件内容 → 反馈最终解决方案。