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
renderoderappend-bodysie 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 Transcriptnur 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
- Zuerst den normalen PR/Issue-Body entwerfen.
findmit Titel, Branch, PR-URL/-Nummer (falls bekannt) und cwd ausführen.- 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."
- Wenn der Benutzer eine Vorschau wünscht,
previewausführen, das HTML mitopenöffnen und auf Bestätigung warten. - In einem temporären Body rendern oder anhängen, dann automatisch den Abschnitt
## Agent Transcriptkü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. - 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.
- Wenn der Benutzer zustimmt, die angereicherte, gekürzte Body-Datei für die Erstellung/Aktualisierung verwenden.
- 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