tools.md 2.52 KB

工具使用备注

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

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

1. create_goal — 创建 OKR 目标

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)

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 关联)

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. 查看目标进度

curl -s http://localhost:3000/api/goals/G-001/progress | python3 -m json.tool

5. 查看所有目标

curl -s http://localhost:3000/api/goals | python3 -m json.tool

6. 查看 Agent 列表

curl -s http://localhost:3000/api/agent/list | python3 -m json.tool

7. 查看某个 Agent 的 todo

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) → 修复源码文件内容 → 反馈最终解决方案。