Community生產力與協作github.com

MeetingAnalysis

將會議轉換為結構化摘要與可追蹤的待辦事項。可本地轉錄錄音(支援 CUDA、Apple Silicon 或 CPU 的 faster-whisper),透過連接器匯入 Google Meet / Gemini 筆記,或接受貼上的會議記錄文字稿;產出含決策與行動表格的摘要,並只將屬於您自己的項目推送到 BattlePlan 追蹤器。包含無人看管的收件匣擷取功能(丟入錄音檔,取得摘要),以及錄音絕不進入 git 儲存庫的強制規則。

MeetingAnalysis 是什麼?

MeetingAnalysis 是一個 AI 助理技能,專為將會議錄音、筆記或貼上的文字稿轉換為結構化摘要與可追蹤行動項目而設計。它支援多種輸入方式:使用 faster-whisper 本地轉錄錄音(可在 CUDA、Apple Silicon 或 CPU 上運作)、透過連接器匯入 Google Meet 或 Gemini 筆記,或直接接受貼上的會議記錄文字稿。產出的摘要包含會議背景、討論主題、決定、行動表格(含所有者、優先級與截止日期)及關鍵要點。行動項目可透過 BattlePlan 追蹤器進行管理,僅將使用者自己的項目推送過去,支援乾執行模式與去重。 此技能最獨特之處在於其強制性的隱私與儲存庫安全規則:錄音檔案絕不複製或移動到會議資料夾內,如果原始檔案位於 git 工作樹中,會先將其移至 `recordings_archive` 再處理;摘要資料夾僅允許 `.md`、`.txt`、`.json`、`.jsonl` 及最多 5 個 `.jpg` 關鍵幀(總計 ≤ 1 MB),禁止任何媒體檔案進入 git 儲存庫。此外,還支援機密會議模式,避免在摘要中洩漏敏感資訊。 此技能可在 Claude Code、Cursor 等支援 Skills 目錄結構的 AI 代理程式中使用,透過設定檔 `meeting_config.py` 管理多個會議脈絡(如工作、個人專案等),並支援無人看管的收件匣自動擷取。

相容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/juanmherrerav/agent-workday-skills/tree/main/skills/MeetingAnalysis

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 的檔案
  1. 原始錄音 絕不 複製或移動到會議資料夾內。摘要中會提及該檔案。
  2. 如果輸入的錄音檔案位於 git 工作樹中,請先將其移動到 recordings_archive, 然後從新路徑開始處理。
  3. 暫存音訊與幀會放到暫存目錄,並在清理時刪除。
  4. § 驗證在報告成功之前不得印出任何內容。

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 checkshow
`transcribe.py REC --out-base DIR/transcript [--lang autoen
`run_ingest.sh --context NAME [--install--check

依賴

uv(腳本宣告自身的 Python 依賴)。僅在需要幀擷取時才需要 ffmpeg。GPU 為選用:在 CPU 上,一小時的會議使用 turbo 模型約需兩小時。匯入筆記需要代理程式的 Google Drive / Docs(以及選擇性的 Gmail、Calendar)連接器,並使用正確的帳號。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

BattlePlan

Daily execution plan from a task tracker (local CSV, Excel workbook, or Google Sheet). Groups open tasks by context and sub-context, estimates time, finds parallel threads, and writes ready-to-paste starting prompts per thread. Starts from yesterday instead of from zero — recaps the previous day's agent sessions and git commits, pre-fills the audit, and offers resume commands. Includes an end-of-day handoff (--close), an unattended morning draft (--draft), and task management (add, done, cancel, restore, sweep, batch import). USE WHEN plan my day, daily plan, battle plan, what should I work on, close the day, end of day handoff, morning draft, task overview, standup prep, prioritize tasks, add a task, mark task done, set up battleplan, configure task tracker.

CodeQuality

Code quality loop for any repo, seen through two lenses — a tool lens (linters, type checkers, security, dead-code and duplication scanners; fix by P0 security → P1 correctness → P2 maintainability) and a principle lens (SOLID + Clean Code smells; one principle at a time, propose → confirm → apply behind characterization tests). One manifest of free local tools, one scan, one fix loop, one mandatory Quality Improvement Report. USE WHEN improve code quality, analyze code, fix linting, reduce duplication, add types, security scan, test coverage, refactor, improve code design, apply SOLID, clean code refactor, reduce complexity, kill code smells, make code maintainable, refactor legacy code, single responsibility, dependency inversion, remediation sprint, install quality tools, quality baseline, smell report, refactoring roadmap, what should we fix first. NOT FOR the issue lifecycle, branches, PRs or merging (use IssueFlow; its Remediation workflow calls this skill to pick and scope the w

相關技能