Codex Orchestrator

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

工作流

1. 启动

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

bash pty:true workdir:<target_dir> background:true command:"codex exec --full-auto '<PROMPT>'"

• 存储返回的sessionId。
• 如果sessionId丢失，通过process action:list命令查找它。

2. 监控

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

# Get last 2KB of logs to see current status
process action:log sessionId:<id> limit:2000

活动迹象：

• 旋转动画或进度条更新。
• "Working...", "Thinking...", "Running..."。
• 文件编辑（Edit ...）。

阻塞迹象：

• 交互式提示（例如，“选择目录”、“批准更改 [是/否]”）。
• 超过5分钟无日志输出（进程可能卡住或在等待隐藏输入）。

3. 干预（控制）

如果 Codex 卡在某个提示处：

# Send 'y' and Enter
process action:submit sessionId:<id> data:"y"

# Send just Enter (default choice)
process action:submit sessionId:<id> data:""

如果 Codex 陷入循环或产生幻觉：

# Kill the session
process action:kill sessionId:<id>

4. 报告（通知）

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

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

标准操作程序（SOPs）

“卡住代理”协议

1. 诊断：运行process action:log sessionId:<id> limit:500。
2. 分析：它是在提问吗？它正在下载吗？
3. 行动：
   • 如果是提问：通过submit提供答案。
   • 如果下载（缓慢）：请等待。
   • 如果静默超过10分钟：发送一个"戳"（例如，提交数据："\n"以刷新提示）或终止/恢复。

"恢复"协议

如果会话终止或被杀死：

1. 运行codex resume --last或codex resume <会话ID>在一个新的后台进程中。
2. 验证它是否已拾取上下文。

日志与产物

• Codex的日志在PTY缓冲区中是临时的。
• 要获得持久日志，请指示Codex写入文件：codex exec "任务..." > codex.log 2>&1（注意：缓冲可能会延迟输出）。
• 更好的方法是：使用进程动作：记录定期快照缓冲区。