mcpField
A
agent-transcript

agent-transcript

github.com/openclawAgent 工作流393.3k325 次安装今天更新
代码仓库

关于 agent-transcript

agent-transcript 是一项用于查找和整理 Agent 会话记录的技能,适用于明确提出的预览或发布请求。它搜索本地日志,并要求先筛选内容、排除无关或敏感信息,再进行分享。

主要功能

  1. 01搜索本地 Codex、Claude、Pi 和 OpenClaw 日志
  2. 02将选定会话渲染为 Markdown
  3. 03按任务范围筛选内容
  4. 04分享前检查敏感信息

适用场景

  1. 01查找与 PR 或分支相关的会话日志
  2. 02为预览请求准备经过筛选的记录
  3. 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 工作,不添加对话记录或占位内容;如果因此无法提供用户明确请求的对话记录,则说明省略原因。不要将包含对话记录提升为审查优先级要求。

评论

支持 Markdown