Transcripción del Agente
Procedencia local, de mejor esfuerzo y exclusivamente local para los cuerpos de PRs/Issues de OpenClaw. Se utiliza durante flujos de trabajo de PR o Issue creados por el agente, antes de crear/actualizar el cuerpo.
Contrato
- Nunca uses la red. La detección de sesiones solo lee los logs locales del agente.
- Nunca subas logs en crudo. Renderiza primero Markdown sanitizado.
- Siempre pregunta al usuario antes de añadir registros de transcripción al cuerpo de un PR/Issue de GitHub.
- Informa al usuario de que los registros de sesión sanitizados ayudan a los revisores y pueden facilitar la priorización de los PRs.
- Ofrece una previsualización local en HTML antes de la inserción. Si el usuario quiere la previsualización, ábrela y espera la confirmación antes de añadir la sección.
- Falla de forma segura ante secretos no resueltos, claves privadas, detalles del navegador/sesión/cookies o URLs de autenticación.
- Elimina prompts del sistema/desarrollador, salidas de herramientas en bruto, razonamientos, variables de entorno, cookies, tokens y rutas locales extensas.
- Conserva prompts del usuario, decisiones visibles del asistente, resúmenes de herramientas concisos y resultados de pruebas/demostraciones.
- Recorta automáticamente la transcripción renderizada antes de mostrarla, previsualizarla o insertarla en un cuerpo público. Nunca pegues el renderizado completo de la sesión en el cuerpo de un PR/Issue solo porque
renderoappend-bodylo hayan producido. - Elimina los turnos de sesión no relacionados con el trabajo del PR/Issue. Usa el título del PR/Issue, el nombre de la rama, los archivos modificados y el objetivo declarado como alcance; omite tareas anteriores o posteriores no relacionadas, incluso si están en el mismo log de sesión.
- Solo de mejor esfuerzo: la creación del PR/Issue debe continuar si no se encuentra una transcripción segura.
- Añade la sección
## Transcripción del Agentesolo al insertar una transcripción real. Nunca añadas un marcador de posición de transcripción o texto como "Se generó una previsualización de transcripción sanitizada local pero no se incluyó". - Usa una sección contraída
<details>y actualiza los marcadores existentes en lugar de duplicar secciones.
Ayuda
skills/agent-transcript/scripts/agent-transcript --help
Encuentra una sesión local probable:
skills/agent-transcript/scripts/agent-transcript find \
--query "$PR_TITLE $BRANCH_OR_PR_URL" \
--cwd "$PWD" \
--since-days 14
find escanea los 400 logs JSONL locales coincidentes más recientes de forma predeterminada en las sesiones de Codex, Claude, Pi y OpenClaw. Usa --max-files N para una búsqueda local más amplia.
En un repositorio descendente que sincroniza habilidades compartidas bajo .agents/skills, reemplaza
skills/agent-transcript con .agents/skills/agent-transcript.
Renderiza una sección del cuerpo del PR/Issue:
skills/agent-transcript/scripts/agent-transcript render \
--session "$SESSION_JSONL" \
--out /tmp/agent-transcript.md
Previsualiza una sesión candidata localmente:
skills/agent-transcript/scripts/agent-transcript preview \
--session "$SESSION_JSONL" \
--out /tmp/agent-transcript-preview.html
open /tmp/agent-transcript-preview.html
Añade/actualiza un archivo de cuerpo antes de gh pr create --body-file o la creación de PR vía conector:
skills/agent-transcript/scripts/agent-transcript append-body \
--body /tmp/pr-body.md \
--session "$SESSION_JSONL" \
--out /tmp/pr-body.with-transcript.md
Flujo de Trabajo para PR/Issue
- Redacta primero el cuerpo normal del PR/Issue.
- Ejecuta
findcon el título, la rama, la URL/número del PR si se conoce, y el cwd. - Si se encuentra una sesión de alta confianza, pregunta:
¿Incluir una transcripción del agente redactada? Ayuda a los revisores y puede facilitar la priorización del PR. Puedo abrir una previsualización local primero. - Si el usuario quiere previsualización, ejecuta
preview, abre el HTML conopen, y espera la confirmación. - Renderiza o añade a un cuerpo temporal, luego recorta automáticamente la sección
## Transcripción del Agenteantes de mostrársela al usuario o insertarla públicamente. Conserva solo los turnos que explican el objetivo de este PR/Issue, las decisiones de implementación, los archivos, las pruebas, las demostraciones, los bloqueadores y el resultado final. - Inspecciona el texto de la transcripción recortada. Si aún incluye trabajo anterior/posterior no relacionado, recórtalo de nuevo antes de continuar.
- Si el usuario lo aprueba, usa el archivo de cuerpo enriquecido y recortado para la creación/actualización.
- Si no se encuentra una sesión segura, no digas nada y continúa sin transcripción. Si el usuario lo rechaza, continúa sin transcripción y no añadas ninguna sección de marcador de posición de transcripción.
Artefactos de Revisión
Para auditorías manuales a través de muchos PRs/sesiones candidatas, crea una previsualización HTML local a partir de un archivo JSON local. Esto es solo para mantenedores y no forma parte del flujo de trabajo de PR/Issue:
skills/agent-transcript/scripts/agent-transcript html \
--prs /tmp/recent-prs.json \
--out /tmp/agent-transcript-preview.html