git:20260927.5ce4cb3 to git:20260928.c1decad

36 added, 8 removed. Audit A to A.

---

name: agent-fleet

- description: 按全局 CLAUDE.md §2 路由表默认使用：写代码/修 bug/补测试派 Codex，调研/文档/翻译派 Gemini，擦边题材派 Grok，判断节点派 JEV；用户点名 agent-fleet、便宜模型或其他模型时也用。编程优先本机 Codex CLI 的 GPT-6 Sol，中等思考；简单任务轻度。本地 CLI 通过 Claude Agent SDK 运行可读写文件和执行命令的 Agent；使用前核对目标模型当前配置、真实 Key 状态、工作目录信任边界和任务归属。第三方模型响应需按任务验收，不能只凭 CLI 返回 ok 判成功。

+ description: 按全局 CLAUDE.md §2 路由表默认使用：大部分任务（写代码、修 bug、补测试、调研、报告、通用任务）优先派本机 Codex GPT-6，文案/翻译一律派 Gemini 且正面写，Grok 可分担擦边或其他任务，判断节点派 JEV；用户点名 agent-fleet、便宜模型或其他模型时也用。编程优先本机 Codex CLI 的 GPT-6 Sol，中等思考；简单任务轻度。本地 CLI 通过 Claude Agent SDK 运行可读写文件和执行命令的 Agent；使用前核对目标模型当前配置、真实 Key 状态、工作目录信任边界和任务归属。第三方模型响应需按任务验收，不能只凭 CLI 返回 ok 判成功。

---

# agent-fleet

本机多模型任务入口：日常使用 `fleet`；给定 brief，执行者直接完成任务并留下简报、结果和日志。

## 命令速查

| 命令 | 用途 |

|---|---|

- | `fleet copy brief.md` | Gemini 文案、翻译、调研 |

+ | `fleet copy brief.md` | Gemini 文案、翻译 |

| `fleet grok brief.md` | Grok 调研 |

| `fleet bulk brief.md` | Gemini 批量处理 |

| `fleet gpt brief.md` | 托管 GPT 任务 |

- | `fleet code brief.md [--low] [--cwd dir]` | 本机 Codex 编码 |

+ | `fleet code brief.md [--low] [--cwd dir]` | 本机 Codex GPT-6：默认入口 |

| `fleet code brief.md --review` | 本机 Codex 只读审查 |

| `fleet judge state.txt questions.json` | JEV 结构化判断 |

| `fleet run --model name --prompt "任务"` | 旧的完整模型入口 |

| `fleet run-many --config batch.json` | 批量任务 |

| `fleet status` / `fleet tail [--follow]` | 看任务和日志 |

| `fleet say latest "消息"` | 向运行中的任务插话 |

| `fleet stop latest` / `fleet resume latest` | 收尾或续跑 |

| `fleet list-models` / `fleet help` | 看配置或用法 |

`brief` 若是现存文件路径就读取内容，否则作为任务文本。短命令和 `run` 默认当前目录、`--max-turns 500`、安静写日志；`--verbose` 输出进度。`--cwd`、`--max-turns`、`--system-prompt` 等显式参数可覆盖默认值。旧的 `agent-fleet run ...` 写法仍可用。完整结果在 `~/.agent-fleet/runs/*.result.md`，过程在同名 `.log`；stdout 默认只给简报。

+ ## 分配原则

+ 1. **默认 GPT-6**：大部分任务优先 `fleet code`（本机 Codex `gpt-6-sol`），包括编码、调研、报告、数据整理和其他通用任务；不再按任务细分挑模型。

+ 2. **文案必须 Gemini**：页面文案、营销/产品文案、翻译、多语言、母语校对一律 `fleet copy`，不派 GPT-6。文案一律正面表述：讲能做什么、带来什么好处，不贬低竞品、不写恐吓式或负面对比。

+ 3. **Grok 可分担**：擦边题材，以及其他调研或 GPT-6 不可用时的备选，用 `fleet grok`。

+ 4. **JEV 只做判断**，Claude 只做 CLAUDE.md §2 明确归它的事。

+ **派给 GPT-6 只做被点名的那件事（硬性）**

+ - 让它做功能，它就只写功能代码。做完就交，不做任何没被要求的事。

+ - **默认不做**（除非 brief 逐项点名要求）：写测试或测试脚本、先写测试再写功能、加安全校验/防御代码/权限边界/输入校验/异常兜底、重构、抽象封装、加配置项、写文档或注释、改无关文件、装依赖、提交/推送/部署/发布、调用外部写接口。

+ - 已有的测试和构建：brief 要求跑才跑，只跑、不补。

+ - 拿不准要不要做的，一律不做，在最终回复里用一行列出「建议但未做」。

+ - brief 里逐字写上：「只做本 brief 列出的事。不写测试、不加安全防护或边界校验、不重构、不做任何未点名的额外工作或 action；拿不准就不做，在回复里列一行建议。」

+ - 验收时出现未点名的产物（多出的测试文件、防御代码、无关改动）算越界，判不合格。

+ **衡量 GPT-6**：便宜（ChatGPT 会员额度，不额外花钱），足够聪明，但啰嗦。给它的 brief 必须写：最终回复只给结论、改动路径和验证结果，约 15 行内；长内容写进文件；不许扩大范围。面向读者的文字不交给它。

## 模型路由

| 短名 | 实际模型 | 适合 |

|---|---|---|

- | `copy` | `kollab-gateway-copy`（Gemini） | 文案、翻译 |

- | `grok` | `kollab-gateway-research` | 调研 |

+ | `copy` | `kollab-gateway-copy`（Gemini） | 文案、翻译（必须走这里，正面写） |

+ | `grok` | `kollab-gateway-research` | 擦边题材、其他调研、GPT-6 备选 |

| `bulk` | `kollab-gateway-bulk` | 批量转换 |

| `gpt` | `kollab-gateway-gpt-sol` | GPT 托管任务 |

- | `code` | 本机 Codex `gpt-6-sol` | 编码；默认 medium，`--low` 为 low |

+ | `code` | 本机 Codex `gpt-6-sol` | **默认执行者**：编码、调研、报告、通用任务；默认 medium，`--low` 为 low |

| `judge` | `jev` | 分类、选择、打分 |

`code` 在本机 Codex 缺失、登录失效或模型明确不支持时，自动改走 `kollab-gateway-gpt-sol`。选择以当前配置和实际结果为准；查看其他模型用 `fleet list-models`。Codex 审查范围见 [编程与 review](references/codex-coding.md)。

## 简报与验收

| verdict | 含义与处理 |

|---|---|

| `ok` | 正常结束；按任务核对产物和测试 |

| `partial` | 到轮数上限但已有改动；验收现有产物或 `resume` |

| `suspect` | 疑似假成功或要求改动却零改动；核对结果和 diff |

| `needs-review` | JEV 置信度不足；人工核对 |

| `fail` | 执行失败、空结果或裸控制 token；看错误后修复 |

| `stopped` | 已收尾中断；检查已完成部分 |

`ok` 只说明进程结果，不能代替任务验收；`dirty` 和 `commits` 也可能包含同一工作树里其他人的改动。细节见 [README](../README.md)。

## brief 写法

- 开头说明目标和真实交付物。

- 写明允许改的文件、不可碰的范围、并行工作边界。

+ - 涉及浏览器的步骤必须写「用 opencli（`opencli browser <会话名>`），禁止 Playwright/agent-browser」。

- 写明必须跑的检查和完成标准。

- 需要改文件时加 `--expect-changes`。

- 最终回复要列出改动与验证结果，不能只说“已完成”。

## 安全边界

- 把 `--cwd` 指向的目录及其项目配置当作不可信输入核对；网关路径使用 Claude Agent SDK 的 `bypassPermissions`，执行者可读写文件和运行命令，没有工具调用沙箱。只对可信目录派单，保护他人改动，不打印密钥。默认执行者系统提示禁止调用 Agent/Task 工具或再次转派，额外 `--system-prompt` 会追加其后。`fleet code` 默认 `workspace-write`，`--review` 使用 `read-only`；详见 [README 的安全边界](../README.md#安全边界)。

+ 把 `--cwd` 指向的目录及其项目配置当作不可信输入核对；网关路径使用 Claude Agent SDK 的 `bypassPermissions`，执行者可读写文件和运行命令，没有工具调用沙箱。只对可信目录派单，保护他人改动，不打印密钥。默认执行者系统提示禁止调用 Agent/Task 工具或再次转派，额外 `--system-prompt` 会追加其后。`fleet code` 默认 `danger-full-access`（可读写任意路径、可联网，含本机代理），`--review` 使用 `read-only`；详见 [README 的安全边界](../README.md#安全边界)。

## JEV judge

- `fleet judge state.txt questions.json [--json]`：state 为文本或 `.json` 文件；questions 是 `{ "key": { "type": "noul"|"choice"|"score", "instructions": "..." } }`。JEV 只做结构化判断，不生成自由文本，也不能用 `run`。旧写法 `fleet judge --model jev --state-file state.txt --questions-file questions.json` 仍可用。

+ `fleet judge state.txt questions.json [--json]`：state 为文本或 `.json` 文件；questions 是 `{ "key": { "type": "noul"|"choice"|"score", "instructions": "..." } }`。`choice` 和 `score` 必须带 `criteria`。JEV 只做结构化判断，不生成自由文本，也不能用 `run`。旧写法 `fleet judge --model jev --state-file state.txt --questions-file questions.json` 仍可用。

+ `questions.json` 可按需选用其中一种或组合使用：

+ ```json

+ {

+ "is_urgent": { "type": "noul", "instructions": "这条消息是否紧急？" },

+ "team": { "type": "choice", "instructions": "该由哪个团队处理？", "criteria": { "billing": "付款或退款", "technical": "故障或集成" } },

+ "frustration": { "type": "score", "instructions": "客户有多沮丧？", "criteria": ["平静", "沮丧", "愤怒"] }

+ }

+ ```