核心用法
codex-orchestration 是一套面向 OpenAI Codex CLI 的通用任务编排框架，核心在于将复杂工作拆分为可并行执行的子任务。该 skill 定义了两种运行模式：Orchestrator 模式（默认）负责整体规划、任务分解与结果整合；Worker 模式（显式调用）专注执行单一子任务。通过 update_plan 进行轻量级规划（3-6 步），并利用后台 PTY 终端（exec_command + write_stdin）启动并行 codex exec 会话实现多 Worker 协作。
显著优点
1. 结构化并行处理：提供 6 种经过验证的编排模式（Triangulated review、Review-fix chain、Scout-act-verify、Split by sections、Research-synthesis、Options sprint），覆盖代码审查、文档撰写、调研分析等典型场景。
2. 上下文管理最佳实践：引入 "Context Pack" 概念，强制要求明确目标、非目标、约束条件、关键文件指针等，显著降低因上下文缺失导致的任务失败。
3. 输出捕获优化：推荐 --output-last-message 或 --json + jq 方式捕获 Worker 最终输出，避免上下文膨胀，保持主线程简洁。
4. 非阻塞执行设计：默认采用非阻塞启动 + 轮询机制，主线程可持续做决策合成，提升整体吞吐量。
潜在缺点与局限性
1. 学习曲线陡峭：需要理解 Orchestrator/Worker 角色边界、PTY 会话管理、计划更新时机等概念，对新手不够友好。
2. 资源消耗风险：并行 Worker 可能同时运行多个 codex exec 进程，若不加控制会导致 API 费用激增或本地资源耗尽。
3. 无内置冲突解决：明确警告 "many readers, one writer"，同一文件的并发编辑需人工协调，框架本身不提供自动合并机制。
4. 依赖 Codex CLI 生态：价值完全绑定于 OpenAI Codex CLI 工具链，无法迁移至其他 AI 编程助手。
适合的目标群体
- AI 编程工作流重度用户：已日常使用 Codex CLI，希望突破单会话上下文限制的高级用户
- 技术团队 Lead/架构师：需要协调多人/多 Agent 完成代码审查、技术方案比选等复杂任务
- 研究型开发者：涉及多源信息整合、竞品分析、技术调研等需要并行信息收集的场景
使用风险
- API 成本失控：并行 Worker 同时调用模型，若未设置并发上限，可能导致意外高额账单
- 会话丢失：PTY 会话可能因网络或进程异常退出，需实现
tmux//nohup` 等持久化兜底方案 - Worker 误解任务：文档强调 "If a worker misunderstood, do not argue. Re-run with better context"，暗示迭代成本
- YOLO 模式默认：假设配置为无需审批（no approvals），在敏感代码库中需显式调整安全策略