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
renderouappend-bodya 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 Agenteapenas 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
- Elabore primeiro o corpo normal da PR/issue.
- Execute
findcom título, branch, URL/número da PR se conhecido e cwd. - 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. - Se o usuário quiser a pré-visualização, execute
preview, abra o HTML comopene aguarde confirmação. - Renderize ou anexe a um corpo temporário e, em seguida, corte automaticamente a seção
## Transcrição do Agenteantes 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. - Inspecione o texto da transcrição cortada. Se ainda incluir trabalho anterior/posterior não relacionado, corte novamente antes de prosseguir.
- Se o usuário aprovar, use o arquivo de corpo enriquecido e cortado para criação/atualização.
- 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