# 工具使用备注

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

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

### 1. create_company — 创建新公司空壳
```bash
node bin/lemon.js company create --id <company_id> --name <company_name> --desc <company_description>
```
例如: `node bin/lemon.js company create --id ainews --name "AI News Inc." --desc "专注AI领域的自动化新闻采编与分发公司"`
**❗ 重要：此命令仅创建公司空壳和底层元 Agent，不会自动创建 CEO 等业务员工！你必须在创建后使用 company hire 命令手动招募 CEO。**

### 2. hire_agent_for_company — 为公司招聘 Agent
```bash
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 — 查看所有公司
```bash
node bin/lemon.js company list
```

### 3b. company templates — 查看所有可用 Agent 模板
```bash
node bin/lemon.js company templates
```
显示所有可用的高级模板（如 `scrapling_crawler`、`qa-judge` 等），HR 招聘时会用到。

### 3c. company fire — 辞退 Agent
```bash
node bin/lemon.js company fire --id <company_id> --role <role_name>
```
停止心跳 → 归档工作目录 → 从公司名单移除

## OKR 管理工具

### 4. create_goal — 创建 OKR 目标
```bash
node bin/lemon.js goal create --title <目标标题> --desc <详细描述> --owner <负责人ID>
```
返回中会包含 `id`（例如 `G-001`）。

### 5. add_goal_node — 添加 OKR 节点 (Objective/KR/SubTask)
```bash
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 关联)
```bash
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. 查看目标进度
```bash
node bin/lemon.js goal status --goal <目标ID>
```

### 8. 查看所有目标
```bash
node bin/lemon.js goal list
```
### 9. 查看系统全局变量或状态
(建议直接读取环境变量或配置文件，或使用 `lemon` 封装的其它命令，具体视情况组合。)

### 10. 查看某个 Agent 的待办任务 (todo.md)
直接使用 cat 读取对应文件：
```bash
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. **常规业务指令（创建公司）** → `company create` (建壳) → `company hire --role ceo` (招聘统帅) → `task dispatch --to <ID>:ceo` (下达组织裂变和战略目标指令)
2. **常规业务指令（给现有公司下任务）** → `task dispatch --to <公司ID>:ceo`
3. **老板汇报系统异常/Bug** → 立刻切换为系统工程师：搜索 → 修复源码 → 反馈