CommunitySchreiben & Editierengithub.com

steipete/agent-transcript

GitHub PR/Issue-Agent-Transkripte: Schwärzen, Vorschau und sicheres Einfügen.

Was ist agent-transcript?

Die Agent Transcript-Fähigkeit bietet eine lokale, nur auf lokalem Speicher basierende Herkunftsüberprüfung für PR- und Issue-Bodies von OpenClaw. Sie ist ein unverzichtbares Werkzeug für Entwickler, die mit KI-Agenten wie Claude, Codex oder Cursor arbeiten, um GitHub PRs oder Issues zu erstellen. Statt rohe, vertrauliche Sitzungsprotokolle hochzuladen, filtert sie sensible Daten wie Secrets, Tokens und Umgebungsvariablen sicher heraus und rendert eine bereinigte Markdown-Ansicht. Diese Fähigkeit unterstützt mehrere Plattformen und führt den Benutzer durch einen Workflow: Sie findet passende lokale Sitzungen, bietet eine lokale HTML-Vorschau zur Überprüfung, fragt explizit nach Zustimmung und fügt das Transkript als eingeklappten `<details>`-Abschnitt ein, wobei nur für den aktuellen PR/Issue relevante Schritte beibehalten werden. Sicherheit steht an erster Stelle: Fehler führen zu einem Abbruch, und es werden niemals Platzhalter eingefügt.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/agent-transcript

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Agent Transcript

Lokale, nur auf lokalem Speicher basierende Herkunftsüberprüfung für OpenClaw PR/Issue-Bodies. Verwenden Sie dies in agentenerstellten GitHub PR- oder Issue-Workflows, bevor Sie den Body erstellen/aktualisieren.

Vertrag

  • Niemals Netzwerk verwenden. Die Sitzungserkennung liest nur lokale Agentenprotokolle.
  • Niemals rohe Protokolle hochladen. Zuerst bereinigtes Markdown rendern.
  • Vor dem Hinzufügen von Transkriptprotokollen zu einem GitHub PR/Issue-Body immer den Benutzer fragen.
  • Dem Benutzer mitteilen, dass bereinigte Sitzungsprotokolle Reviewern helfen und PRs priorisierbarer machen können.
  • Vor dem Einfügen eine lokale HTML-Vorschau anbieten. Wenn der Benutzer eine Vorschau wünscht, öffnen Sie diese und warten Sie auf die Bestätigung, bevor Sie den Abschnitt hinzufügen.
  • Im Fehlerfall abbrechen bei ungelösten Geheimnissen, privaten Schlüsseln, Browser-/Sitzungs-/Cookie-Details oder Auth-URLs.
  • System-/Entwickler-Prompts, rohe Toolausgaben, Reasoning, Umgebungsvariablen, Cookies, Tokens und breite lokale Pfade entfernen.
  • Benutzer-Prompts, sichtbare Entscheidungen des Assistenten, knappe Toolzusammenfassungen und Testergebnisse/Belege behalten.
  • Das gerenderte Transkript automatisch kürzen, bevor es angezeigt, als Vorschau gezeigt oder in einen öffentlichen Body eingefügt wird. Niemals die rohe vollständige Sitzungswiedergabe in einen PR/Issue-Body einfügen, nur weil render oder append-body sie erzeugt hat.
  • Sitzungsschritte entfernen, die nichts mit der PR/Issue-Arbeit zu tun haben. Verwenden Sie den PR/Issue-Titel, den Branch-Namen, geänderte Dateien und das angegebene Ziel als Umfang; lassen Sie frühere/spätere, nicht zusammenhängende Aufgaben weg, auch wenn sie im selben Sitzungsprotokoll enthalten sind.
  • Nur beste Bemühungen: PR/Issue-Erstellung muss fortgesetzt werden, wenn kein sicheres Transkript gefunden wird.
  • Den Abschnitt ## Agent Transcript nur einfügen, wenn ein echtes Transkript eingefügt wird. Niemals einen Platzhalter-Transkript-Überschrift oder Text wie "Eine bereinigte lokale Transkriptvorschau wurde generiert, aber nicht eingefügt." hinzufügen.
  • Ein eingeklapptes <details>-Element verwenden und vorhandene Markierungen aktualisieren, anstatt Abschnitte zu duplizieren.

Hilfe

skills/agent-transcript/scripts/agent-transcript --help

Finden Sie eine wahrscheinliche lokale Sitzung:

skills/agent-transcript/scripts/agent-transcript find \
  --query "$PR_TITLE $BRANCH_OR_PR_URL" \
  --cwd "$PWD" \
  --since-days 14

find durchsucht standardmäßig die neuesten 400 passenden lokalen JSONL-Protokolle über Codex-, Claude-, Pi- und OpenClaw-Agentensitzungen hinweg. Verwenden Sie --max-files N für eine breitere lokale Suche.

In einem nachgelagerten Repository, das gemeinsame Fähigkeiten unter .agents/skills synchronisiert, ersetzen Sie skills/agent-transcript durch .agents/skills/agent-transcript.

Einen PR/Issue-Body-Abschnitt rendern:

skills/agent-transcript/scripts/agent-transcript render \
  --session "$SESSION_JSONL" \
  --out /tmp/agent-transcript.md

Vorschau einer Kandidatensitzung lokal:

skills/agent-transcript/scripts/agent-transcript preview \
  --session "$SESSION_JSONL" \
  --out /tmp/agent-transcript-preview.html
open /tmp/agent-transcript-preview.html

Einen Body vor gh pr create --body-file oder Connector-PR-Erstellung anhängen/aktualisieren:

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-Workflow

  1. Zuerst den normalen PR/Issue-Body entwerfen.
  2. find mit Titel, Branch, PR-URL/-Nummer (falls bekannt) und cwd ausführen.
  3. Wenn eine hochvertrauenswürdige Sitzung gefunden wird, fragen: "Ein geschwärztes Agententranskript einschließen? Es hilft Reviewern und kann den PR priorisierbarer machen. Ich kann zuerst eine lokale Vorschau öffnen."
  4. Wenn der Benutzer eine Vorschau wünscht, preview ausführen, das HTML mit open öffnen und auf Bestätigung warten.
  5. In einem temporären Body rendern oder anhängen, dann automatisch den Abschnitt ## Agent Transcript kürzen, bevor er dem Benutzer gezeigt oder öffentlich eingefügt wird. Nur Schritte behalten, die das Ziel dieses PR/Issue, Implementierungsentscheidungen, Dateien, Tests, Belege, Blocker und Endergebnis erklären.
  6. Den gekürzten Transkripttext prüfen. Wenn er immer noch nicht zusammenhängende frühere/spätere Arbeit enthält, vor dem Fortfahren erneut kürzen.
  7. Wenn der Benutzer zustimmt, die angereicherte, gekürzte Body-Datei für die Erstellung/Aktualisierung verwenden.
  8. Wenn keine sichere Sitzung gefunden wird, nichts sagen und ohne Transkript fortfahren. Wenn der Benutzer ablehnt, ohne Transkript fortfahren und keinen Transkript-Platzhalterabschnitt hinzufügen.

Überprüfungsartefakte

Für manuelle Audits über viele PR/Sitzungs-Kandidaten hinweg eine lokale HTML-Vorschau aus einer lokalen JSON-Datei erstellen. Dies ist nur für Betreuer gedacht und nicht Teil des PR/Issue-Workflows:

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.

Verwandte Skills