Codex Orchestrator

该技能提供了一套工作流，用于监督在后台进程中运行的 Codex 编程代理。

工作流

1. 启动（启动）

始终在后台 PTY 会话中启动 Codex，以保持交互性，同时不阻塞主代理。

bash pty:true workdir: background:true command:"codex exec --full-auto ''"

• 保存返回的 sessionId。
• 若 sessionId 丢失，可通过 process action:list 查找。

2. 监控（观察）

定期检查进度（例如通过 cron 或手动执行）。

# 获取最近 2KB 的日志以查看当前状态
process action:log sessionId: limit:2000

正常运行迹象：

• 旋转动画或进度条持续更新。
• 显示 “Working...”、“Thinking...” 或 “Running...” 等提示信息。
• 发生文件编辑（如 Edit ...）。

卡顿迹象：

• 出现交互式提示（例如 “Select directory”、“Approve change [y/n]”）。
• 超过 5 分钟无日志输出（进程可能已挂起，或正在等待不可见的输入）。

3. 干预（控制）

若 Codex 卡在某个提示符处：

# 发送 'y' 及回车符
process action:submit sessionId: data:"y"

# 仅发送回车符（使用默认选项）
process action:submit sessionId: data:""

若 Codex 出现循环执行或幻觉行为：

# 终止该会话
process action:kill sessionId:

4. 报告（通知）

当达到重要里程碑或任务完成时：

1. 汇总已完成的工作（如修改的文件、通过的测试）。
2. 通知用户。

标准操作规程（SOP）

“卡住的代理”协议

1. 诊断：运行 process action:log sessionId: limit:500。
2. 分析：是否正在提问？是否正在下载？
3. 操作：
   • 若正在提问：通过 submit 提供答案。
   • 若正在下载（速度较慢）：等待。
   • 若静默超过 10 分钟：发送一次 “poke”（例如 submit data:"n" 刷新提示），或终止后重新恢复（kill/resume）。

“恢复”协议

若会话异常终止或被主动终止：

1. 在新的后台进程中运行 codex resume --last 或 codex resume 。
2. 验证其是否成功恢复上下文。

日志与产物

• Codex 日志在 PTY 缓冲区中为临时存在，会话结束后即丢失。
• 如需持久化日志，可指示 Codex 将输出写入文件：codex exec "task..." > codex.log 2>&1（注意：缓冲机制可能导致输出延迟）。
• 更优方式：使用 process action:log 定期快照缓冲区内容。