用途:当需要调查另一个已接入 cmux-team 的项目(如 ~/git/mado、~/git/Dear)时,按固定流程读取其 .team/ 目录,交叉比对 manager.log、traces.db、task-state.json 与 cmux surface 画面,定位故障原因。该技能是 cmux-team 开发仓库内的开发者技能,仅在本仓库工作树内有效,其他项目的 Claude Code 会话无法使用。
主要能力:用 --project-root 免 cd 读取目标项目状态,如 cmux-team status、trace-task、trace-hooks;收集并 grep manager.log、查看 task-state.json 与 conductors 状态;查询 traces.db 的 task_sessions 与 hook_signals 表,并顺藤摸瓜打开 Claude Code 原始 JSONL 日志;结合 cmux identify / read-screen / list-status / tree 查看 surface;最后按时间戳做时序列相关。
使用方式:先确定 TARGET 并确认 .team/ 存在,再依次执行日志收集、trace 查询或 hook_signals 查询、surface 读取与时序对齐。查 traces.db 时以只读方式打开,例如 sqlite3 "file:$TARGET/.team/traces/traces.db?mode=ro" -readonly,或先 cp 快照再读。
适用场景:Conductor 不回到 idle、Agent 完成未被检测等问题的初步切分,判断 hook 是否送达、Manager 是否处理。
限制:目标 .team/ 视为只读,禁止在目标 CWD 执行 create-task、update-task、close-task 等写入命令;跟踪 traces.db 需注意 WAL 锁;traces.db 仅作会话索引,不含对话内容,且无 FTS5 全文搜索;会话经过压缩后 assistant 消息中的 tool_use 会丢失,JSONL 中可能查不到命令记录。该技能不随 npm publish 或插件分发。