O que Transcrição de Agente faz?
Use apenas quando o usuário solicitar explicitamente uma transcrição ou pré-visualização. Omita por padrão; nunca ofereça uma nem pergunte se deve incluir uma durante o trabalho comum de PR. Um pedido de pré-visualização por si só não autoriza a publicação.
Preparar Localmente
O auxiliar lê logs locais do Codex, Claude, Pi e OpenClaw; nenhuma rede é usada para descoberta/ renderização. Nunca faça upload de logs brutos.
.agents/skills/agent-transcript/scripts/agent-transcript find \
--query "$PR_TITLE $BRANCH_OR_PR_URL" --cwd "$PWD" --since-days 14
.agents/skills/agent-transcript/scripts/agent-transcript render \
--session "$SESSION_JSONL" --out /tmp/agent-transcript.md
find varre os 400 logs mais recentes por padrão; --max-files N amplia
a descoberta local. Trate correspondências como candidatas, não como prova de escopo.
Corte automaticamente o Markdown renderizado antes de mostrar, pré-visualizar ou inseri-lo. Mantenha apenas prompts do usuário relevantes para a tarefa, decisões visíveis, resumos curtos de ferramentas e resultados de prova. Use o objetivo do PR/issue, o branch e os arquivos alterados para remover turnos anteriores ou posteriores não relacionados. Descarte prompts de sistema/desenvolvedor, raciocínio, saída bruta de ferramentas, dados de ambiente, caminhos locais, credenciais, detalhes de navegador/sessão/cookie e URLs de autenticação. Inspecione o resultado cortado; a anonimização do auxiliar não é revisão de divulgação suficiente. Conteúdo sensível não resolvido significa omitir a transcrição.
Pré-visualizar e Inserir
Mostre o Markdown cortado para uma pré-visualização solicitada. Se HTML for solicitado,
construa a pré-visualização local a partir desse conteúdo cortado. Os modos preview, html e
append-body do auxiliar renderizam a sessão novamente; eles não consomem um arquivo Markdown
editado e podem reintroduzir turnos removidos. Não use a saída não cortada deles como artefato aprovado.
Insira apenas o texto inspecionado e com escopo definido quando a autorização do usuário cobrir
especificamente a publicação dessa transcrição no PR/issue nomeado. Gerar ou pré-visualizar
uma transcrição não autoriza a publicação, mesmo quando a criação ou edição comum de PR já
estiver aprovada. Se esse escopo estiver ausente, mostre o resultado cortado e obtenha
autorização de publicação antes da inserção. A autorização explícita existente que cubra a
publicação de transcrições não precisa de confirmação repetida. Mantenha a seção <details>
recolhida e substitua os marcadores de transcrição existentes em vez de duplicá-los. Se não
houver correspondência segura, continue o trabalho de PR sem transcrição ou marcador;
explique a omissão quando ela impedir a transcrição explicitamente solicitada. Não promova
a inclusão de transcrição como requisito prioritário de revisão.