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> # 解析出一個脈絡的完整設定
無設定檔,或列出問題 → 先執行 Workflows/Setup.md。
設定檔位於 $MEETING_ANALYSIS_CONFIG,否則為
${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/MeetingAnalysis/config.json。
工作流程
| 觸發條件 | 工作流程 |
|---|---|
| 首次使用、新的脈絡、新的筆記提供者、「設定會議分析」 | 設定 |
| 錄音路徑、「分析這場會議」 | 分析:搬移 → 轉錄 → 幀處理 → 摘要 → 追蹤器 → 歸檔 → 驗證 |
| 「僅轉錄」 | 僅轉錄 |
| 「匯入會議筆記」、Gemini 筆記、貼上的會議記錄文字稿、會議連結 | 匯入筆記 |
/MeetingAnalysis ingest <context> --unattended、「會議收件匣」、排程 | 自動擷取 |
強制不變規則 — 儲存庫中不得有媒體檔案
會議資料夾通常位於 git 儲存庫內(筆記儲存庫、第二大腦)。Git 會永久保留所有已提交的 blob:一個 800 MB 的錄音檔會在每次克隆時佔用 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 會拒絕位於 git 工作樹內的 recordings_archive 或擷取家目錄。
機密脈絡
"confidential": true 表示該會議屬於雇主或客戶,且會議資料夾或追蹤器為個人使用。此時:不得複製逐字稿或筆記(摘要改為連結回原始來源),摘要使用通用用語(決定、主題、負責人、票號),不得包含主機名稱、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> 是從會議標題產生的短 kabab-case 名稱(weekly-status、pricing-review;一對一會議可加上對方姓名)。摘要格式:
# <會議標題> — YYYY-MM-DD
**與會者:** …
**來源:** <錄音檔案名稱(歸檔於儲存庫外)| 筆記文件連結 | 來自 <工具> 的貼上文字稿>
**逐字稿:** <檔案名稱 | 連結 | 未複製>
---
## 背景
## 討論的主題
### 1. <主題> (MM:SS–MM:SS)
## 決定
## 立即行動項目
| # | 行動 | 負責人 | 優先級 | 截止日期 |
|---|--------|-------|----------|----------|
## 關鍵要點
行動表格列出所有負責人,以確保記錄完整;只有屬於您的項目才會進入追蹤器。
行動項目 → 追蹤器
設定檔中的 tracker: "BattlePlan" 會透過 BattlePlan 的冪等 batch-add 功能傳送您的項目("none" 則跳過此步驟)。「您的」項目定義為:負責人是您或您的 owner_aliases 之一、您是數位負責人之一,或您在場的會議中出現「我們/團隊」。子脈絡:優先匹配行動項目中的 tracker_sub_context_rules 正則表達式,否則使用脈絡的 tracker_sub_context。將相對截止日期相對於會議日期解析。來源欄位:Meeting: <標題> YYYY-MM-DD (recording|notes|pasted),由於去重鍵以此為依據,因此跨執行穩定。顯示 --dry-run 並取得確認,除非在無人看管模式下執行。
姓名
語音辨識與會議記錄工具常會搞錯姓名。請根據名冊檔案(roster_file:每行一人,格式為 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 "<meeting folder>" -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 folder>" -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 上,一小時的會議使用 turbo 模型約需兩小時。匯入筆記需要代理程式的 Google Drive / Docs(以及選擇性的 Gmail、Calendar)連接器,並使用正確的帳號。