用途:agent-transcript 用于在用户明确要求时,为 GitHub PR/issue 准备代理会话转录。默认不使用,普通 PR 工作中不应主动提供或询问是否加入转录;仅请求预览也不等于授权发布。
主要能力:本地读取 Codex、Claude、Pi、OpenClaw 日志,发现与渲染均不联网,禁止上传原始日志。find 默认扫描最新 400 条匹配日志,可用 --max-files N 扩大本地发现范围;匹配结果只是候选,不代表范围已确认。render 将指定会话输出为 Markdown。
使用方式:
skills/agent-transcript/scripts/agent-transcript find
--query "$PR_TITLE $BRANCH_OR_PR_URL" --cwd "$PWD" --since-days 14
skills/agent-transcript/scripts/agent-transcript render
--session "$SESSION_JSONL" --out /tmp/agent-transcript.md
在下游仓库若同步到 .agents/skills,将 skills/agent-transcript 替换为 .agents/skills/agent-transcript。
裁剪与审查:展示、预览或插入前必须自动裁剪渲染出的 Markdown,只保留与任务相关的用户提示、可见决策、简短工具摘要和验证结果;依据 PR/issue 目标、分支和改动文件移除无关的前后轮次。删除系统/开发者提示、推理过程、原始工具输出、环境数据、本地路径、凭据、浏览器/会话/cookie 细节和认证 URL。裁剪后需人工检查,辅助脱敏不足以完成披露审查;存在未解决的敏感内容时应省略转录。
预览与插入:请求预览时展示裁剪后的 Markdown;若要求 HTML,则基于该裁剪内容构建本地预览。helper 的 preview、html、append-body 模式会重新渲染会话,不消费已编辑的 Markdown,可能重新引入已删除轮次,不应将其未裁剪输出作为批准产物。仅当用户授权明确覆盖向指定 PR/issue 发布该转录时,才插入经检查且范围明确的文本;生成或预览不构成发布授权。缺少该范围时,先展示裁剪结果并取得发布授权。已有明确授权覆盖转录发布时无需重复确认。保留折叠的 <details> 区块,替换已有转录标记而非重复添加。无安全匹配时继续 PR 工作,不加转录或占位符;若因此无法完成明确请求的转录,应说明省略原因。不要将包含转录宣传为审查优先要求。
限制:仅限本地日志,不联网发现或渲染;不提供自动发布授权;未提供收费、平台支持范围等更多信息。