Was macht MeetingAnalysis?
Aufnahmen, Notizen oder eingefügte Transkripte hinein – eine kurze, strukturierte Zusammenfassung und Ihre Aktionspunkte heraus. Jeder Pfad, jede Person und jedes Konto stammt aus der Benutzerkonfiguration, niemals aus diesem Skill.
Schritt 0 — jeder Aufruf beginnt hier
MA="${SKILLS_HOME:-$HOME/.claude/skills}/MeetingAnalysis/Tools"
python3 "$MA/meeting_config.py" check # ok: true, oder die Liste der Probleme
python3 "$MA/meeting_config.py" show <context> # das aufgelöste Profil für einen Kontext
Keine Konfiguration oder ein Problem aufgelistet → zuerst Workflows/Setup.md ausführen. Die Konfiguration liegt unter $MEETING_ANALYSIS_CONFIG, sonst ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/MeetingAnalysis/config.json.
Workflows
| Auslöser | Workflow |
|---|---|
| Erste Verwendung, neuer Kontext, neuer Notizen-Anbieter, "Meeting-Analyse einrichten" | Setup |
| Ein Aufnahmepfad, "dieses Meeting analysieren" | Analyze: verschieben → transkribieren → Frames → zusammenfassen → Tracker → archivieren → verifizieren |
| "Nur transkribieren" | TranscribeOnly |
| "Meeting-Notizen importieren", Gemini-Notizen, ein eingefügtes Notizen-Transkript, ein Meeting-Link | ImportNotes |
/MeetingAnalysis ingest <context> --unattended, "Meeting-Inbox", Zeitplanung | AutoIngest |
HARTE INVARIANTE — keine Medien in einem Repository
Meeting-Ordner befinden sich normalerweise in einem Git-Repository (Notizen-Repo, Second Brain). Git behält jeden committeten Blob für immer: Eine 800 MB große Aufnahme kostet 800 MB bei jedem Klon, dauerhaft, und das spätere Löschen der Datei gibt den Speicherplatz nicht zurück.
| Erlaubt in einem Meeting-Ordner | Verboten |
|---|---|
.md, .txt, .json, .jsonl | Video: .mp4 .mkv .mov .webm .avi |
Maximal 5 ausnahmsweise .jpg-Keyframes, ≤ 1 MB insgesamt (§ Frames) | Audio: .wav .mp3 .m4a, jegliches extrahierte Audio |
.png-Frames, jede Datei über 20 MB |
- Die Quellaufnahme wird niemals in einen Meeting-Ordner kopiert oder verschoben. Die Zusammenfassung benennt sie.
- Wenn sich eine Eingabeaufnahme innerhalb eines Git-Worktrees befindet, verschieben Sie sie zuerst in
recordings_archiveund arbeiten Sie dann vom neuen Pfad aus. - Temporäre Audio- und Framedateien gehen in ein temporäres Verzeichnis und werden bei der Bereinigung gelöscht.
- § Verifikation muss vor dem Melden des Erfolgs nichts ausgeben.
meeting_config.py check lehnt ein recordings_archive oder Ingest-Stammverzeichnis innerhalb eines Git-Worktrees ab.
Vertrauliche Kontexte
"confidential": true bedeutet, dass das Meeting einem Arbeitgeber oder Kunden gehört und der Meeting-Ordner oder Tracker persönlich ist. Dann: kein wörtliches Transkript oder kopierte Notizen (die Zusammenfassung verlinkt stattdessen auf die Quelle), Zusammenfassungen in generischen Begriffen (Entscheidungen, Themen, Verantwortliche, Ticket-IDs), keine Hostnamen, IPs, Konten-IDs, Anmeldedaten, Kundennamen oder Kundendaten, und Tracker-Einträge als TICKET-ID: kurze generische Zusammenfassung.
Ausgabeformat
<meetings_dir>/YYYY-MM-DD-<slug>/
├── YYYY-MM-DD-<slug>-summary.md
├── YYYY-MM-DD-<slug>-transcript.txt # [MM:SS]-Zeilen (nicht für vertrauliche Kontexte)
├── YYYY-MM-DD-<slug>-transcript.json # Segmente (nicht für vertrauliche Kontexte)
└── frames/ # selten; ≤ 5 jpg, ≤ 1 MB
<slug> ist ein kurzer Kebab-Case vom Meeting-Titel (weekly-status, pricing-review; für 1:1-Gespräche den Namen der anderen Person hinzufügen). Zusammenfassung:
# <Meeting-Titel> — YYYY-MM-DD
**Teilnehmer:** …
**Quelle:** <Aufnahmedateiname (außerhalb des Repos archiviert) | Notizen-Dokument-Link | eingefügtes Transkript von <Tool>>
**Transkript:** <Dateiname | Link | nicht kopiert>
---
## Kontext
## Besprochene Themen
### 1. <Thema> (MM:SS–MM:SS)
## Entscheidungen
## Sofortige Aktionspunkte
| # | Aktion | Verantwortlicher | Priorität | Fälligkeitsdatum |
|---|--------|-----------------|-----------|------------------|
## Wichtige Erkenntnisse
Die Aktionstabelle listet jeden Verantwortlichen auf, damit der Datensatz vollständig ist; nur Ihre eigenen Punkte gehen an den Tracker.
Aktionspunkte → Tracker
tracker: "BattlePlan" in der Konfiguration sendet Ihre Punkte über BattlePlans idempotentes batch-add ("none" überspringt den Schritt). Ihre eigenen Punkte bedeutet: Verantwortlicher sind Sie oder einer Ihrer owner_aliases, Sie sind einer von mehreren Verantwortlichen, oder „wir/das Team“ in einem Meeting, an dem Sie teilgenommen haben. Unter-Kontext: erster Treffer von tracker_sub_context_rules Regex auf der Aktion, sonst der tracker_sub_context des Kontexts. Relative Fälligkeiten relativ zum Meeting-Datum auflösen. Quelle: Meeting: <Titel> YYYY-MM-DD (recording|notes|pasted), stabil über Ausführungen hinweg, da Deduplizierung darauf basiert. Zeigen Sie ein --dry-run an und holen Sie ein Ja ein, es sei denn, es läuft unbeaufsichtigt.
Namen
Spracherkennung und Notizen-Dienste verhunzen Namen. Korrigieren Sie sie anhand der Teammitglieder-Datei (roster_file: eine Person pro Zeile, Name: Alias, Falschschreibung, …) und der Teilnehmerliste (Kalenderereignis oder Notizenkopf). Markieren Sie Korrekturen mit geringer Vertrauenswürdigkeit als Name (?); raten Sie niemals.
Frames (nur Video; nur temporär)
Frames sind Analyse-Eingabe, kein Auslieferungsgegenstand. In ein temporäres Verzeichnis extrahieren, lesen, was sie zeigen, in die Zusammenfassung schreiben (Folien → Schlüsseltext; Bildschirmfreigaben → was gezeigt wurde; Struktur → ein Mermaid-Diagramm) und dann löschen.
ffmpeg -i <video> -vf "select='gt(scene,0.3)',showinfo" -vsync vfr "$TMP/frames/part1_%03d.png" # 0.15 wenn < 2 Frames
Behalten Sie einen Frame nur, wenn alle zutreffen: sein Inhalt kann nicht als Text, Tabelle oder Mermaid ausgedrückt werden; er ist dicht (keine Galerieansicht oder Titelfolie); die Schlussfolgerungen der Zusammenfassung hängen davon ab; und die Zusammenfassung verweist namentlich darauf. Behaltene Frames speichern als ffmpeg -i in.png -vf scale=1280:-2 -q:v 4 frames/partN_MMmSSs.jpg. Im Zweifelsfall verwerfen: Die Aufnahme und der Zeitstempel bleiben erhalten.
Verifikation
find "<Meeting-Ordner>" -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 "<Meeting-Ordner>" -path '*/frames/*' -type f | wc -l # muss ≤ 5 sein
Leere Ausgabe ist der einzige Bestehen-Fall. Bei irgendeiner Ausgabe: Datei entfernen, den Benutzer informieren, keinen Erfolg melden.
Werkzeuge
| Tool | Aufgabe |
|---|---|
| `meeting_config.py check | show |
| `transcribe.py REC --out-base VERZ/transkript [--lang auto | en |
| `run_ingest.sh --context NAME [--install | --check |
Abhängigkeiten
uv (Skripte deklarieren ihre eigenen Python-Abhängigkeiten). ffmpeg nur für Frameextraktion. Eine GPU ist optional: Auf der CPU dauert ein einstündiges Meeting mit turbo etwa zwei Stunden. Notizenimport benötigt die Google Drive / Docs-Konnektoren (und optional Gmail, Kalender) des Agenten für das richtige Konto.