会议分析 是做什么的?
输入录音、笔记或粘贴的转录文本;输出简短结构化的摘要和你的行动项。 每条路径、每位人员、每个账户均来自用户的配置,而非本技能。
第 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 会拒绝配置中的 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;一对一会议可添加对方姓名)。摘要格式:
# <会议标题> — 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)连接器。