用途:session-debrief 读取过往 Polygraph 会话的原始日志,产出结构化、按排名排序的复盘,供正在处理新任务的父智能体判断哪些上下文相关。对被测会话保持只读:不恢复会话、不向其派生智能体、不推送分支、不创建 PR、不更新其描述。
输入:一个按相关性排序的会话列表 { sessionId, title?, url? }(rank 1 最相关;未明确排序时给定顺序即排名),以及父智能体当前任务的说明。
主要能力与用法:速度优先,父智能体在等待期间继续工作。单个会话(常见情况)直接执行“Debriefing one session”步骤,不为单会话派生子智能体。多个会话时并发扇出:为每个会话派生一个子智能体,在单条消息中同时发出以并行运行,并把会话条目、当前任务说明、单会话步骤和输出模板复制进子智能体提示;按排名顺序汇总返回,不重写。若环境无法派生子智能体,则自行按排名顺序依次执行。
命令:统一使用 ${POLYGRAPH_CLI:-polygraph}。查看元数据:${POLYGRAPH_CLI:-polygraph} session show --details <sessionId>;导出日志:${POLYGRAPH_CLI:-polygraph} session logs -s <sessionId> --all --tail none > "$TMPDIR/<sessionId>-logs.txt" 2>&1。不要用 --json,也不要用 node/python 单行命令查询转录,直接读取渲染后的文本更快。
重复工作检查:若元数据表明该会话正在做与当前任务相同的任务且未完成或近期活跃,则不读转录,立即返回复盘段,首行标注 DUPLICATE WORK IN FLIGHT,并给出状态、最后活动、一行匹配证据及恢复它能带回什么。
输出:返回一份合并复盘作为最终消息,按排名顺序,每个会话遵循模板:标题、URL、目标、经过、结果与产物、关键决策、坑与失败方法、未解决项、与当前任务的相关性。每会话约一页,不注水。
限制:引用需精确(会话 URL、PR URL、文件路径、分支名)。日志隐藏或不可用时说明(hidden: true 表示作者隐藏;steps 为空表示未上传日志),仅依据元数据、描述时间线和 PR 复盘。无推测,转录未显示原因时写“rationale not recorded”。只读,被测会话须逐字节不受影响。仅用会话数据,不读仓库代码、不运行 git 或 gh、不取 PR diff。命令出错最多重试一次,随后原样报告错误并继续,不构建绕过方案。session logs --all 仅覆盖默认角色子智能体,带角色的智能体转录保留在运行机器本地。