agent-transcript 是什麼？

`agent-transcript` 技能提供一種安全、可控的方式，將 AI 代理（如 Codex、Claude、Pi、OpenClaw）的對話記錄（transcript）擷取並插入到 GitHub 的 PR 或 issue 中。此技能僅在使用者明確要求時才運作，預設情況下絕不主動提供或詢問是否包含對話記錄。它會先在本地掃描相關的日誌檔，根據 PR 標題、分支或 URL 找出匹配的工作階段，然後渲染成 Markdown 格式。為了確保資訊安全，技能會自動裁切原始渲染結果，僅保留與任務相關的使用者提示、可見的決策、簡潔的工具摘要及最終成果，並移除系統提示、推理過程、原始工具輸出、環境變數及認證資訊等敏感內容。最後，唯有獲得使用者明確的發佈授權，才會將裁切後的對話記錄以 `<details>` 折疊區塊的形式插入指定的 PR 或 issue，避免機密資訊外洩。

相容平台✓Claude Code✓Codex CLI~Cursor

npx skills add https://github.com/clawdbot/clawdbot/tree/main/.agents/skills/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 工作，不加入對話記錄或佔位符；當此情況阻止了明確要求的對話記錄時，請說明省略原因。請勿將包含對話記錄列為審查優先事項。

agent-transcript