CommunityRédaction et éditiongithub.com

steipete/agent-transcript

Transcripts d'agents pour PR/issues GitHub : rédaction, prévisualisation et insertion sécurisée.

Qu'est-ce que agent-transcript ?

Cette compétence permet d'inclure de manière sécurisée des journaux de sessions d'agents locaux (comme Codex, Claude, Pi ou OpenClaw) dans les corps de Pull Requests ou d'issues GitHub. Elle garantit que seules les informations pertinentes et nettoyées (suppression des secrets, des chemins locaux, des prompts système) sont affichées, ce qui aide les relecteurs à comprendre le contexte et à prioriser la PR. Le processus commence par la recherche d'une session locale pertinente à l'aide de la commande `find`, suivie d'une prévisualisation HTML locale avant l'insertion (toujours avec l'accord de l'utilisateur). Les transcriptions sont automatiquement tronquées pour ne conserver que les échanges en rapport avec le travail de la PR/issue, et la section `## Agent Transcript` est placée dans une balise `<details>` repliée. En cas d'absence de transcription sûre ou de refus de l'utilisateur, la PR/issue est créée normalement sans aucun marqueur factice.

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

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 render ou append-body l'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 Transcript uniquement 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

  1. Rédiger d'abord le corps normal de la PR/issue.
  2. Exécuter find avec le titre, la branche, l'URL/numéro de PR si connu, et le répertoire de travail.
  3. 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.
  4. Si l'utilisateur souhaite un aperçu, exécuter preview, ouvrir le HTML avec open, et attendre une confirmation.
  5. Générer ou ajouter à un corps temporaire, puis tronquer automatiquement la section ## Agent Transcript avant 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.
  6. 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.
  7. Si l'utilisateur approuve, utiliser le fichier de corps enrichi et tronqué pour la création/mise à jour.
  8. 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

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.

Skills associés