Agent Transcript (代理会话记录) 是做什么的?
仅当用户明确请求时使用。默认情况下不要提供,也不要在普通的 PR 工作中询问是否要包含。仅预览请求本身并不授权发布。
本地准备
该辅助工具读取本地的 Codex、Claude、Pi 和 OpenClaw 日志;发现和渲染过程不使用网络。切勿上传原始日志。
.agents/skills/agent-transcript/scripts/agent-transcript find \
--query "$PR_TITLE $BRANCH_OR_PR_URL" --cwd "$PWD" --since-days 14
.agents/skills/agent-transcript/scripts/agent-transcript render \
--session "$SESSION_JSONL" --out /tmp/agent-transcript.md
find 默认扫描最新的 400 条匹配日志;--max-files N 可扩大本地搜索范围。将匹配结果视为候选对象,而非范围证明。
在展示、预览或插入之前,自动修剪渲染后的 Markdown。仅保留与任务相关的用户提示、可见决策、简洁的工具摘要以及结果证明。根据 PR/Issue 目标、分支和更改的文件,移除不相关的前/后轮次。丢弃系统/开发者提示、推理过程、原始工具输出、环境数据、本地路径、凭据、浏览器/会话/Cookie 详情以及认证 URL。检查修剪后的结果;辅助工具的红利不足以构成充分的披露审查。若存在未解决的敏感内容,则忽略该记录。
预览和插入
展示修剪后的 Markdown 以供请求的预览。如果请求的是 HTML,则根据该修剪内容构建本地预览。辅助工具的 preview、html 和 append-body 模式会再次渲染会话;它们不会使用编辑过的 Markdown 文件,并且可能会重新引入已移除的轮次。请勿将其未修剪的输出用作已批准的工件。
仅当用户的授权明确涵盖将该记录发布到指定的 PR/Issue 时,才插入经过检查的、范围合适的文本。生成或预览记录并不授权发布,即使普通的 PR 创建或编辑已获批准。如果缺少该范围,则展示修剪后的结果,并在插入前获得发布授权。已存在的明确授权(涵盖记录发布)无需重复确认。保留折叠的 <details> 部分,并替换现有记录标记,而非重复它们。若无安全匹配,则继续进行 PR 工作,不包含记录或占位符;当这阻碍了明确请求的记录时,解释省略的原因。不要将包含记录视为审查优先级要求。