O que MeetingAnalysis faz?
Gravações, notas ou transcrições coladas entram; um resumo curto e estruturado e seus itens de ação saem. Cada caminho, pessoa e conta vem da configuração do usuário, nunca desta skill.
Etapa 0 — toda invocação começa aqui
MA="${SKILLS_HOME:-$HOME/.claude/skills}/MeetingAnalysis/Tools"
python3 "$MA/meeting_config.py" check # ok: true, ou a lista de problemas
python3 "$MA/meeting_config.py" show <contexto> # o perfil resolvido para um contexto
Sem configuração, ou um problema listado → execute Workflows/Setup.md primeiro. A configuração
está em $MEETING_ANALYSIS_CONFIG, senão
${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/MeetingAnalysis/config.json.
Fluxos de Trabalho
| Gatilho | Fluxo de Trabalho |
|---|---|
| primeiro uso, novo contexto, novo provedor de notas, "configurar análise de reunião" | Setup |
| um caminho de gravação, "analisar esta reunião" | Analyze: realocar → transcrever → quadros → resumir → rastreador → arquivar → verificar |
| "apenas transcrever" | TranscribeOnly |
| "importar notas de reunião", notas do Gemini, uma transcrição colada de um anotador, um link de reunião | ImportNotes |
/MeetingAnalysis ingest <contexto> --unattended, "caixa de entrada de reuniões", agendamento | AutoIngest |
INVARIANTE ABSOLUTA — sem mídia em um repositório
As pastas de reunião geralmente estão dentro de um repositório git (um repositório de notas, um segundo cérebro). O Git mantém cada blob confirmado para sempre: uma gravação de 800 MB custa 800 MB em cada clone, permanentemente, e excluir o arquivo depois não devolve o espaço.
| Permitido em uma pasta de reunião | Proibido |
|---|---|
.md, .txt, .json, .jsonl | vídeo: .mp4 .mkv .mov .webm .avi |
no máximo 5 .jpg excepcionais, ≤ 1 MB no total (§ Quadros) | áudio: .wav .mp3 .m4a, qualquer áudio extraído |
quadros .png, qualquer arquivo acima de 20 MB |
- A gravação original nunca é copiada ou movida para dentro de uma pasta de reunião. O resumo a nomeia.
- Se uma gravação de entrada estiver dentro de uma árvore de trabalho git, mova-a para
recordings_archiveprimeiro, depois trabalhe a partir do novo caminho. - Áudio e quadros temporários vão para um diretório temp e são deletados na limpeza.
- A § Verificação não deve imprimir nada antes de relatar sucesso.
meeting_config.py check recusa um recordings_archive ou diretório base de ingestão dentro de uma árvore de trabalho git.
Contextos confidenciais
"confidential": true significa que a reunião pertence a um empregador ou cliente e a pasta da reunião
ou o rastreador é pessoal. Então: nenhuma transcrição literal ou notas copiadas (o resumo linka para
a fonte), resumos em termos genéricos (decisões, tópicos, responsáveis, IDs de tickets), nenhum
hostname, IP, ID de conta, credenciais, nomes de clientes ou dados de clientes, e itens do rastreador como
TICKET-ID: resumo genérico curto.
Formato de saída
<diretorio_reunioes>/YYYY-MM-DD-<slug>/
├── YYYY-MM-DD-<slug>-summary.md
├── YYYY-MM-DD-<slug>-transcript.txt # linhas [MM:SS] (não para contextos confidenciais)
├── YYYY-MM-DD-<slug>-transcript.json # segmentos (não para contextos confidenciais)
└── frames/ # raro; ≤ 5 jpg, ≤ 1 MB
<slug> é curto em kebab-case a partir do título da reunião (weekly-status, pricing-review; adicione o
nome da outra pessoa para 1:1s). Resumo:
# <Título da reunião> — YYYY-MM-DD
**Participantes:** …
**Fonte:** <nome do arquivo de gravação (arquivado fora do repositório) | link do documento de notas | transcrição colada de <ferramenta>>
**Transcrição:** <nome do arquivo | link | não copiada>
---
## Contexto
## Tópicos Discutidos
### 1. <Tópico> (MM:SS–MM:SS)
## Decisões
## Itens de Ação Imediatos
| # | Ação | Responsável | Prioridade | Prazo |
|---|------|-------------|------------|-------|
## Principais Conclusões
A tabela de ações lista todos os responsáveis para que o registro esteja completo; apenas os seus vão para o rastreador.
Itens de ação → rastreador
tracker: "BattlePlan" na configuração envia seus itens através do batch-add idempotente do BattlePlan
("none" pula a etapa). Seus itens significam: o responsável é você ou um de seus
owner_aliases, você é um dos vários responsáveis, ou "nós/o time" em uma reunião que você participou.
Subcontexto: primeira regex de tracker_sub_context_rules que corresponder à ação, senão o tracker_sub_context
do contexto. Resolva prazos relativos em relação à data da reunião. Fonte:
Reunião: <título> YYYY-MM-DD (gravação|notas|colado), estável entre execuções porque as chaves de deduplicação
estão nela. Mostre um --dry-run e obtenha um sim a menos que esteja executando em modo não supervisionado.
Nomes
Reconhecimento de fala e anotadores distorcem nomes. Corrija-os contra o arquivo de roster
(roster_file: uma pessoa por linha, Nome: alias, erro de grafia, …) e a lista de participantes
(evento de calendário ou cabeçalho de notas). Marque correções de baixa confiança como Nome (?); nunca adivinhe.
Quadros (apenas vídeo; apenas temporários)
Quadros são entrada para análise, não um entregável. Extraia para um diretório temp, leia-os, escreva o que mostram no resumo (slides → texto chave; compartilhamentos de tela → o que foi mostrado; estrutura → um diagrama mermaid), então os delete.
ffmpeg -i <video> -vf "select='gt(scene,0.3)',showinfo" -vsync vfr "$TMP/frames/part1_%03d.png" # 0.15 se < 2 quadros
Mantenha um quadro apenas se todas as condições forem verdadeiras: seu conteúdo não pode ser expresso como texto, uma tabela ou mermaid;
é denso (não uma visão geral de galeria ou slide de título); as conclusões do resumo dependem dele; e o
resumo o referencia pelo nome. Salve os quadros mantidos como
ffmpeg -i in.png -vf scale=1280:-2 -q:v 4 frames/partN_MMmSSs.jpg. Quando estiver em dúvida, descarte: a
gravação e o timestamp permanecem.
Verificação
find "<pasta da reunião>" -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 "<pasta da reunião>" -path '*/frames/*' -type f | wc -l # deve ser ≤ 5
Saída vazia é a única aprovação. Qualquer coisa listada: mova para fora, informe o usuário, não reporte sucesso.
Ferramentas
| Ferramenta | Faz |
|---|---|
| `meeting_config.py check | show |
| `transcribe.py REC --out-base DIR/transcript [--lang auto | en |
| `run_ingest.sh --context NOME [--install | --check |
Dependências
uv (scripts declaram suas próprias dependências Python). ffmpeg apenas para extração de quadros. Uma GPU é
opcional: na CPU, uma reunião de uma hora leva cerca de duas horas com turbo. A importação de notas precisa dos
conectores do Google Drive / Docs do agente (e opcionalmente Gmail, Calendário) para a conta correta.