¿Qué hace MeetingAnalysis?
Grabaciones, notas o transcripciones pegadas como entrada; un resumen corto y estructurado y tus tareas como salida. Cada ruta, persona y cuenta proviene de la configuración del usuario, nunca de esta skill.
Paso 0 — toda invocación comienza aquí
MA="${SKILLS_HOME:-$HOME/.claude/skills}/MeetingAnalysis/Tools"
python3 "$MA/meeting_config.py" check # ok: true, o la lista de problemas
python3 "$MA/meeting_config.py" show <context> # el perfil resuelto para un contexto
Sin configuración, o si hay algún problema listado → ejecuta primero Workflows/Setup.md. La configuración
reside en $MEETING_ANALYSIS_CONFIG, o si no
${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/MeetingAnalysis/config.json.
Flujos de trabajo
| Disparador | Flujo de trabajo |
|---|---|
| primer uso, nuevo contexto, nuevo proveedor de notas, "configurar análisis de reuniones" | Setup |
| una ruta de grabación, "analizar esta reunión" | Analyze: reubicar → transcribir → fotogramas → resumir → tracker → archivar → verificar |
| "solo transcribir" | TranscribeOnly |
| "importar notas de reunión", notas de Gemini, una transcripción pegada de un notetaker, un enlace de reunión | ImportNotes |
/MeetingAnalysis ingest <context> --unattended, "bandeja de entrada de reuniones", programación | AutoIngest |
INVARIANTE ABSOLUTO — sin medios en un repo
Las carpetas de reuniones suelen estar dentro de un repositorio git (un repositorio de notas, un segundo cerebro). Git conserva cada blob confirmado para siempre: una grabación de 800 MB cuesta 800 MB en cada clon, permanentemente, y eliminar el archivo más tarde no recupera el espacio.
| Permitido en una carpeta de reunión | Prohibido |
|---|---|
.md, .txt, .json, .jsonl | video: .mp4 .mkv .mov .webm .avi |
como máximo 5 fotogramas .jpg excepcionales, ≤ 1 MB en total (§ Fotogramas) | audio: .wav .mp3 .m4a, cualquier audio extraído |
fotogramas .png, cualquier archivo mayor de 20 MB |
- La grabación original nunca se copia ni mueve a una carpeta de reunión. El resumen la nombra.
- Si una grabación de entrada está dentro de un árbol de trabajo git, muévela primero a
recordings_archive, luego trabaja desde la nueva ruta. - El audio temporal y los fotogramas van a un directorio temporal y se eliminan durante la limpieza.
- § Verificación no debe imprimir nada antes de informar éxito.
meeting_config.py check rechaza un recordings_archive o un directorio de ingesta dentro de un árbol de trabajo git.
Contextos confidenciales
"confidential": true significa que la reunión pertenece a un empleador o cliente y la carpeta de la reunión
o el tracker es personal. Entonces: no se copia transcripción ni notas literales (el resumen enlaza a la
fuente), resúmenes en términos genéricos (decisiones, temas, responsables, IDs de tickets), sin
nombres de host, IPs, IDs de cuenta, credenciales, nombres de clientes ni datos de clientes, y los elementos del tracker como
TICKET-ID: resumen genérico corto.
Formato de salida
<meetings_dir>/YYYY-MM-DD-<slug>/
├── YYYY-MM-DD-<slug>-summary.md
├── YYYY-MM-DD-<slug>-transcript.txt # líneas [MM:SS] (no en contextos confidenciales)
├── YYYY-MM-DD-<slug>-transcript.json # segmentos (no en contextos confidenciales)
└── frames/ # raro; ≤ 5 jpg, ≤ 1 MB
<slug> es kebab-case corto del título de la reunión (weekly-status, pricing-review; añade el
nombre de la otra persona para reuniones 1:1). Resumen:
# <Título de la reunión> — YYYY-MM-DD
**Asistentes:** …
**Fuente:** <nombre de archivo de grabación (archivado fuera del repo) | enlace al documento de notas | transcripción pegada de <herramienta>>
**Transcripción:** <nombre de archivo | enlace | no copiada>
---
## Contexto
## Temas discutidos
### 1. <Tema> (MM:SS–MM:SS)
## Decisiones
## Acciones inmediatas
| # | Acción | Responsable | Prioridad | Fecha límite |
|---|--------|-------------|-----------|--------------|
## Conclusiones clave
La tabla de acciones lista todos los responsables para que el registro esté completo; solo tus acciones van al tracker.
Acciones → tracker
tracker: "BattlePlan" en la configuración envía tus acciones mediante batch-add idempotente de BattlePlan
("none" omite el paso). Tus acciones significa: el responsable eres tú o uno de tus
owner_aliases, eres uno de varios responsables, o "nosotros/el equipo" en una reunión a la que asististe.
Sub-contexto: primera coincidencia de tracker_sub_context_rules regex en la acción, o si no el
tracker_sub_context del contexto. Resuelve fechas límite relativas contra la fecha de la reunión. Fuente:
Meeting: <título> YYYY-MM-DD (recording|notes|pasted), estable entre ejecuciones porque las claves de deduplicación
se basan en ello. Muestra un --dry-run y pide confirmación a menos que se ejecute desatendido.
Nombres
El reconocimiento de voz y los anotadores distorsionan los nombres. Corrígelos contra el archivo de plantilla
(roster_file: una persona por línea, Nombre: alias, error ortográfico, …) y la lista de asistentes
(evento de calendario o encabezado de notas). Marca las correcciones de baja confianza Nombre (?); nunca adivines.
Fotogramas (solo video; solo temporales)
Los fotogramas son entrada para el análisis, no un entregable. Extráelos a un directorio temporal, léelos, escribe lo que muestran en el resumen (diapositivas → texto clave; compartir pantalla → lo que se mostró; estructura → un diagrama mermaid), luego elimínalos.
ffmpeg -i <video> -vf "select='gt(scene,0.3)',showinfo" -vsync vfr "$TMP/frames/part1_%03d.png" # 0.15 si < 2 fotogramas
Conserva un fotograma solo si todas se cumplen: su contenido no se puede expresar como texto, tabla o mermaid;
es denso (no una vista de galería o diapositiva de título); las conclusiones del resumen dependen de él; y
el resumen lo referencia por nombre. Guarda los fotogramas conservados como
ffmpeg -i in.png -vf scale=1280:-2 -q:v 4 frames/partN_MMmSSs.jpg. Ante la duda, descarta: la
grabación y la marca de tiempo permanecen.
Verificación
find "<carpeta de reunión>" -type f \( -iname '*.mp4' -o -iname '*.mkv' -o -iname '*.mov' -o -iname '*.webm' -o \
-iname '*.avi' -o -iname '*.wav' -o -iname '*.mp3' -o -iname '*.m4a' -o -iname '*.png' -o -size +20M \) -print
find "<carpeta de reunión>" -path '*/frames/*' -type f | wc -l # debe ser ≤ 5
La salida vacía es la única aprobación. Si hay algo listado: muévelo fuera, informa al usuario, no reportes éxito.
Herramientas
| Herramienta | Función |
|---|---|
| `meeting_config.py check | show |
| `transcribe.py REC --out-base DIR/transcript [--lang auto | en |
| `run_ingest.sh --context NAME [--install | --check |
Dependencias
uv (los scripts declaran sus propias dependencias Python). ffmpeg solo para extracción de fotogramas. Una GPU es
opcional: en CPU, una reunión de una hora toma aproximadamente dos horas con turbo. La importación de notas necesita
los conectores de Google Drive / Docs (y opcionalmente Gmail, Calendar) del agente para la cuenta correcta.