tools.md 3.39 KB

工具使用备注

核心工具: 命令行工具 (lemon.js)

为了保证稳定性,严禁直接手写 curl 请求。请统一在根目录使用 node bin/lemon.js 或 ./bin/lemon.js 封装好的业务指令:

1. create_company — 创建新公司实例

node bin/lemon.js company create --id <company_id> --name <company_name> --desc <company_description>

例如: node bin/lemon.js company create --id lemonv --name "LemonV" --desc "AI 短剧公司"

2. hire_agent_for_company — 为公司招聘 Agent

node bin/lemon.js company hire --id <company_id> --role <role_id> --type <cxo|specialist> --name <Agent昵称>

例如: node bin/lemon.js company hire --id lemonv --role ceo --type cxo --name "首席执行官"

3. GET /api/company/list — 查看所有公司

node bin/lemon.js company list

OKR 管理工具

4. create_goal — 创建 OKR 目标

node bin/lemon.js goal create --title <目标标题> --desc <详细描述> --owner <负责人ID>

返回中会包含 id(例如 G-001)。

5. add_goal_node — 添加 OKR 节点 (Objective/KR/SubTask)

node bin/lemon.js goal add-node --goal <目标ID> --parent <父节点ID,顶级填null> --title <标题> --owner <负责人:必须结合公司前缀> --priority <P0|P1>

例如: node bin/lemon.js goal add-node --goal G-001 --parent null --title "O1: 提升营收" --owner lemonv:ceo --priority P0

6. dispatch_task — 分发任务 (带 Goal 关联)

node bin/lemon.js task dispatch --from master --to <TARGET_AGENT_ID> --task <任务描述> --priority P0 --goal <目标ID> --node <目标节点ID>
  • to: 目标 Agent ID。注意:如果是属于整个系统的全局 Agent,直接使用其 ID(如 agent-creator)。但如果要分配给某个特定公司的员工(例如为 lemonv 公司招聘的 ceo),你必须加上公司名前缀拼装组合(例如 lemonv:ceo),绝不能简写为 ceo,否则会引发串行 BUG!不要越权和串台!

7. 查看目标进度

node bin/lemon.js goal status --goal <目标ID>

8. 查看所有目标

node bin/lemon.js goal list

9. 查看系统全局变量或状态

(建议直接读取环境变量或配置文件,或使用 lemon 封装的其它命令,具体视情况组合。)

10. 查看某个 Agent 的待办任务 (todo.md)

直接使用 cat 读取对应文件:

cat data/lemonv/agents/ceo/todo.md

底层系统开发工具 (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) → 修复源码文件内容 → 反馈最终解决方案。