关于 agent-transcript
agent-transcript 是一项用于查找和整理 Agent 会话记录的技能,适用于明确提出的预览或发布请求。它搜索本地日志,并要求先筛选内容、排除无关或敏感信息,再进行分享。
主要功能
- 01搜索本地 Codex、Claude、Pi 和 OpenClaw 日志
- 02将选定会话渲染为 Markdown
- 03按任务范围筛选内容
- 04分享前检查敏感信息
适用场景
- 01查找与 PR 或分支相关的会话日志
- 02为预览请求准备经过筛选的记录
- 03在获准发布前检查记录内容
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ openclaw/ openclaw --skill agent-transcript安装后在 Claude Code 中输入/agent-transcript确认已加载。
附带文件scripts/agent-transcript
详细介绍
Agent 对话记录
仅在用户明确请求对话记录或预览时使用。默认省略;在常规 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 工作,不添加对话记录或占位内容;如果因此无法提供用户明确请求的对话记录,则说明省略原因。不要将包含对话记录提升为审查优先级要求。