CommunityRedacción y edicióngithub.com

steipete/agent-transcript

Transcripciones de agentes para PRs/issues de GitHub: redacta, previsualiza e inserta de forma segura.

¿Qué es agent-transcript?

Esta habilidad proporciona un mecanismo de procedencia local y de mejor esfuerzo para los cuerpos de Pull Requests (PRs) e Issues de OpenClaw. Es útil durante los flujos de trabajo donde un agente de IA crea o actualiza contenido en GitHub, ya que permite incluir una transcripción del agente (de la sesión local) de manera segura, redactando información sensible (como secretos, claves privadas, tokens, cookies, URLs de autenticación, prompts del sistema, salidas de herramientas en bruto, razonamientos, variables de entorno y rutas locales) y manteniendo solo las partes relevantes (prompts del usuario, decisiones del asistente, resúmenes de herramientas y resultados de pruebas). La habilidad se integra con agentes como Codex, Claude, Pi y OpenClaw, y ofrece comandos para encontrar sesiones (find), renderizar (render), previsualizar en HTML (preview) y añadir o actualizar la sección en el cuerpo (append-body), siempre pidiendo confirmación al usuario antes de la inserción. Es una herramienta de solo mejor esfuerzo: si no se encuentra una transcripción segura, la creación del PR/Issue debe continuar sin ella.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 render o append-body lo 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 Agente solo 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

  1. Redacta primero el cuerpo normal del PR/Issue.
  2. Ejecuta find con el título, la rama, la URL/número del PR si se conoce, y el cwd.
  3. 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.
  4. Si el usuario quiere previsualización, ejecuta preview, abre el HTML con open, y espera la confirmación.
  5. Renderiza o añade a un cuerpo temporal, luego recorta automáticamente la sección ## Transcripción del Agente antes 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.
  6. Inspecciona el texto de la transcripción recortada. Si aún incluye trabajo anterior/posterior no relacionado, recórtalo de nuevo antes de continuar.
  7. Si el usuario lo aprueba, usa el archivo de cuerpo enriquecido y recortado para la creación/actualización.
  8. 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

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 relacionados