Community寫作與編輯github.com

steipete/agent-transcript

GitHub PR/issue 代理工作記錄:安全地編輯、預覽與插入。

agent-transcript 是什麼?

此技能為 AI 代理提供一個安全、僅限本機的流程,用於從代理工作階段記錄中,將已編輯的記錄擷取並插入到 GitHub PR 或 issue 主體中。它能自動掃描本機代理日誌(支援 Codex、Claude、Pi、OpenClaw),找到與當前 PR/issue 相關的會話,並將其渲染為已編輯的 Markdown 摘要。此技能優先考慮隱私與安全:它絕不傳輸原始日誌、絕不使用網路,並嚴格遮蔽機密資料(如金鑰、Cookie、系統提示詞),僅保留使用者提示詞、助手決策及精簡的工具摘要。在插入 GitHub 主體之前,它會提供一個本機 HTML 預覽供使用者審核,並在使用者確認後,以可折疊的 `<details>` 區塊附加或更新記錄。如果找不到安全的記錄,或使用者拒絕加入,它會無聲地繼續進行,而不會添加佔位符章節,確保 PR/issue 建立工作流程不會中斷。此技能包含命令列工具 (`agent-transcript`),用於尋找、渲染、預覽及附加記錄,並會自動將記錄修剪至僅與當前工作相關的範圍。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/agent-transcript

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 工作流程

  1. 先草擬一般的 PR/issue 主體。
  2. 使用標題、分支、PR URL/號碼(如果已知)和 cwd 執行 find。
  3. 如果找到高信賴度的工作階段,請詢問: 是否加入已編輯的代理工作記錄?它有助於審查者,並可讓 PR 更容易被優先處理。我可以先開啟本機預覽。
  4. 如果使用者想要預覽,執行 preview,使用 open 開啟 HTML,並等待確認。
  5. 渲染或附加至暫存主體,然後在向使用者顯示或公開插入之前,自動修剪 ## Agent Transcript 區段。僅保留解釋此 PR/issue 目標、實作選擇、檔案、測試、驗證、阻礙因素和最終結果的對話輪次。
  6. 檢查修剪後的記錄文字。如果仍包含不相關的較早/較晚工作,請在繼續之前再次修剪。
  7. 如果使用者核准,則使用豐富化後的修剪主體檔案進行建立/更新。
  8. 如果找不到安全的記錄,則不置一詞並繼續進行,不加入記錄。如果使用者拒絕,則繼續進行且不加入記錄,也不新增任何記錄預留位置區段。

審查產出物

為了在許多 PR/工作階段候選項目之間進行手動稽核,請從本機 JSON 檔案建立本機 HTML 預覽。這僅適用於維護者,並非 PR/issue 工作流程的一部分:

skills/agent-transcript/scripts/agent-transcript html \
  --prs /tmp/recent-prs.json \
  --out /tmp/agent-transcript-preview.html

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

相關技能