MeetingAnalysis は何をしますか?
録音、ノート、または貼り付けられた文字起こしを入力として受け取り、短く構造化されたサマリーとあなたのアクションアイテムを出力します。すべてのパス、人物、アカウントはユーザーの設定から取得され、このスキルからは取得されません。
ステップ 0 — すべての呼び出しはここから始まる
MA="${SKILLS_HOME:-$HOME/.claude/skills}/MeetingAnalysis/Tools"
python3 "$MA/meeting_config.py" check # ok: true、または問題のリスト
python3 "$MA/meeting_config.py" show <context> # 1つのコンテキストの解決済みプロファイル
設定がない、または問題がリストされている場合 → 最初に Workflows/Setup.md を実行します。設定は $MEETING_ANALYSIS_CONFIG、または ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/MeetingAnalysis/config.json にあります。
ワークフロー
| トリガー | ワークフロー |
|---|---|
| 初回使用、新しいコンテキスト、新しいノートプロバイダー、「会議分析をセットアップ」 | Setup |
| 録音パス、「この会議を分析」 | Analyze: 移動 → 文字起こし → フレーム → サマリー → トラッカー → アーカイブ → 確認 |
| 「とにかく文字起こし」 | TranscribeOnly |
| 「ミーティングノートをインポート」、Geminiノート、貼り付けられたノートテイカーの文字起こし、ミーティングリンク | ImportNotes |
/MeetingAnalysis ingest <context> --unattended、「会議受信箱」、スケジューリング | AutoIngest |
ハードインバリアント — リポジトリ内にメディアを置かない
会議フォルダは通常、git リポジトリ(ノートリポジトリ、セカンドブレイン)内にあります。Git はコミットされたすべての blob を永久に保持します。800 MB の録音ファイル 1 つで、すべてのクローンで 800 MB を消費し、後でファイルを削除しても容量は戻りません。
| 会議フォルダに許可されるもの | 禁止 |
|---|---|
.md、.txt、.json、.jsonl | 動画: .mp4 .mkv .mov .webm .avi |
最大5つの例外的な .jpg キーフレーム、合計1 MB以下(§ フレーム) | 音声: .wav .mp3 .m4a、抽出された音声すべて |
.png フレーム、20 MB を超えるファイルすべて |
- 元の録音は会議フォルダに決してコピーも移動もされません。サマリーがそれを参照します。
- 入力録音が git ワークツリー内にある場合、最初に
recordings_archiveに移動し、その後新しいパスから作業します。 - スクラッチ音声とフレームは一時ディレクトリに置かれ、クリーンアップで削除されます。
- § 確認は成功を報告する前に何も出力してはいけません。
meeting_config.py check は、recordings_archive または取り込みホームが git ワークツリー内にある場合に拒否します。
機密コンテキスト
"confidential": true は、会議が雇用主またはクライアントに属し、会議フォルダまたはトラッカーが個人用であることを意味します。その場合:逐語的な文字起こしやノートのコピーは禁止(代わりにサマリーがソースにリンクします)、サマリーは一般的な用語(決定事項、トピック、担当者、チケットID)で記述し、ホスト名、IP、アカウントID、資格情報、顧客名、顧客データは含めず、トラッカーアイテムは TICKET-ID: 短い一般的なサマリー とします。
出力形式
<meetings_dir>/YYYY-MM-DD-<slug>/
├── YYYY-MM-DD-<slug>-summary.md
├── YYYY-MM-DD-<slug>-transcript.txt # [MM:SS] 行 (機密コンテキストでは使用不可)
├── YYYY-MM-DD-<slug>-transcript.json # セグメント (機密コンテキストでは使用不可)
└── frames/ # まれに発生; ≤ 5 jpg, ≤ 1 MB
<slug> は会議タイトルからの短いケバブケース(weekly-status、pricing-review; 1対1の場合は相手の名前を追加)。サマリー:
# <会議タイトル> — YYYY-MM-DD
**参加者:** …
**ソース:** <録音ファイル名(リポジトリ外にアーカイブ済み)| ノートドキュメントリンク | <ツール> からの貼り付け文字起こし>
**文字起こし:** <ファイル名 | リンク | コピーされていません>
---
## コンテキスト
## 議論されたトピック
### 1. <トピック> (MM:SS–MM:SS)
## 決定事項
## 即時アクションアイテム
| # | アクション | 担当者 | 優先度 | 期限 |
|---|------|------|------|------|
## 重要なポイント
アクションテーブルは、すべての担当者を記載して記録を完全なものにします。自分のアイテムのみがトラッカーに送られます。
アクションアイテム → トラッカー
設定で tracker: "BattlePlan" とすると、自分のアイテムが BattlePlan の冪等な batch-add を通じて送信されます("none" はこのステップをスキップします)。「自分の」とは、担当者が自分または自分の owner_aliases の1つである、自分が複数の担当者のうちの1人である、または自分が参加した会議で「私たち/チーム」とある場合を意味します。サブコンテキスト:アクションに最初に一致する tracker_sub_context_rules 正規表現、それ以外はコンテキストの tracker_sub_context。相対的な期限は会議の日付を基準に解決します。ソース:Meeting: <title> YYYY-MM-DD (recording|notes|pasted)。重複排除キーとして使用されるため、実行間で安定します。--dry-run を表示し、無人実行でなければ確認を求めます。
名前
音声認識やノートテイカーは名前を間違えます。名簿ファイル(roster_file: 1行に1人、Name: alias, misspelling, …)と参加者リスト(カレンダーイベントまたはノートヘッダー)に対して修正します。信頼度の低い修正は Name (?) とマークします。推測は絶対にしないでください。
フレーム(動画のみ、スクラッチのみ)
フレームは分析入力であり、成果物ではありません。一時ディレクトリに抽出し、読み取り、その内容をサマリーに記述して(スライド → 主要テキスト、画面共有 → 表示された内容、構造 → mermaid図)から削除します。
ffmpeg -i <video> -vf "select='gt(scene,0.3)',showinfo" -vsync vfr "$TMP/frames/part1_%03d.png" # フレームが2未満の場合は0.15
フレームを保持するのは、すべての条件を満たす場合のみ:その内容がテキスト、テーブル、または mermaid で表現できない;密度が高い(ギャラリービューやタイトルスライドではない);サマリーの結論がそれに依存している;サマリーがその名前で参照している。保持するフレームは次のように保存:ffmpeg -i in.png -vf scale=1280:-2 -q:v 4 frames/partN_MMmSSs.jpg。不明な場合は破棄:録音とタイムスタンプが残っています。
確認
find "<会議フォルダ>" -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 "<会議フォルダ>" -path '*/frames/*' -type f | wc -l # ≤ 5 である必要があります
空の出力のみが合格です。何かリストされた場合:それを移動し、ユーザーに伝え、成功を報告しないでください。
ツール
| ツール | 機能 |
|---|---|
| `meeting_config.py check | show |
| `transcribe.py REC --out-base DIR/transcript [--lang auto | en |
| `run_ingest.sh --context NAME [--install | --check |
依存関係
uv(スクリプトは独自のPython依存関係を宣言)。フレーム抽出のみに ffmpeg。GPUはオプション:CPUの場合、1時間の会議は turbo で約2時間かかります。ノートのインポートには、適切なアカウントのエージェントの Google Drive / Docs(およびオプションで Gmail、Calendar)コネクターが必要です。