Codex + Hermes 集成研究全览

Codex 核验（2026-10-09）：本机 codex-cli 0.161.0 的 codex --help / codex exec --help 未提供 --acp、--stdio、--full-auto 或 --yolo；本次只检查帮助，没有调用模型。ACP 集成须使用明确支持该协议的适配器并核对版本，不能直接把这些参数交给当前 Codex CLI。worktree 只隔离工作文件，不建立权限或网络隔离。OpenCode Go 的价格、账户模型、质量统计和已安装技能均为 7 月采集内容，未证明当前额度、免费权限或因果关系。

一、核心集成架构

方案 A: Hermes 总调度 + Codex 执行编码（主方案）

Manas(总调度) → Codex CLI(编码) → git push/PR

• 通过 terminal(codex exec "任务", pty=true) 调用
• 后台模式用于长时间编码：background=true + pty=true
• 适用场景：功能开发、重构、PR 审查、批量修 bug

方案 B: Kanban Codex Lane

• Hermes Kanban worker 将 Codex 作为隔离实现通道
• Hermes 拥有完整生命周期：创建任务 → 启动 Codex → 审查 diff → 运行测试 → 完成/阻塞
• Codex 输出不被信任，必须经过 Hermes 审查
• 使用 git worktree 隔离工作区
• 详见技能 kanban-codex-lane

方案 C: ACP 传输协议

• delegate_task 工具支持 acp_command 参数，可直接派生子 agent 到 Codex CLI
• 配置：使用经验证的 Codex ACP 适配器；当前本机 Codex CLI 不支持原列 --acp --stdio，不能直接这样配置
• 支持 max_spawn_depth 嵌套深度

---

二、相关研究 & 生态工具

1. Kanban Codex Lane (Hermes 原生技能)

• 定义 Hermes+Codex 双通道约定的轻量级技能
• Codex 是单输入通道，不持有 Kanban 状态写权限
• 使用 git worktree 隔离，own review 机制

2. codex-keysmith (⭐223)

• Codex CLI 指令文件安全安装工具
• 安全优先：默认 dry-run，必须显式 —yes
• 自动备份被修改文件
• 路径安全：拒绝不安全文件名
• 链接：https://github.com/Jia-Ethan/codex-keysmith

3. CodexPro (⭐284)

• 通过 MCP 将 ChatGPT Developer Mode 变成本地编码 Agent
• .ai-bridge handoff 协议：写 plan 文件给 Codex/OpenCode 执行
• watch-handoff watcher 监听 plan 变化自动执行
• 三种工具模式 (minimal/standard/full) + 三种写入模式
• 链接：https://github.com/rebel0789/codexpro

4. Codex 橙皮书 (⭐327)

• 详尽的中文 Codex 使用指南（186KB README）
• Plugin/Skill/MCP 分层解释：
  • Plugin = 能力安装包
  • Skill = 固定工作方法（怎么做）
  • MCP = 外部工具接口（连什么）
• 自动化：Codex 按规则定期巡查项目（AI 值班工程师）
• 链接：https://github.com/bozhouDev/codex-orange-book

5. OpenCode Go Provider

• 2026-07 采集时记为 Manas/Alaya 主 provider（当前状态未核验）
• 基于 opencode.ai/zen/go/v1，deepseek-v4-flash
• Beta 阶段：首月 $5，续费$10/月
• 用量限制按美元价值计，非请求数

6. Codex 质量退化风险 (2026-07 发现)

• GPT-5.5 的 reasoning_output_tokens 出现聚类现象（516/1034/1552 固定阈值）
• 从 2 月到 5 月急剧恶化（0.11% → 53.30%）
• 复杂任务错误率与此强相关
• 启示：多提供商 fallback 的重要性——当检测到模型持续输出低质量结果时自动切换

---

三、代码协作模式

3.1 单次编码

terminal(command="codex exec '实现功能X'", workdir="~/project", pty=true)

3.2 后台长时间任务

terminal(command="codex exec --sandbox workspace-write '重构模块'", background=true, pty=true)
# process action=poll/log/wait 监控

3.3 并行多分支修 bug

git worktree add -b fix/issue-N /tmp/issue-N main
codex exec --sandbox workspace-write '修 bug N' (在每个 worktree 中)
git push / gh pr create

3.4 PR 自动审查

codex review --base origin/main
gh pr comment N --body '<review>'

---

四、落地建议

关联

• omnigent-meta-harness — meta-harness 方案

• llm-cost-optimization-routing — 多 provider 路由

• codex-hermes-integration-plan — 集成行动计划

• knowledge-network-map — 知识网络地图

• knowledge-base-index — 知识体系索引