Agent Transcript
針對 OpenClaw PR/issue 主體的盡力而為、僅限本機的來源追溯。在用於代理建立的 GitHub PR 或 issue 工作流程中,在建立/更新主體之前使用。
合約
- 絕不使用網路。工作階段探索僅讀取本機代理日誌。
- 絕不上傳原始日誌。先渲染已編輯的 Markdown。
- 在將記錄日誌加入 GitHub PR/issue 主體之前,務必先詢問使用者。
- 告知使用者已編輯的工作階段日誌有助於審查者,並可讓 PR 更容易被優先處理。
- 在插入前提供本機 HTML 預覽。如果使用者想要預覽,請開啟它並等待確認後再加入該區段。
- 對於未解決的機密、私鑰、瀏覽器/工作階段/Cookie 詳細資訊或驗證 URL,失敗關閉。
- 捨棄系統/開發者提示詞、原始工具輸出、推理過程、環境變數、Cookie、權杖、以及廣泛的本機路徑。
- 保留使用者提示詞、助手可見的決策、簡潔的工具摘要,以及測試/驗證結果。
- 在顯示、預覽或插入公開主體之前,自動修剪已渲染的記錄。切勿僅因為
render或append-body產生了原始完整工作階段渲染,就將其貼到 PR/issue 主體中。 - 移除與 PR/issue 工作無關的工作階段對話輪次。使用 PR/issue 標題、分支名稱、已變更的檔案和陳述的目標作為範圍;省略較早/較晚的無關任務,即使它們在同一個工作階段日誌中。
- 僅盡力而為:如果找不到安全的記錄,PR/issue 建立必須繼續進行。
- 僅在插入真實記錄時才加入
## Agent Transcript區段。切勿加入預留位置的記錄標題或文字,例如「已產生已編輯的本機記錄預覽,但未包含。」 - 使用可折疊的
<details>區段,並更新現有標記,而不是複製區段。
輔助工具
skills/agent-transcript/scripts/agent-transcript --help
尋找可能的本機工作階段:
skills/agent-transcript/scripts/agent-transcript find \
--query "$PR_TITLE $BRANCH_OR_PR_URL" \
--cwd "$PWD" \
--since-days 14
find 預設會掃描最新的 400 個符合條件的本機 JSONL 日誌,範圍涵蓋 Codex、Claude、Pi 和 OpenClaw 代理工作階段。使用 --max-files N 進行更廣泛的本機搜尋。
在同步共用技能至 .agents/skills 的下游儲存庫中,將 skills/agent-transcript 取代為 .agents/skills/agent-transcript。
渲染 PR/issue 主體區段:
skills/agent-transcript/scripts/agent-transcript render \
--session "$SESSION_JSONL" \
--out /tmp/agent-transcript.md
在本機預覽一個候選工作階段:
skills/agent-transcript/scripts/agent-transcript preview \
--session "$SESSION_JSONL" \
--out /tmp/agent-transcript-preview.html
open /tmp/agent-transcript-preview.html
在 gh pr create --body-file 或連接器 PR 建立之前,附加/更新主體檔案:
skills/agent-transcript/scripts/agent-transcript append-body \
--body /tmp/pr-body.md \
--session "$SESSION_JSONL" \
--out /tmp/pr-body.with-transcript.md
PR/Issue 工作流程
- 先草擬一般的 PR/issue 主體。
- 使用標題、分支、PR URL/號碼(如果已知)和 cwd 執行
find。 - 如果找到高信賴度的工作階段,請詢問:
是否加入已編輯的代理工作記錄?它有助於審查者,並可讓 PR 更容易被優先處理。我可以先開啟本機預覽。 - 如果使用者想要預覽,執行
preview,使用open開啟 HTML,並等待確認。 - 渲染或附加至暫存主體,然後在向使用者顯示或公開插入之前,自動修剪
## Agent Transcript區段。僅保留解釋此 PR/issue 目標、實作選擇、檔案、測試、驗證、阻礙因素和最終結果的對話輪次。 - 檢查修剪後的記錄文字。如果仍包含不相關的較早/較晚工作,請在繼續之前再次修剪。
- 如果使用者核准,則使用豐富化後的修剪主體檔案進行建立/更新。
- 如果找不到安全的記錄,則不置一詞並繼續進行,不加入記錄。如果使用者拒絕,則繼續進行且不加入記錄,也不新增任何記錄預留位置區段。
審查產出物
為了在許多 PR/工作階段候選項目之間進行手動稽核,請從本機 JSON 檔案建立本機 HTML 預覽。這僅適用於維護者,並非 PR/issue 工作流程的一部分:
skills/agent-transcript/scripts/agent-transcript html \
--prs /tmp/recent-prs.json \
--out /tmp/agent-transcript-preview.html