Codex编排

技能简介

Codex编排（codex-orchestration）是 Codex 的通用编排指南。使用 update_plan 和后台 PTY 终端运行并行 codex exec worker，支持复杂任务的分解和协调。

业务背景

Codex编排帮助团队把复杂开发任务拆成多条并行轨道，让多个工作节点同时推进。主线程专注决策和最终整合，后台通过终端会话持续运行子任务，既加快交付节奏，又保持整体把控。适用于需要多线验证、独立审查或探索替代方案的研发场景。

落地案例：某功能迭代涉及接口改造、安全审查和文档更新三项工作。团队启用Codex编排：主线程制定计划后，派三个worker并行处理——一个重构接口代码，一个审计安全漏洞，一个起草技术文档。各worker在独立PTY会话中执行，完成后主线程汇总结果、协调冲突，最终输出完整交付物，避免串行等待。

能做什么

• 将工作拆分为合理轨道
• 使用并行 worker 加速
• 主线程保持合成、决策和最终输出
• 通过 PTY 会话后台运行工作
• 多种编排模式（三角审查、审查修复、侦察行动验证、分区分合并）
• 使用 update_plan 进行轻量级规划

使用说明

安装 Skill：

通过 ClawHub 安装：

clawhub install codex-orchestration

默认假设：YOLO 配置（无需批准），web 搜索启用，PTY 执行通过 exec_command 和 write_stdin，Codex 已知道其工具。

两种模式：

编排模式（默认）：拆分工作，使用并行 worker，主线程负责合成和决策。

Worker 模式（显式调用时）：以 CONTEXT: WORKER 开头，只做分配的任务，不生成其他 worker。

规划使用 update_plan：超过2步、并行工作有帮助、情况不清楚/混乱/高风险时使用。保持轻量：最多3-6步，每步一句话，恰好一步 in_progress。

并行 worker：后台运行 codex exec，使用 PTY 会话（exec_command + write_stdin）。

适用场景：侦察和映射、独立审查、网络研究、长时间检查、起草替代方案。避免编辑同一产物的并行 worker。

PTY 实践：小 yield_time_ms 启动长任务， modest max_output_tokens 然后轮询，标记每个会话，默认非阻塞，优雅关闭。

捕获 worker 输出：使用 –output-last-message 写入文件再读取，或使用 –json 过滤最终代理消息。

编排模式：A-三角审查（2-4个审查者不同角度）、B-审查修复（串行链）、C-侦察行动验证（经典）、D-分区分合并（按区域拆分）。

输入与输出

见下方输入与输出表格。

风险提示

• 需要 YOLO 配置和 web 搜索
• 并行编辑同一产物可能导致冲突
• PTY 会话可能丢失，需准备回退方案
• Worker 输出可能很大，注意上下文管理
• 原始页信息不足：缺少具体的命令示例和安装说明

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/shanelindsay/codex-orchestration/SKILL.md

来源类型：GitHub