一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | agent-transcript | 合集仓库子目录名(见下方说明) |
| 所属合集仓库 | openclaw/agent-skills(OpenClaw 官方共享技能库) | GitHub API |
| 作者/维护者 | OpenClaw 官方组织(GitHub: openclaw) | GitHub API |
| 来源链接 | https://github.com/openclaw/agent-skills/tree/main/skills/agent-transcript | — |
| 许可证 | MIT | GitHub API(license 接口确认) |
| 合集仓库整体 Stars/Forks | 1,027 / 80(注:该数字属整个合集,不代表本技能自身热度,仅供了解所属仓库规模) | GitHub API |
| 该技能自身活跃度 | 自身目录 7 次提交、5 位不同作者,集中在 2026-05-25~06-14 | GitHub API(按路径过滤提交历史) |
| 最新版本 | 无独立版本号/Release(滚动提交),最近一次专属提交 2026-06-14 | GitHub API(releases 接口为空) |
| 安装方式 | 克隆仓库后运行 scripts/install-skills agent-transcript,或为 Claude Code/Codex 建立符号链接(见第十章) |
官方 README |
二、功能介绍与亮点
agent-transcript 解决的是一个越来越常见的痛点:当 PR/issue 由 Agent 代写时,人类审查者往往看不到 Agent 是怎么一步步得出这个改动的。这个技能把“安全地把会话记录附到 PR/issue 里”这件事固化成一条可复用流程。
核心亮点:
- 跨 Agent 自动发现会话:一条命令即可在本机扫描 Codex、Claude、Pi、OpenClaw 四类 Agent 的本地会话日志,自动匹配与当前 PR/issue 相关的那一份
- 严格本地化契约:SKILL.md 明文“绝不联网”,会话发现与渲染全部在本地完成,不上传原始日志
- 纵深脱敏:自动剔除系统/开发者提示词、原始工具输出、环境变量、Cookie、Token、宽泛本地路径;遇到未解决的疑似密钥或私钥,直接失败关闭而非带疑上传
- 强制人工确认关卡:插入公开 PR/issue 之前必须先询问用户,并可选先生成本地 HTML 预览供确认
- 只保留与本次改动相关的片段:自动裁剪掉同一会话里跟当前 PR/issue 无关的早期或后续任务内容,避免“日志倾倒”
- 自带自动化测试:仓库内含
agent-transcript.test.mjs,用node --test即可跑,这在 Agent Skill 里并不常见,体现了工程严谨度
三、适用场景
固定分类:工程效率与代码质量
适用于日常用 Claude Code、Codex 等 Agent 自动创建 PR 或 issue 的开发者:当改动逻辑不直观、或团队需要“这个改动是 Agent 怎么想出来的”这类可追溯性时,用这个技能给 PR/issue 正文附一段脱敏的决策摘要,帮助人类审查者更快判断优先级;也适合团队治理场景——需要为“Agent 代写的代码”建立可审计的来源记录。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | README 给出明确安装命令:mkdir -p ~/.claude && ln -sfn "$(pwd)/skills" ~/.claude/skills;SKILL.md 明确处理 Claude 会话发现 |
| Codex | 原生支持 | README 给出明确安装命令:mkdir -p ~/.codex/skills && ln -sfn "$(pwd)/skills" ~/.codex/skills/agent-skills;SKILL.md 明确处理 Codex 线程发现 |
| OpenClaw | 官方出品 | 本仓库即 OpenClaw 官方“面向编码 Agent 的共享技能”仓库;该技能已被同步进入 OpenClaw 旗舰产品 openclaw/openclaw 自带的技能集合 |
| Hermes Agent | 未验证 | 已抓取材料未提及 Hermes 支持,未为此单独搜索 |
(该技能另可发现 Pi 这类命令行 Agent 的会话日志,但 Pi 不在本项目固定跟踪的四个生态之列,仅供参考。)
五、推荐理由
随着 Agent 代写 PR/issue 越来越普遍,“这段改动到底是怎么来的”成了审查者的新痛点。agent-transcript 没有简单粗暴地把整份会话日志糊进 PR 正文,而是围绕“本地化、强脱敏、强制确认”三条线把这件事做安全:绝不联网、系统提示词与密钥类内容一律剔除、插入前必须人工点头。它体积小、逻辑可审计、自带测试,且已被验证同步进入 OpenClaw 自家 384k Star 的旗舰产品作为内置技能之一,是目前少见的、专门解决“Agent 工作可追溯性”这一具体问题的官方技能。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 仓库创建于 2026-05-22,约 10 周内积累 1,027 Stars;该子目录自身有 5 位不同作者的 7 次提交;该技能已被验证同步进入 OpenClaw 旗舰产品 openclaw/openclaw(通过内部 PR 同步),且曾有非核心团队外部贡献者提交扩展 PR(未合并,但反映真实外部关注);另被 SkillsMP、skills.sh 两个独立第三方技能目录收录 |
| 可用性 | 9 | 克隆仓库后一条命令即可安装;SKILL.md 对每个子命令(find/render/preview/append-body/html)都给了具体示例;仓库自带自动化测试文件;最近一次专属提交距今约 7 周,维护活跃;仅需本机 Node.js,无付费依赖 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.3 | 三项均值 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 本地 Node.js 脚本,仅读取本机 Agent 会话日志、写入临时预览文件,范围明确、无破坏性操作 |
| ② 运行时联网外发 | SKILL.md 明文“Never use network”,会话发现与渲染全程本地完成 |
| ③ API Key/凭据 | 不涉及任何凭据 |
| ④ 可疑指令排查 | 已完整阅读 SKILL.md 全文,未发现 prompt injection 或隐藏指令;反而内置“疑似密钥/私钥即失败关闭”的主动防护设计 |
| ⑤ 作者/组织信誉 | OpenClaw 官方组织维护,MIT 许可,已验证同步进入其旗舰产品内置技能集合 |
| ⑥ License | MIT,清晰明确 |
| ⑦ 最近维护 | 该子目录最近一次专属提交约 7 周前,仓库整体近几日仍在活跃提交 |
七、跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| session-viewer(同仓库官方姊妹技能) | 把 Agent 会话 JSONL 渲染成本地可搜索的单文件 HTML,供个人复盘调试 | 面向个人本地调试,不做脱敏分级、不涉及公开插入 PR/issue 的确认流程;agent-transcript 专门解决“如何安全地把片段公开给审查者”这一步 |
| autoreview(同仓库官方姊妹技能) | 提交前的结构化代码审查关卡,判断“改动本身对不对” | 审查对象是代码 diff 本身;agent-transcript 提供的是“改动是怎么做出来的”这层决策过程上下文,两者互补而非竞争 |
| 商业托管式 PR 审查/摘要机器人(如 CodeRabbit 等) | 云端托管,按 PR/座位订阅计费,自动生成 diff 摘要或审查意见 | 摘要来自代码差异本身,不涉及 Agent 会话的决策过程;agent-transcript 完全本地运行、免费开源,且专门针对“Agent 如何思考”这一维度 |
核心差异化:这三类工具分别覆盖“代码本身对不对”“如何本地复盘会话”“SaaS 化的差异摘要”,唯独 agent-transcript 专注在“把 Agent 的工作过程安全、脱敏地交给人类审查者”这一具体环节。
八、用户评价
该技能目前在第三方平台尚无具名用户评价:可查的第三方技能目录(SkillsMP、skills.sh)内容均为仓库文档的索引式收录,未见独立于仓库本身的用户评论或评分。
九、其他补充
曾有一位非核心团队的外部贡献者提交 PR,尝试为该技能新增自动发现 GitHub Copilot 会话的能力(该 PR 后被关闭未合并),可作为该技能吸引外部社区关注的一个佐证。仓库同时提供 scripts/validate-skills 校验脚本,用于保证仓库内各技能格式一致。
十、安装使用方式
通用(推荐):
git clone https://github.com/openclaw/agent-skills.git
cd agent-skills
scripts/install-skills agent-transcript
仅为 Claude Code 建立软链接:
mkdir -p ~/.claude && ln -sfn "$(pwd)/skills" ~/.claude/skills
仅为 Codex 建立软链接:
mkdir -p ~/.codex/skills && ln -sfn "$(pwd)/skills" ~/.codex/skills/agent-skills
安装后注意事项:安装本身无需重启。使用时在准备创建/更新 PR 或 issue 正文前,让 Agent 先执行 skills/agent-transcript/scripts/agent-transcript find --query "<PR 标题/分支/URL>" --cwd "$PWD" 定位候选会话,确认后再 render/preview,本人点头后再插入正文——全程不会未经确认就把日志写进公开内容。
十一、注意事项
- 合集仓库中的子技能:来源链接务必使用本报告给出的子目录级链接,而非仓库根链接;受欢迎程度评分未采用仓库整体 Star 数
- Hermes Agent 兼容性尚无可验证材料,如需使用请自行测试
- Best-effort 设计:若未找到安全的候选会话,技能会直接跳过、继续正常创建 PR/issue,不会强行插入占位内容
- 仓库暂无正式版本号/Release,处于滚动提交状态,长期使用建议定期拉取更新
- 依赖本机已安装 Node.js 运行时来执行配套脚本