mcpField
O
openclaw-agent-transcript

openclaw-agent-transcript

github.com/theangrypitAgent 工作流048 次安装今天更新
代码仓库

关于 openclaw-agent-transcript

用于在 PR 工作中查找、渲染、审查并有选择地分享 Agent 会话记录的技能。它强调本地处理、谨慎删减，以及发布前取得明确授权。

主要功能

  1. 01搜索本地 Agent 日志
  2. 02将会话日志渲染为 Markdown
  3. 03删减并检查记录内容
  4. 04保留部分记录提示
  5. 05发布前要求明确授权

适用场景

  1. 01预览用户要求的会话记录
  2. 02为获授权的 PR 或 issue 准备限定范围的记录
  3. 03使用合成日志验证记录处理工具

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/theangrypit/theangryskills --skill openclaw-agent-transcript

安装后在 Claude Code 中输入/openclaw-agent-transcript确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE
MIRROR.md
package.json
scripts/
agent-transcript
agent-transcript.test.mjs

详细介绍

Agent 对话记录

仅在用户明确请求对话记录或预览时使用。默认省略；日常 PR 工作中绝不主动提供，也不询问是否要包含。仅请求预览并不代表授权发布。

对于托管在 *.openclaw.ai 上的会话，如果用户请求分享，请使用原生会话分享；仅当用户明确要求提供单独的副本时，才导出单独的对话记录。根据当前会话 URL 判断托管方，而不是根据仓库 URL 或部署/测试目标。不要提供单独导出。

在本地准备

默认的文件发现/渲染会读取本地 Codex、Claude、Pi 和 OpenClaw 日志，不会发起网络调用。绝不上传原始日志。

skills/openclaw-agent-transcript/scripts/agent-transcript find \
  --query "$PR_TITLE $BRANCH_OR_PR_URL" --cwd "$PWD" --since-days 14
skills/openclaw-agent-transcript/scripts/agent-transcript render \
  --session "$SESSION_JSONL" --out /tmp/agent-transcript.md

在同步到 .agents/skills 下游仓库中，将 skills/openclaw-agent-transcript 替换为 .agents/skills/openclaw-agent-transcript。

默认情况下，find 会扫描最新的 400 个匹配日志；--max-files N 可扩大本地发现范围。将匹配项视为候选项，而非范围已确认的证明。 find 和 html 会在所有根目录中统计最多 20,000 个 JSONL 文件，包括旧文件；超过上限时会失败。--max-discovery-files N 接受正整数覆盖值；提高上限之前，优先缩小根目录范围。

每个会话的文件渲染最多从文件头尾读取 8 MiB，并解析最多 12,000 行。--max-read-bytes N 可更改字节数上限。修剪、预览和插入时，保留可见的部分对话记录提示及 sourceTruncated 统计信息；绝不能将省略的源内容描述为完整内容。这些是文件读取限制，不适用于单独的 app-server 渲染模式。短读文件系统读取会重试。遇到意外 EOF 时，应停止渲染或发现，而不是将不完整输入视为完整会话。

在展示、预览或插入之前，自动修剪渲染后的 Markdown。仅保留与任务相关的用户提示、可见决策、简短的工具摘要和结果证明。根据 PR/议题目标、分支和已更改文件，删除无关的较早/较晚轮次。删除系统/开发者提示、推理、原始工具输出、环境数据、本地路径、凭据、浏览器/会话/Cookie 详情和身份验证 URL。检查修剪后的结果；仅靠辅助工具脱敏不足以完成披露审查。若仍有未解决的敏感内容，则省略对话记录。

预览与插入

用户请求预览时，展示修剪后的 Markdown。若用户请求 HTML，则根据修剪后的内容构建本地预览。辅助工具的 preview、html 和 append-body 模式会重新渲染会话；它们不会使用经过编辑的 Markdown 文件，并可能重新引入已删除的轮次。不要将它们未经修剪的输出用作已批准的内容。

仅当用户的授权明确涵盖将该对话记录发布到指定 PR/议题时，才插入经过检查且范围明确的文本。生成或预览对话记录并不授权发布，即使普通的 PR 创建或编辑已获批准也是如此。如果缺少此范围，请展示修剪后的结果，并在插入前取得发布授权。现有明确涵盖发布对话记录的授权无需再次确认。保留折叠的 <details> 部分，并替换现有的对话记录标记，而不是重复添加。没有安全匹配项时，继续处理 PR 工作，不添加对话记录或占位符；若因此无法提供用户明确请求的对话记录，则说明省略原因。不要将包含对话记录提升为审查的优先要求。

验证辅助工具变更

node --test skills/openclaw-agent-transcript/scripts/agent-transcript.test.mjs

对于下游 .agents/skills 副本，请从 .agents/ 运行该测试命令，以确保测试中的相对辅助工具路径能够正确解析。使用合成日志和隔离的发现根目录；绝不要仅为验证此技能而发现真实用户日志。

评论

支持 Markdown