Agent Transcript
Provenance locale au mieux, sans réseau, pour les corps de PR/issues OpenClaw. À utiliser dans les workflows de PR ou d'issue créés par un agent avant la création/mise à jour du corps.
Contrat
- Ne jamais utiliser le réseau. La découverte de session lit uniquement les journaux d'agents locaux.
- Ne jamais télécharger de journaux bruts. Restituer d'abord du Markdown nettoyé.
- Toujours demander à l'utilisateur avant d'ajouter des journaux de transcription dans un corps de PR/issue GitHub.
- Informer l'utilisateur que les journaux de session nettoyés aident les relecteurs et peuvent faciliter la priorisation des PR.
- Proposer un aperçu HTML local avant l'insertion. Si l'utilisateur souhaite un aperçu, l'ouvrir et attendre une confirmation avant d'ajouter la section.
- Échouer en cas de secrets non résolus, de clés privées, de détails de navigateur/session/cookie ou d'URL d'authentification.
- Supprimer les invites système/développeur, les sorties brutes d'outils, le raisonnement, les variables d'environnement, les cookies, les jetons et les chemins locaux larges.
- Conserver les invites utilisateur, les décisions visibles de l'assistant, les résumés concis d'outils et les résultats de tests/preuves.
- Tronquer automatiquement la transcription rendue avant de la montrer, de la prévisualiser ou de l'insérer dans un corps public. Ne jamais coller le rendu complet de la session brute dans un corps de PR/issue simplement parce que
renderouappend-bodyl'a produit. - Supprimer les tours de session sans rapport avec le travail de la PR/issue. Utiliser le titre de la PR/issue, le nom de la branche, les fichiers modifiés et l'objectif déclaré comme périmètre ; omettre les tâches antérieures ou postérieures non liées, même si elles figurent dans le même journal de session.
- Au mieux : la création de PR/issue doit continuer si aucune transcription sûre n'est trouvée.
- Ajouter la section
## Agent Transcriptuniquement lors de l'insertion d'une transcription réelle. Ne jamais ajouter d'en-tête ou de texte factice de transcription tel que "Un aperçu de transcription locale nettoyée a été généré mais n'a pas été inclus". - Utiliser une section
<details>repliée et mettre à jour les marqueurs existants au lieu de dupliquer les sections.
Aide
skills/agent-transcript/scripts/agent-transcript --help
Trouver une session locale probable :
skills/agent-transcript/scripts/agent-transcript find \
--query "$PR_TITLE $BRANCH_OR_PR_URL" \
--cwd "$PWD" \
--since-days 14
find analyse par défaut les 400 journaux JSONL locaux les plus récents correspondant dans les sessions d'agents Codex, Claude, Pi et OpenClaw. Utiliser --max-files N pour une recherche locale plus large.
Dans un dépôt en aval qui synchronise les compétences partagées sous .agents/skills, remplacer
skills/agent-transcript par .agents/skills/agent-transcript.
Générer une section de corps de PR/issue :
skills/agent-transcript/scripts/agent-transcript render \
--session "$SESSION_JSONL" \
--out /tmp/agent-transcript.md
Prévisualiser une session candidate localement :
skills/agent-transcript/scripts/agent-transcript preview \
--session "$SESSION_JSONL" \
--out /tmp/agent-transcript-preview.html
open /tmp/agent-transcript-preview.html
Ajouter/mettre à jour un fichier de corps avant gh pr create --body-file ou la création de PR via connecteur :
skills/agent-transcript/scripts/agent-transcript append-body \
--body /tmp/pr-body.md \
--session "$SESSION_JSONL" \
--out /tmp/pr-body.with-transcript.md
Workflow PR/Issue
- Rédiger d'abord le corps normal de la PR/issue.
- Exécuter
findavec le titre, la branche, l'URL/numéro de PR si connu, et le répertoire de travail. - Si une session à haute confiance est trouvée, demander :
Inclure une transcription d'agent rédigée ? Cela aide les relecteurs et peut faciliter la priorisation de la PR. Je peux d'abord ouvrir un aperçu local. - Si l'utilisateur souhaite un aperçu, exécuter
preview, ouvrir le HTML avecopen, et attendre une confirmation. - Générer ou ajouter à un corps temporaire, puis tronquer automatiquement la section
## Agent Transcriptavant de la montrer à l'utilisateur ou de l'insérer publiquement. Ne conserver que les tours qui expliquent l'objectif de cette PR/issue, les choix d'implémentation, les fichiers, les tests, les preuves, les blocages et le résultat final. - Inspecter le texte de la transcription tronquée. S'il contient encore un travail antérieur ou postérieur non lié, tronquer à nouveau avant de continuer.
- Si l'utilisateur approuve, utiliser le fichier de corps enrichi et tronqué pour la création/mise à jour.
- Si aucune session sûre n'est trouvée, ne rien dire et continuer sans transcription. Si l'utilisateur refuse, continuer sans transcription et n'ajouter aucune section d'espace réservé.
Artefacts de révision
Pour les audits manuels de plusieurs candidats PR/session, créer un aperçu HTML local à partir d'un fichier JSON local. Ceci est destiné aux mainteneurs uniquement et ne fait pas partie du workflow PR/issue :
skills/agent-transcript/scripts/agent-transcript html \
--prs /tmp/recent-prs.json \
--out /tmp/agent-transcript-preview.html