mcpField
A
agent-transcript

agent-transcript

github.com/steipeteAgent 工作流7.4k96 次安装2 天前更新
代码仓库

关于 agent-transcript

用于从本地 Codex、Claude、Pi 和 OpenClaw 日志中整理指定范围的预览或转录文本。它要求删除无关内容并检查敏感信息，且仅在获准后发布。

主要功能

  1. 01搜索本地 Agent 日志
  2. 02将会话渲染为 Markdown
  3. 03按任务范围裁剪内容
  4. 04检查输出中的敏感信息
  5. 05发布前要求获得授权

适用场景

  1. 01准备用户请求的转录预览
  2. 02筛选与拉取请求相关的日志内容
  3. 03删除无关或敏感信息
  4. 04将获准的转录插入 PR 或 issue

安装

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

$npx skills add https://github.com/steipete/agent-scripts --skill agent-transcript

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

附带文件scripts/agent-transcript

详细介绍

Agent 对话记录

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

本地准备

此辅助工具会读取本地 Codex、Claude、Pi 和 OpenClaw 日志；发现和渲染过程均不使用网络。绝不要上传原始日志。

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。

默认情况下，find 会扫描最新的 400 条匹配日志；--max-files N 可扩大本地发现范围。将匹配项视为候选内容，而非范围依据。

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

预览和插入

用户请求预览时，展示精简后的 Markdown。如果用户请求 HTML，则使用精简后的内容生成本地预览。辅助工具的 preview、html 和 append-body 模式会再次渲染会话；它们不会读取经过编辑的 Markdown 文件，并可能重新引入已删除的对话轮次。不要将未经精简的输出用作已批准的成品。

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

评论

支持 Markdown