CommunityEscrita e Ediçãogithub.com

steipete/agent-transcript

Transcrições de agentes para PRs e issues no GitHub: edite, visualize e insira com segurança.

O que é agent-transcript?

A habilidade steipete/agent-transcript oferece uma maneira segura e local de extrair transcrições de sessões de agentes (como Codex, Claude, Pi e OpenClaw) e incorporá-las em corpos de Pull Requests ou Issues no GitHub. Ela garante que apenas informações relevantes e sanitizadas sejam incluídas, removendo automaticamente segredos, tokens, caminhos de sistema e prompts de desenvolvedor. A ferramenta suporta busca em logs locais, pré-visualização em HTML e inserção controlada, sempre solicitando confirmação do usuário. É ideal para melhorar a rastreabilidade de decisões tomadas por agentes durante o desenvolvimento, ajudando revisores a entender o contexto e priorizar o trabalho sem comprometer a segurança.

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

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Transcrição de Agente

Proveniência local (melhor esforço) para corpos de PRs e issues do OpenClaw. Use durante fluxos de trabalho de PR ou issue criados por agentes no GitHub, antes de criar/atualizar o corpo.

Contrato

  • Nunca use rede. A descoberta de sessão lê apenas logs locais do agente.
  • Nunca faça upload de logs brutos. Renderize Markdown sanitizado primeiro.
  • Sempre pergunte ao usuário antes de adicionar logs de transcrição ao corpo de uma PR/issue do GitHub.
  • Informe ao usuário que logs de sessão sanitizados ajudam revisores e podem tornar as PRs mais fáceis de priorizar.
  • Ofereça uma pré-visualização HTML local antes da inserção. Se o usuário quiser a pré-visualização, abra-a e aguarde confirmação antes de adicionar a seção.
  • Falhe em caso de segredos não resolvidos, chaves privadas, detalhes de navegador/sessão/cookie ou URLs de autenticação.
  • Remova prompts de sistema/desenvolvedor, saídas brutas de ferramentas, raciocínio, ambiente, cookies, tokens e caminhos locais amplos.
  • Mantenha prompts de usuário, decisões visíveis do assistente, resumos concisos de ferramentas e resultados de testes/provas.
  • Automaticamente corte a transcrição renderizada antes de exibi-la, visualizá-la ou inseri-la em um corpo público. Nunca cole a renderização completa da sessão bruta em um corpo de PR/issue apenas porque render ou append-body a produziu.
  • Remova turnos de sessão não relacionados ao trabalho da PR/issue. Use o título da PR/issue, nome do branch, arquivos alterados e objetivo declarado como escopo; omita tarefas anteriores/posteriores não relacionadas, mesmo quando estiverem no mesmo log de sessão.
  • Melhor esforço apenas: a criação da PR/issue deve continuar se nenhuma transcrição segura for encontrada.
  • Adicione a seção ## Transcrição do Agente apenas ao inserir uma transcrição real. Nunca adicione um título ou texto de espaço reservado, como "Uma pré-visualização de transcrição local sanitizada foi gerada, mas não incluída."
  • Use uma seção <details> recolhida e atualize marcadores existentes em vez de duplicar seções.

Auxiliar

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

Encontre uma sessão local provável:

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

find escaneia, por padrão, os 400 logs JSONL locais mais recentes correspondentes em sessões de agente Codex, Claude, Pi e OpenClaw. Use --max-files N para uma busca local mais ampla.

Em um repositório downstream que sincroniza habilidades compartilhadas sob .agents/skills, substitua skills/agent-transcript por .agents/skills/agent-transcript.

Renderize uma seção de corpo de PR/issue:

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

Visualize uma sessão candidata localmente:

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

Anexe/atualize um arquivo de corpo antes de gh pr create --body-file ou criação de PR por conector:

skills/agent-transcript/scripts/agent-transcript append-body \
  --body /tmp/pr-body.md \
  --session "$SESSION_JSONL" \
  --out /tmp/pr-body.with-transcript.md

Fluxo de Trabalho para PR/Issue

  1. Elabore primeiro o corpo normal da PR/issue.
  2. Execute find com título, branch, URL/número da PR se conhecido e cwd.
  3. Se uma sessão de alta confiança for encontrada, pergunte: Incluir uma transcrição de agente editada? Ajuda revisores e pode tornar a PR mais fácil de priorizar. Posso abrir uma pré-visualização local primeiro.
  4. Se o usuário quiser a pré-visualização, execute preview, abra o HTML com open e aguarde confirmação.
  5. Renderize ou anexe a um corpo temporário e, em seguida, corte automaticamente a seção ## Transcrição do Agente antes de mostrá-la ao usuário ou inseri-la publicamente. Mantenha apenas os turnos que explicam o objetivo desta PR/issue, escolhas de implementação, arquivos, testes, provas, bloqueadores e resultado final.
  6. Inspecione o texto da transcrição cortada. Se ainda incluir trabalho anterior/posterior não relacionado, corte novamente antes de prosseguir.
  7. Se o usuário aprovar, use o arquivo de corpo enriquecido e cortado para criação/atualização.
  8. Se nenhuma sessão segura for encontrada, não diga nada e continue sem transcrição. Se o usuário recusar, continue sem transcrição e não adicione nenhuma seção de espaço reservado.

Artefatos de Revisão

Para auditorias manuais em muitos candidatos de PR/sessão, crie uma pré-visualização HTML local a partir de um arquivo JSON local. Isso é apenas para mantenedores e não faz parte do fluxo de trabalho de 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.

Habilidades Relacionadas