Que fait AnalyseRéunion ?
Enregistrements, notes ou transcriptions copiées en entrée ; un résumé court et structuré et vos actions en sortie. Chaque chemin, personne et compte provient de la configuration de l'utilisateur, jamais de cette compétence.
Étape 0 — chaque invocation commence ici
MA="${SKILLS_HOME:-$HOME/.claude/skills}/MeetingAnalysis/Tools"
python3 "$MA/meeting_config.py" check # ok : true, ou la liste des problèmes
python3 "$MA/meeting_config.py" show <contexte> # le profil résolu pour un contexte
Pas de configuration, ou un problème listé → exécutez d'abord Workflows/Setup.md. La configuration se trouve dans $MEETING_ANALYSIS_CONFIG, sinon ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/MeetingAnalysis/config.json.
Workflows
| Déclencheur | Workflow |
|---|---|
| première utilisation, nouveau contexte, nouveau fournisseur de notes, « configurer l'analyse de réunion » | Configuration |
| un chemin d'enregistrement, « analyser cette réunion » | Analyser : déplacer → transcrire → images → résumer → tracker → archiver → vérifier |
| « juste transcrire » | TranscriptionSeule |
| « importer des notes de réunion », notes Gemini, une transcription copiée, un lien de réunion | ImporterNotes |
/MeetingAnalysis ingest <contexte> --unattended, « boîte de réception réunions », planification | AutoIngest |
INVARIANT STRICT — aucun média dans un dépôt
Les dossiers de réunion se trouvent généralement dans un dépôt git (dépôt de notes, second cerveau). Git conserve chaque blob validé pour toujours : un enregistrement de 800 Mo coûte 800 Mo sur chaque clone, définitivement, et supprimer le fichier plus tard ne rend pas l'espace.
| Autorisé dans un dossier de réunion | Interdit |
|---|---|
.md, .txt, .json, .jsonl | vidéo : .mp4 .mkv .mov .webm .avi |
au maximum 5 images .jpg exceptionnelles, ≤ 1 Mo au total (§ Images) | audio : .wav .mp3 .m4a, tout audio extrait |
images .png, tout fichier de plus de 20 Mo |
- L'enregistrement source n'est jamais copié ni déplacé dans un dossier de réunion. Le résumé le nomme.
- Si un enregistrement d'entrée se trouve dans une arborescence git, déplacez-le d'abord dans
recordings_archive, puis travaillez à partir du nouveau chemin. - L'audio et les images temporaires vont dans un répertoire temporaire et sont supprimés lors du nettoyage.
- § La vérification ne doit rien afficher avant de signaler le succès.
meeting_config.py check refuse un recordings_archive ou un répertoire d'ingestion situé dans une arborescence git.
Contextes confidentiels
"confidential": true signifie que la réunion appartient à un employeur ou client et que le dossier de réunion ou le tracker est personnel. Alors : aucune transcription littérale ni note copiée (le résumé renvoie à la source à la place), résumés en termes génériques (décisions, sujets, responsables, identifiants de ticket), pas de noms d'hôte, IP, identifiants de compte, identifiants, noms de clients ni données clients, et éléments du tracker sous forme TICKET-ID : résumé générique court.
Format de sortie
<meetings_dir>/YYYY-MM-DD-<slug>/
├── YYYY-MM-DD-<slug>-resume.md
├── YYYY-MM-DD-<slug>-transcription.txt # lignes [MM:SS] (pas pour contextes confidentiels)
├── YYYY-MM-DD-<slug>-transcription.json # segments (pas pour contextes confidentiels)
└── images/ # rare ; ≤ 5 jpg, ≤ 1 Mo
<slug> est un court kebab-case tiré du titre de la réunion (point-hebdo, revue-tarifs ; ajoutez le nom de l'autre personne pour les 1:1). Résumé :
# <Titre de la réunion> — YYYY-MM-DD
**Participants :** …
**Source :** <nom du fichier d'enregistrement (archivé hors du dépôt) | lien du document de notes | transcription copiée depuis <outil>>
**Transcription :** <nom de fichier | lien | non copiée>
---
## Contexte
## Sujets abordés
### 1. <Sujet> (MM:SS–MM:SS)
## Décisions
## Actions immédiates
| # | Action | Responsable | Priorité | Échéance |
|---|--------|-------------|----------|----------|
## Points clés
Le tableau d'actions liste tous les responsables pour que l'enregistrement soit complet ; seules vos actions vont au tracker.
Actions → tracker
tracker: "BattlePlan" dans la configuration envoie vos actions via batch-add idempotent de BattlePlan ("none" ignore l'étape). Vos actions signifie : le responsable est vous ou l'un de vos owner_aliases, vous êtes l'un des plusieurs responsables, ou « nous/l'équipe » dans une réunion à laquelle vous avez assisté. Sous-contexte : première correspondance de tracker_sub_context_rules (regex) sur l'action, sinon tracker_sub_context du contexte. Résoudre les échéances relatives par rapport à la date de la réunion. Source : Réunion : <titre> YYYY-MM-DD (enregistrement|notes|copie), stable entre les exécutions car les clés de déduplication s'appuient dessus. Affichez un --dry-run et obtenez un oui sauf en mode sans surveillance.
Noms
La reconnaissance vocale et les preneurs de notes déforment les noms. Corrigez-les par rapport au fichier d'équipe (roster_file : une personne par ligne, Nom : alias, faute d'orthographe, …) et la liste des participants (événement de calendrier ou en-tête de notes). Signalez les corrections de faible confiance Nom (?) ; ne devinez jamais.
Images (vidéo uniquement ; temporaires uniquement)
Les images sont une entrée d'analyse, pas un livrable. Extrayez dans un répertoire temporaire, lisez-les, écrivez ce qu'elles montrent dans le résumé (diapositives → texte clé ; partage d'écran → ce qui a été montré ; structure → un diagramme mermaid), puis supprimez-les.
ffmpeg -i <vidéo> -vf "select='gt(scene,0.3)',showinfo" -vsync vfr "$TMP/images/part1_%03d.png" # 0.15 si < 2 images
Conservez une image uniquement si toutes les conditions sont remplies : son contenu ne peut pas être exprimé sous forme de texte, de tableau ou de mermaid ; elle est dense (pas une vue galerie ni une diapositive de titre) ; les conclusions du résumé en dépendent ; et le résumé y fait référence par son nom. Enregistrez les images conservées avec ffmpeg -i in.png -vf scale=1280:-2 -q:v 4 images/partN_MMmSSs.jpg. En cas de doute, jetez : l'enregistrement et l'horodatage restent.
Vérification
find "<dossier réunion>" -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 "<dossier réunion>" -path '*/images/*' -type f | wc -l # doit être ≤ 5
Une sortie vide est le seul succès. Tout élément listé : déplacez-le, prévenez l'utilisateur, ne signalez pas de succès.
Outils
| Outil | Fait |
|---|---|
| `meeting_config.py check | show |
| `transcribe.py REC --out-base DOSSIER/transcription [--lang auto | en |
| `run_ingest.sh --context NOM [--install | --check |
Dépendances
uv (les scripts déclarent leurs propres dépendances Python). ffmpeg uniquement pour l'extraction d'images. Un GPU est facultatif : sur CPU, une réunion d'une heure prend environ deux heures avec turbo. L'import de notes nécessite les connecteurs Google Drive / Docs (et éventuellement Gmail, Calendar) de l'agent pour le bon compte.