用途:把 tmux 窗口中的编码智能体 worker 整理为可见、可审计的 lane,明确状态与下一步动作。
适用场景:监控或汇总一个 tmux worker lane;在 manager 冷启动后重建 worker 状态;发现重复、空闲、等待、阻塞或高风险工作;在不盲目改动的前提下协调多个编码智能体窗格。
工作流程:先确定 lane 范围,优先用明确的 lane 编号,否则从当前名为 L<number> 的 tmux 窗口推断,未经操作者扩大范围不检查其他 lane。采集状态:运行 python3 scripts/lane_snapshot.py --lane <number>;若不在活动 tmux 会话内需加 --session <name>。若子命令未包含其恢复线程 ID,可依据单独核实的证据重复 --thread L<number>.<pane>=<thread-id>。加 --json 获得机器可读输出;仅在需要有限增量状态时加 --cursor-file <path>,辅助脚本默认不写入持久状态。
交叉核对:窗格标题只是弱证据,需将 pane ID 解析到 shell PID、后代 Codex PID、精确线程 ID、状态数据库 rollout 路径和最新 turn。共享 cwd 及 CI、failed、running 等泛化词不能确立归属。身份缺失或冲突视为未知,绝不作为恢复目标。
分类与干预:用最新精确 turn 及变化的事件、工具、token 计数分类每个窗格;先前报错后完成的最新 turn 属已完成而非阻塞。报告读取的字节数和截断状态。保守干预:先检查再引导,避免重复的重检查,未经明确范围不得杀死或改动其他窗格,优先可逆动作与定向命令。汇总时每窗格一行:mission、state、evidence、blocker、next action,再加一句 manager 判断关注点。设计 lane 职责或升级策略时读取 references/factory-model.md。
输入:tmux 会话名、lane 编号或 L<number> 窗口、可选日志关键词与捕获深度、可选精确 pane/thread 声明与有限 cursor 路径、可选操作者提供的 worker 任务映射。输出:当前 pane ID、shell PID、后代智能体 PID、精确线程与 rollout 快照;带证据的每窗格状态分类;每文件和总读取日志字节数、cursor 模式与截断状态;简洁 manager 汇总与安全下一步。限制:具体收费、价格、平台与效果资料暂未提供。