会议纪要助手（腾讯会议增强版 v2.7.2）
> 定位：把会议劳动力整体外包给 AI，人只负责开会，纪要/待办/看板/交付全自动产出。在腾讯会议 MCP 的原始管理能力之上，叠加「会前 → 会中 → 会后 → 洞察 → 场景」五段式 AI 工作流 + auto 一键自动闭环编排器，把会议从「开完即忘」变成「有备而来、有迹可循、有果可追」。
>
> 架构：MCP 原始工具（数据层） + AI 工作流（智能层） + 模板/脚本（交付层）。
>
> 本技能是「行为契约」而非「功能菜单」：下方带 【强制】 标记的动作不可跳过、不可遗漏；带「能力边界」的地方必须如实告知用户限制，不得越界承诺。严格执行才能稳定、可靠、不跑偏。
5 分钟快速开始（新手必读）
> 会议纪要助手 = 把会议劳动力整体外包给 AI。 最快路径：丢一个会议号/链接，说一句「帮我把这个会跑一遍闭环」，auto 编排器自动跑完 会前准备→纪要→待办→看板→质检→脱敏→导出→同步→跟进邮件 全链路，全程零操作。
前置检查（【强制】CLI 安装链路）
本技能依赖腾讯会议 CLI（tmeet）。首次执行任何 tmeet 命令前先运行 tmeet --version；若命令不存在，MUST 先用 Read 工具读取 references/tmeet-cli-install.md 并按其执行（打开官方安装指南 → 完成 CLI 安装与授权 → 重启 AI 工具 → 验证可用）。
> ⚠️ 不要在 SKILL.md 里直接写死安装命令——安装步骤的唯一权威来源是 references/tmeet-cli-install.md 中指向的官方安装指南页面，包名与命令会随版本更新。
🐎 路线 0（推荐 · 一键自动闭环）
直接对 agent 说一句：
> 「帮我跑一下这个会议的闭环：12345678901」（换成你的 9 位会议号）
或命令行直接跑：
python scripts/meeting_assistant.py auto 12345678901 --confirm
auto 会自动按顺序串联 10 步（agenda→minutes→tracker→board→qa→redact→consent→export→sync→followup），断点续跑、失败自愈、敏感动作出草稿，最后给一份汇总报告+产物清单。加 --dry 可预览将执行的步骤不落盘。
🌟 路线 A（对话配置 · 不会命令行也能用）
直接对 agent 说一句：
> 「用 wizard 帮我配置腾讯会议连接」
agent 会带你一步步完成：粘贴 Token → 自动注册 MCP → 自动跑一次真实验证（拉一场近 7 天的会确认链路通了）。全程不用碰终端，链路通了 agent 会直接告诉你。
🛠 路线 B（命令行 · 进阶可选）
- 拿 Token（连接钥匙）：打开 👉 https://meeting.tencent.com/ai-skill/ 登录并复制你的个人 Token。
- 跑安装脚本：在技能目录下执行
bash setup.sh（会引导你设置TENCENT_MEETING_TOKEN并自动注册 MCP），看到🎉 设置完成即连上。 - 说一句话验证：对 agent 说「帮我出一下昨天那场评审会的纪要」——能拉到真实数据并产出，说明整条链路通了。
> 卡在 mcporter: command not found 等命令行报错？不必硬磕——随时可以退回路线 A，直接让 agent 用 wizard 全程对话帮你搞定。
> 完整图文步骤、常见卡点对照、Token 有效期与过期重取，见 references/quickstart.md，先读它再开工。
🌐 路线 C（通道 B · 纯模板零配置，无需 Token / 无需 MCP）
> 完全不需要连接腾讯会议，也能产出规范纪要 / 议程 / 看板等。适合：没配 Token、没装 mcporter、临时手写、涉密本地、网络受限。
- 看有哪些内置模板（离线，33 个）：
bash python scripts/meeting_assistant.py template --action list --scope builtin - 取一个空白模板直接手写（无
--data即出空白模板，保留{{...}}占位符）：
bash python scripts/meeting_assistant.py template --action apply --kind minutes --name 会议纪要模板 --scope builtin --mode offline --out 空白纪要.md - 打开
空白纪要.md按{{...}}填空；可选python scripts/meeting_assistant.py qa --in 空白纪要.md --out 质检.md自检。
> 需要示例数据驱动？同样命令加--data '<json>'即可用内置渲染器渲染（仍不连腾讯会议）。
能力总览（五大模块）
| 模块 | 一句话价值 | 核心交付物 | 主要依赖的 MCP 工具 |
|---|---|---|---|
| 01 会前准备 | 让每场会议都有备而来 | 议程、材料包、参会人快报 | get_meeting / get_meeting_by_code / get_user_ended_meetings / get_smart_summary / get_meeting_invitees |
| 02 会中提效 | 让讨论聚焦、决策高效 | 实时纪要、决策标记、待澄清列表、焦点提醒 | get_transcripts_details / export_asr_details / search_transcripts |
| 03 会后跟进 | 让会议真正落地 | 会议纪要、待办派单、任务看板 | get_smart_summary / get_transcripts_details / get_transcripts_paragraphs |
| 04 效率洞察 | 从会议数据提取价值 | 效率体检、决策溯源、议题聚类 | get_user_ended_meetings / get_smart_summary / search_transcripts |
| 05 场景洞察 | 跨场景串联一气呵成 | 周报/月报、复盘材料、面试/培训台账 | get_user_ended_meetings / get_smart_summary / get_transcripts_details |
配置要求（沿用原 MCP）
> 若已在 CodeBuddy / OpenClaw 中配置过 MCP，无需重复配置，可直接调用 mcporter call tencent-meeting-mcp ...。
- 获取 Token：访问 https://meeting.tencent.com/ai-skill/ 登录并复制个人 Token，配置环境变量
TENCENT_MEETING_TOKEN。 - 注册服务：首次使用运行
bash setup.sh（已自动写入X-Skill-Version=v2.7.2头）；嫌命令行麻烦也可直接对 agent 说「用 wizard 帮我配置」，底层走python scripts/meeting_assistant.py wizard（Token 只经 mcporter 写入，绝不落明文文件）。 - 验证：
mcporter list | grep tencent-meeting-mcp。 - 若未配置 Token，所有工具调用将返回鉴权失败，请先引导用户获取 Token。
- Token 有效期与过期闭环：Token 不是永久有效，通常数小时~数天过期（具体以服务端下发为准）。过期典型症状：①
mcporter call返回401 Unauthorized；②mcporter list里看不到tencent-meeting-mcp服务；③ agent 说「未连接腾讯会议，无法读取」。重取 3 步：① 打开 https://meeting.tencent.com/ai-skill/ 重新复制最新 Token；② 退回「路线 A」让 agent 用 wizard 重配，或export TENCENT_MEETING_TOKEN="新Token"后重跑bash setup.sh；③ 再mcporter list | grep tencent-meeting-mcp复验。
通用工作法则（所有模块必须遵守）
- 会议号 → meeting_id：用户给 9 位
meeting_code时，先用get_meeting_by_code解析出meeting_id再调用其他接口。 - 破坏性操作二次确认：
update_meeting/cancel_meeting前必须向用户展示待操作信息并确认。 - 时间基准 = 北京时间 UTC+8：所有「昨天/今天/近 N 天」以系统当前绝对时间为唯一基准，禁止硬编码年份；未指定年份默认当前年。
- 参数格式不对不擅自修改：如密码非 4~6 位数字，仅提醒用户，绝不自动替换或补生成。
- 输出遵循模板：所有交付物优先套用
references/templates.md中的对应模板。 - 数据密集操作走脚本：跨会议聚合、效率评分、报告生成等用
scripts/meeting_assistant.py渲染，保证格式一致且可落盘。 - 交付前必过质检门禁：所有对外交付的 Markdown 先经
scripts/meeting_assistant.py qa检查（占位符/决策溯源/敏感信息），通过（或用户显式确认）后再交付。 - 隐私合规：纪要/转写含敏感信息（薪/合同/身份证/手机号等）外发前须用户确认；技能不主动外传任何内容。
- 双通道并存：所有模板交付物同时支持「通道 A（MCP 真实数据）」与「通道 B（纯模板离线，零配置）」。未连接腾讯会议时，优先
template --action list/apply --scope builtin走通道 B 出稿。
步骤 0 ｜连接检查（【强制】前置，每次拉取真实会议数据前必做，无绕过路径）
任何需要读取真实会议录制/转写/智能纪要的操作，必须先确认腾讯会议已连接，不提供「跳过连接直接贴文本」或「用模拟数据」等绕过方式。
- 执行
mcporter list | grep tencent-meeting-mcp或任一只读查询（如get_user_meetings）确认服务可用、Token 有效。
> MCP 调用重试约定（v2.5.0 新增）：agent 对每一次mcporter call <tool>封装 ≤3 次重试 + 指数退避（间隔 0.5s → 1s → 2s），每次重试前打印「🔄 正在重试第 N 次：<tool>」。但 401 鉴权失败不重试，直接判定为「连接失败」并走下方第 3 条分支（重配 Token）。仅超时 / 网络抖动等可重试错误才走重试。 - 已连接：直接进入对应模块，正常拉取真实数据。
- 未连接 / 鉴权失败 / 服务不存在：
- 告知用户当前未连接腾讯会议，本技能依赖真实会议数据，无法在未连接状态下继续读取类操作。
- 引导用户按「配置要求」获取 Token 并运行bash setup.sh，完成后用步骤 1 复验。
- 用户不同意连接：明确告知读取类功能无法继续，不做任何降级/伪造处理（纯排版类模板演示除外，且须标注为示例）。
> 例外：纯本地渲染（把用户已提供的 JSON 套模板）和纯排版建议，不强制连接；但凡涉及「从腾讯会议拉数据」，步骤 0 强制生效。
> 双通道降级（v2.5.0 增量）：agent 在「步骤 0」前置调用 python scripts/meeting_assistant.py detect 探测通道。若返回 channel: "offline"，不卡死、不报硬错，而是主动提示用户「可走「纯模板通道」零配置直接套模板手写」——即本文件的「🌐 路线 C」。用户确认即走通道 B；若用户坚持要真实数据，再引导 wizard 配 Token 走通道 A。
生成纪要/议程前 ｜【强制】先选会议结构类型
生成任何纪要或议程初稿前，必须先按会议性质从 references/meeting-structure-library.md 的 10 类「数据驱动结构」中选定一种（①评审决策会 / ②周期同步会 / ③客户洽谈会 / ④项目复盘会 / ⑤培训面试 / ⑥头脑风暴共创 / ⑦高管经营会 / ⑧党政机关会议 / ⑨应急事故响应会 / ⑩跨部门协调会），再据此填充内容：
- 用结构库「可程序化字段信号表（10 类）」按会议真实数据特征辅助判断；命中不了就直接问用户会议性质，不要自行猜测。也可让 agent 跑
python scripts/meeting_assistant.py classify --data '{"subject":"...","keywords":[...],"participants":[...],"history":[...]}'拿到 10 类打分与top推荐，再与用户确认（得分低于阈值need_ask=true时必须问用户）。 - 党政机关会议走特殊分支：正式公文体、以「会议」为叙述主体、不使用 emoji，遵守结构库中的「通用规则」（称谓/行文顺序/使用禁忌/分歧处理）。
- 结构库模板中的条目数量仅为排版示意——真实决策/待办/要点有多少写多少，禁止因示例只列 1–2 条就压缩截断真实内容。
- 交付初版后 【强制】主动邀请用户提供真实历史纪要：说一句类似「若您有这类会议过去人工整理的真实纪要（哪怕 1–2 份），发给我能让后续调整更快贴近团队习惯」——每次交付初版都要触发（用户已提供过则免）。
能力边界（必读，直接决定怎么和用户对话，不得越界承诺）
| 能力点 | 边界 | 应对 |
|---|---|---|
get_user_ended_meetings 回溯 |
依赖必填 start_time/end_time 时间窗；过早的会议需用户提供 meeting_code |
超窗口时请用户手动给会议号，用 get_meeting_by_code 单独查 |
| 「哪些会议相关」的判断 | 系统不能自动识别哪几场属于同一企业/项目 | 候选会议列清单交用户挑，不由 AI 自行判定相关性 |
| 「生成初版」的本质 | 是「选定结构骨架 + 单场会议内容」填充，不是从历史数据归纳企业风格 | 对外表述用「照这个结构帮您生成一版初稿」，不要说「已学会您的风格」 |
| 说话人字段 | 转写里常是匿名标签（如「说话人01」），仅当参会者实名入会且开启识别才显真名 | 按发言人筛选/分析前先看字段；匿名编号需用户协助对应人名，不能猜 |
get_smart_summary 多语种 |
官方原生 lang 仅 default/zh/en/ja 四种，且是重新拉取该语言版本 |
目标语种超出 4 种时走 AI 翻译层处理已生成内容，须告知非官方翻译、准确性不做官方保证 |
| 录制地址 | get_record_addresses 返回整体下载/播放链接，不支持时间戳跳转 |
引用片段用「链接 + 时间段标注」，不要承诺「点击直达 XX 分钟」 |
| 智能纪要准确性 | AI 辅助材料，不保证 100% 准确 | 重要决策类待办建议用户复核 |
| 情绪/参与度分析 | 基于转写文本的启发式估计，非专业心理测量 | 标注为「参考信号」，不作为考核/评价依据 |
| 定时任务（自动化） | 仅支持周期触发（rrule）或指定时间单次，不支持「会议结束」事件触发 | 「会后自动出纪要」本质是周期轮询，须如实告知非实时事件驱动 |
| 同步腾讯文档 | 需腾讯文档连接器已连接；AI 只能创建新文档写入，不能自动分发/通知成员 | 未连接则先出本地文本，不阻塞；文档链接由用户自行转发 |
| 外部系统推送 | 本技能不直接写第三方系统；集成推送依赖对应连接器已连接 | 未连接时降级为本地文件产出 + 引导用户连接 |
常见问题（FAQ）
> 格式：现象/报错 → 原因 → 一步解决（每条都给可复制命令或明确动作，不写「联系管理员」式空话）。
| 现象 / 报错 | 原因 | 一步解决 |
|---|---|---|
mcporter call 返回 401 Unauthorized / 鉴权失败 |
Token 失效、拼错或过期 | 重新获取：https://meeting.tencent.com/ai-skill/ 复制新 Token → export TENCENT_MEETING_TOKEN="新Token" → bash setup.sh 重注册 |
终端提示 mcporter: command not found |
未安装 mcporter | 方案① npm install -g mcporter 后重跑 bash setup.sh；方案② 不想碰命令行：直接对 agent 说「用 wizard 帮我配置」，全程对话完成，无需手动装 mcporter |
get_user_ended_meetings 报错「start_time/end_time 必填」 |
该接口强制时间窗，不能省略 | 显式传时间窗，例如 {"start_time":"2026-07-01","end_time":"2026-07-31"}；超窗口旧会改用会议号 get_meeting_by_code 查 |
转写返回空 / get_transcripts_details 无内容 |
该会未开云录制或转写 | 确认会议开启「自动录制 + 转写」；或换一场有录制的会；纯本地渲染可不依赖转写 |
报错 ❌ [ERR_CODE_FORMAT] 会议号非 9 位 |
给的不是 9 位会议号 | 从会议详情复制正确的 9 位数字会议号（meeting_code），重新传入 |
| 党政机关纪要被公文系统拒收（疑似 emoji/口语） | 公文体禁用 emoji 与第一二人称 | 走结构库⑧正式公文体：用「会议认为/指出/要求」第三人称，删除所有 emoji 与「领导要求/大家同意」等口语 |
| 多语种润色报「超出官方 4 种」 | 官方 lang 仅 default/zh/en/ja |
目标语种超出时走 AI 翻译层处理已生成内容，并向用户说明「非官方翻译，准确性不做官方保证」 |
| 同步腾讯文档时报「连接器未连接」 | 腾讯文档连接器没连 | 先出本地 Markdown 文件（不阻塞），引导用户到连接器设置连接腾讯文档；连上后再用 AI 创建新文档 |
| 用户直接贴文字要纪要但没连腾讯会议 | 未走步骤 0 连接检查 | 纯本地渲染可出稿但须声明「未连接无法核对真实数据」；涉及拉取一律先 mcporter list \| grep tencent-meeting-mcp |
| 定时任务被以为「开完立刻触发」 | 定时仅支持周期/指定时间，非事件触发 | 澄清是周期轮询；如要「会后出纪要」本质是定时轮询最近结束的会 |
失败场景速查（用户会遇到什么）
> 真实使用里会踩的坑都列在这。每条给「你会看到什么 → 怎么恢复 / 降级」。连接类问题优先回步骤 0。
步骤 0 ｜连接
- 你会看到：agent 执行
mcporter call报401 Unauthorized/connection refused，或mcporter list里没有tencent-meeting-mcp。 - 恢复 / 降级：① 确认 Token 有效，重跑
bash setup.sh重注册；② 仍不行按 FAQ 的 401 / mcporter 找不到处理；③ 纯本地渲染类（用户已给 JSON）可继续，但凡要拉真实数据必须连接，不得伪造。
模块 01 ｜会前准备
- 你会看到：
get_user_ended_meetings报start_time/end_time required，或历史会议列表为空。 - 恢复 / 降级：补时间窗参数
{"start_time":"...","end_time":"..."}；过早的会改要会议号走get_meeting_by_code查；列表空就提示用户换时间范围。
模块 02 ｜会中提效
- 你会看到：
get_transcripts_details返回空，或转写全是「说话人01/02」无真名。 - 恢复 / 降级：① 空转写→确认会议开了云录制+转写，或换有录制的会；② 全匿名→按发言人统计照常做，但分析前提示用户协助指认编号对应真名，绝不猜。
模块 03 ｜会后跟进
- 你会看到：多语种润色报「超出官方 4 种」；或同步腾讯文档报「连接器未连接」。
- 恢复 / 降级：① 多语种超限→走 AI 翻译层处理已生成内容，并声明「非官方翻译，准确性不做官方保证」；② 腾讯文档未连接→先出本地 Markdown 不阻塞，引导用户连接后再创建在线文档，链接由用户自发。
模块 04 ｜效率洞察
- 你会看到：
ask跨会议问答返回「未检索到相关记录」；或定时任务没在「会后立刻」出纪要。 - 恢复 / 降级：① 无命中→确认
index索引已覆盖对应时段、换关键词，不臆造；② 定时非实时→澄清是周期轮询最近结束的会，不是事件触发。
模块 05 ｜场景洞察
- 你会看到：要把纪要/内容推到外部系统（如某 IM、工单）时报「未连接」或「不支持」。
- 恢复 / 降级：本技能不直接写第三方系统，外部系统未连接时降级为本地文件产出 + 引导用户连接对应连接器，不阻塞主交付。
模块 01 ｜会前准备（Pre-meeting）
触发
用户说：生成会议议程 / 帮我准备材料 / 参会人都有谁、跟议题有啥关系 / 这场会要聊啥、谁该来。
工作流
1.1 一句话生成会议议程与时长建议
- 从用户一句话中提取：会议目标、隐含议题、参与角色。
- 若会议已预约：用 get_meeting（或 get_meeting_by_code）拉取主题/时间，作为议程时间盒依据。
- 模型推断议程条目、每条建议时长、总时长，并标注「建议预留缓冲」。
- 交付：套用 references/templates.md → 议程模板；或直接 python scripts/meeting_assistant.py agenda --data '<json>' --out 议程.md。
1.2 基于历史会议自动整理参会材料包
- 用 get_user_ended_meetings（按主题/参会人筛选近期同类会议）拿到历史会议列表。
- 对最相关的 3~5 场，用 get_smart_summary 或 get_transcripts_details 提取：既往结论、遗留待办、关键文档提及。
- 汇总成「材料包」：背景、前情回顾、待延续事项、建议预读。
- 交付：材料包模板。
> 最小输入 → 期望输出（人工回归示例）
> - 输入：会议主题=Q3增长复盘 + get_user_ended_meetings（近 30 天，关键词"增长"）返回的 4 场历史会议 record_file_id 列表
> - 处理：逐场 get_smart_summary 提取「既往结论 / 遗留待办 / 文档提及」→ 聚合去重
> - 输出：套用材料包模板，含板块：背景速览 / 前情回顾（≥2 条历史结论）/ 遗留待办（标注原负责人+状态）/ 建议预读 / 本场目标
1.3 参会人画像与议题相关性快报
- 用 get_meeting_invitees（或 get_meeting_participants）拿参会名单。
- 对每位参会人，回溯 get_user_ended_meetings 统计：历史参会频次、常驻角色、相关议题。
- 将议程条目与参会人历史议题做相关性匹配，输出「谁该重点参与哪条议题」。
- 交付：参会人快报模板。
> 最小输入 → 期望输出（人工回归示例）
> - 输入：get_meeting_invitees（会议号）→ 名单 [小李, 小王, 陈旭] + 议程条目 [增长数据, 下季策略]
> - 处理：回溯各人 get_user_ended_meetings 历史频次/常驻角色 → 与议程做相关性匹配
> - 输出：套用参会人快报模板，含表格：参会人 × 历史频次 × 常驻角色 × 强相关议题 × 建议关注点 + 议题—人员匹配建议（如"下季策略建议陈旭主导"）
1.4 会议预设模版（一键套用）
- 将常用会议配置（入会限制、等候室、水印、自动录制、自动转写、议程骨架）存为预设：preset --action save --name <预设名> --data '<json>'。
- 下次建会：preset --action list 选择后 preset --action emit 输出 schedule_meeting 的 --args JSON，结合本次时间直接调用，免去逐项重配。
- 交付：预设清单 / 建会参数（由 preset 子命令渲染）。
模块 02 ｜会中提效（In-meeting）
触发
用户说：帮我记一下 / 实时纪要 / 刚才谁做了什么决定 / 把发言摘录出来 / 有没有跑题。
工作流
2.1 实时纪要 + 关键决策自动标记
- 进行中会议用 export_asr_details（实时转写）；已结束用 get_transcripts_details（需 record_file_id，先 get_records_list 取）。
- 模型流式整理纪要点；对含决策语义的句子（决定/同意/确认/分配/通过/否决）自动加 🔑 决策 标记并抽出「决策事项 + 决策人 + 时间」，每条决策带 🔗 时间锚点（格式 🔗 HH:MM 原话/段落）。
- 说话人参与度（P2）：若转写为实名，顺带输出「说话人贡献」统计（发言轮次/时长占比），作为会后效率分析的输入；匿名编号则跳过并说明。
- 交付：实时纪要模板（已含时间线与决策汇总结构）。
> 最小输入 → 期望输出（人工回归示例）
> - 输入：export_asr_details（进行中）或 get_transcripts_details（已结束，需 record_file_id 先经 get_records_list 取）
> - 处理：流式整理纪要点；对含"决定/同意/确认"等句子加 🔑 标记并抽「决策 + 决策人 + 时间 + 🔗 锚点」
> - 输出：套用实时纪要模板，含板块：时间线（HH:MM 发言人:要点）/ 关键决策汇总（≥1 条带 🔑 与 🔗）/ 当前重点
2.2 发言摘录与待澄清问题列表
- 按发言人聚合高价值原话（金句、承诺、异议），形成发言摘录。
- 扫描「待定 / 不确定 / 需要确认 / 之后再议 / 谁负责」等表述，汇总为待澄清问题列表，每条标注提出人 + 关联议题。
- 交付：发言摘录 / 待澄清模板。
> 最小输入 → 期望输出（人工回归示例）
> - 输入：同上转写文本（或 get_transcripts_details 段落）
> - 处理：按发言人聚合高价值原话（金句/承诺/异议）；扫描"待定/需确认/谁负责"等表述
> - 输出：套用发言摘录/待澄清模板，含板块：发言摘录（发言人:「原话」:价值）/ 待澄清问题列表（问题/提出人/关联议题/状态=待确认）
2.3 会议焦点偏移智能提醒
- 若会前已生成议程（模块 01），将实时讨论流与议程条目做对齐。
- 当连续讨论明显偏离议程某条目超过约 5 分钟，或切入未列出的新主题，给出简短「焦点偏移提醒」：当前在聊什么、偏离了哪条、建议拉回或追加议程。
- 实时辅助（P2，会中话术）：在偏移提醒基础上，可补充一句走神/冷场提示或推进话术（如"该议题已超时，建议限定 3 分钟收敛"）；仅作轻量 inline 建议，不强制落盘。
- 交付：轻量 inline 提醒文本（不强制落盘，除非用户要存档）。
2.4 时间戳片段索引（P2）
- 从转写中挑出高价值瞬间（关键决策、承诺、争议），生成片段索引：录制链接 + 时间段标注（链接 + 起止 HH:MM），不做时间戳跳转承诺。
- 脚本：python scripts/meeting_assistant.py clip --data '<json>' --out 片段索引.md。
- 交付：时间戳片段索引模板（见附录 B）。
模块 03 ｜会后跟进（Post-meeting）
触发
用户说：出会议纪要 / 翻译成英文 / 把待办分给某某 / 设个截止提醒 / 看看这些会都派了啥活。
工作流
3.1 会议纪要一键生成 + 多语种润色 + 结构选型
- 【强制】先选结构类型：生成前按 references/meeting-structure-library.md 选定 10 类之一（⑨应急事故响应会 / ⑩跨部门协调会 亦在其中；党政机关走正式公文体），再填充内容（见「生成纪要/议程前」规则）。
- 组合 get_smart_summary（可传 lang=zh/en/ja 取机翻基线）与 get_transcripts_details（补全细节）。
- 模型重写为结构化纪要：背景、结论、决策、行动项、风险/疑问；每条决策带 🔗 来源锚点。
- 多语种：调用 get_smart_summary 的 lang 参数取译，或直接由模型润色为目标语种；目标语种超出官方 4 种时走 AI 翻译层并如实告知。
- 交付前 【强制】过 QA 门禁（升级能力 B）。
- 交付：会议纪要模板（按选定结构类型成型）；脚本：python scripts/meeting_assistant.py minutes --data '<json>' --out 纪要.md。
- 同步交付（P1）：纪要 QA 通过后，若用户要对外分发，引导用已连接的腾讯文档连接器把纪要写成在线文档并返回链接（AI 只创建新文档，不自动通知成员）；未连接则先出本地文件，不阻塞。
3.2 待办自动派单 + DDL 提醒
- 从纪要抽取行动项：负责人（owner）、动作（action）、截止日（DDL）、来源议题。
- 派单：明确到人（结合模块 01 的参会人画像确认合理归属），输出待办派单模板。
- DDL 提醒：将待办写入本地追踪文件；若用户要求提醒，使用本助手自身的定时/提醒能力（automation）在 DDL 前推送，或建议用户写入日历。
- 脚本：python scripts/meeting_assistant.py board --data '<json>' --out 待办.md。
> 最小输入 → 期望输出（人工回归示例）
> - 输入：会议纪要文本（含决策/行动项段落）
> - 处理：抽取 owner / action / DDL / 来源议题；结合模块 01.3 参会人画像确认归属合理；标 P0/P1/P2 优先级
> - 输出：套用待办派单模板（序号/负责人/动作/DDL/来源议题/优先级）+ 自动触发 board 渲染跨会议看板；DDL 登记提醒（逾期/临期标红）
3.3 跨会议任务进度看板
- 收集多场会议的待办 JSON，聚合为看板：按「负责人 / 状态（待开始·进行中·已完成·逾期）/ DDL」分组。
- 自动标红逾期项与临近 DDL 项。
- 交付：任务看板模板（由 board 子命令渲染）。
- 统计口径：闭环率 = 已完成任务数 ÷ 总任务数；逾期项计入总数并单独标红提示，不重复计入已完成（详见模板 8）。
3.4 个性化模板学习闭环
- 用户对某份交付物初稿（纪要/议程/看板/报告等）微调并认可后，执行 python scripts/meeting_assistant.py template --action save --kind <类型> --name <风格名> --data '<json>'，将其结构（板块划分、行文风格、待办颗粒度）沉淀为个人/企业模板，存入 assets/user_templates/。
- <类型> 支持全部渲染器：agenda / minutes / board / scorecard / report / retrospective / cluster / interview / training。
- 后续同类会议：template --action list 选模板 → --action apply --kind <类型> --name <风格名> --data '<新数据>' 用模板结构套新内容渲染初稿，模型再做语境适配。
- 形成 学习 → 生成 → 调整 → 沉淀 的持续迭代闭环。
3.5 待办持久化追踪 tracker（v2.5.0，G2/G4）
- 纪要/行动项抽取后，由 agent 写入本地持久化台账 assets/todos.json（单用户，schema 见 references/templates.md → 待办追踪视图）：
python scripts/meeting_assistant.py tracker --action add --data '[{"title":"...","owner":"张三","ddl":"YYYY-MM-DD","priority":"P1","meeting":"产品评审"}]'
- 进度回写：tracker --action complete --id <t+YYYYMMDD-xxxxxx> 置 done 并填 completed_at。
- 视图/提醒：tracker --action list [--status todo|doing|done] 全量或按状态；today 列出 DDL ≤ 今天且未完成 的待办（含逾期+今日到期，并附「未来 3 天内临期」提醒）；overdue 专列 DDL < 今天且未完成 的逾期项（🔴 标红）。状态着色与看板一致。
- 模板见 references/templates.md → 待办追踪视图。
3.6 跟进邮件/IM 草稿生成（v2.6.0，G12）
- 会议结束后，根据会议要点 + 行动项 + 下一步，自动生成跟进邮件或 IM 草稿。
- 脚本：python scripts/meeting_assistant.py followup --data '{"meeting":"...","type":"email","key_points":[...],"actions":[...],"next_steps":[...],"sender":"张三"}' --out 跟进.md。
- 邮件模式含主题行/要点/行动项表/下一步/签名；IM 模式精简版适合 IM 粘贴。
3.7 会议健康度趋势分析（v2.6.0，G15）
- 多期 scorecard 聚合，计算综合评分趋势（↑↓→）+ 维度趋势 + coaching 建议。
- 脚本：python scripts/meeting_assistant.py trend --data '{"scope":"...","periods":[{...},{...}],"coaching":[...]}' --out 趋势.md。
- 需 ≥2 期数据；仅 1 期时输出单期体检 + 提示。
3.8 隐私脱敏 + 录制同意（v2.6.0，G16）
- 隐私脱敏：纪要含手机号/身份证/邮箱/银行卡/薪资等敏感信息，外发前用 redact --in 纪要.md --out 脱敏.md 一键打码；自定义规则放 assets/redact_rules.json。
- python scripts/meeting_assistant.py redact --in 纪要.md --out 脱敏.md（输出脱敏版 + 末尾统计报告）
- python scripts/meeting_assistant.py redact --list-rules（列出当前生效规则）
- 录制同意文案：生成中英文录制通知/同意书模板。
- python scripts/meeting_assistant.py consent --type notification --lang zh --data '{"subject":"...","date":"...","host":"..."}' --out 通知.md
- ⚠️ 文案仅供参考，法律效力以当地法规为准。
模块 04 ｜效率洞察（Insights）
触发
用户说：这周会开得咋样 / 给我们做个会议效率体检 / 这个决定当初谁拍的、为啥 / 把近一个月的议题归个类。
工作流
4.1 团队周 / 月度会议效率体检 + 说话人参与度分析（P2）
- get_user_ended_meetings 取周期（周/月）内会议清单。
- 逐场计算：实际时长 vs 预定、出勤率、决策数、行动项数、是否超时。
- 聚合为团队效率评分卡：总会议时长、平均偏离、决策密度、待办闭环率。
- 说话人参与度：从转写（实名时）统计每人发言轮次、时长占比、被提及次数，输出 talk-time 分布与「一言堂/沉默者」信号，情绪倾向仅作启发式参考信号（见能力边界）。
- 脚本：python scripts/meeting_assistant.py scorecard --data '<json>' --out 效率体检.md；说话人分析：python scripts/meeting_assistant.py speaker --data '<json>' --out 说话人分析.md。
4.2 决策溯源 + 上下文回溯
- 从某场纪要取决策点，用 search_transcripts 在该场 record_file_id 内回索原始发言片段。
- 输出「决策 → 提出人 → 原话 → 时间锚点 → 背景上下文」链路。
- 交付：决策溯源模板。
> 最小输入 → 期望输出（人工回归示例）
> - 输入：某决策点（来自纪要，如"上线 v2.3"）+ 该场 record_file_id
> - 处理：search_transcripts（record_file_id, 关键词"v2.3"）→ 回索原始发言片段及时间锚点
> - 输出：套用决策溯源模板，含链路：决策 → 提出人 → 原话（🔗 锚点 HH:MM）→ 时间锚点 → 背景上下文 + 关联材料
4.3 跨会议关键议题聚类分析
- 汇总周期内多场 get_smart_summary 的议题/结论，按主题聚类（如「需求变更」「人力」「风险」）。
- 输出聚类树 + 每类出现频次 + 关联会议列表。
- 脚本：python scripts/meeting_assistant.py cluster --data '<json>' --out 议题聚类.md。
4.4 跨会议全局问答（P1，AskMeeting）
- 把多场会议的纪要/结论/决策/待办汇成本地索引：python scripts/meeting_assistant.py index --data '<json>' --out 会议索引.md（生成可检索的结构化条目 + 落 assets/meeting_index.json）。
- 用户用自然语言提问（如「上个月关于定价都决定了什么」「谁负责过登录改版」），脚本按关键词检索命中条目：python scripts/meeting_assistant.py ask --data '{"q":"定价 决策","index":"assets/meeting_index.json"}' --out 答复.md；模型再基于命中片段组织答复并标注来源会议 + 锚点。
- 交付：全局问答答复模板（含答案 + 证据来源列表，见附录 B）。
> 最小输入 → 期望输出（人工回归示例）
> - 输入：近 30 天多场会议的 {meeting, date, decisions[], actions[], conclusions[]} 列表 → index 建索引
> - 处理：ask 按问题关键词在索引中检索命中条目（决策/待办/结论）
> - 输出：套用全局问答模板，含：直接回答 + 证据来源（会议名/日期/原条目）；无命中时明确「未检索到相关记录」，不臆造
>
> ask --person（v2.5.0，G7 承诺台账）：在 --data 中加 "person":"张三"，或在命令行加 --person 张三。检索命中先按 owner 做归一化子串匹配（去空格/括号/称谓）过滤出该人相关条目；再读取 assets/todos.json，按 owner 匹配该人已追踪的承诺（含 status/优先级/DDL），合并渲染为「某人承诺台账」视图。person 缺省时与现有行为完全一致；todos.json 缺失时退化为仅索引命中，不阻塞。
>
> ask --meeting（v2.6.0，G14 单会议问答）：在 --data 中加入 "meeting": {会议结构化JSON} 字段，跳过索引文件直接对该场会议检索。无命中时明确输出「本场未检索到与「{q}」相关的记录」，不臆造答案。
> bash
> python scripts/meeting_assistant.py ask --data '{"q":"定价","meeting":{"meeting":"Q3评审","decisions":[{"decision":"定价5元","owner":"张三"}]}}' --out 答复.md
>
4.5 说话人跨会议对比（v2.6.0，O1）
- speaker --action compare：跨会议 talk-time 统计 + 按 会议类型 × 发言人 交叉统计 + 可选 focus_person 承诺 vs talk-time 对比。
- 脚本：python scripts/meeting_assistant.py speaker --action compare --data '{"meetings":[...],"focus_person":"张三"}' --out 对比.md。
- 聚焦人分析从 assets/todos.json 读取该人已追踪承诺，与 talk-time 对比，提示「光说不做」或「发言多但落实少」风险。
4.6 会议类型判别 top3 可视化（v2.6.0，O2）
- classify 在 need_ask=true（得分低于阈值）时，自动追加 top3 表格输出供用户选择。
- 脚本：python scripts/meeting_assistant.py classify --data '{"subject":"未知会议"}'。
模块 05 ｜场景洞察（Scenarios）
触发
用户说：根据会议写周报 / 生成月报 / 做个项目复盘 / 把面试记录整理一下 / 沉淀培训内容。
工作流
5.1 周报 / 月报基于会议记录自动起草
- 取周期内全部纪要（模块 03 产物或 get_smart_summary），提炼：完成事项、进行中、风险阻塞、下周计划。
- 套用汇报语气生成周报/月报。
- 脚本：python scripts/meeting_assistant.py report --data '<json>' --out 周报.md。
5.2 项目复盘材料一键生成
- 聚合某项目的多场决策 + 待办闭环情况 + 遗留风险，生成复盘：目标回顾、关键决策时间线、成效与偏差、经验沉淀、改进项。
- 脚本：python scripts/meeting_assistant.py retrospective --data '<json>' --out 复盘.md。
5.3 面试 / 培训记录结构化沉淀
- 面试：从转写提取候选人信息、问答亮点、能力评估、录用建议，输出结构化面试台账。
- 培训：提取课程大纲、知识点、学员疑问、行动建议，输出培训沉淀。
- 脚本：python scripts/meeting_assistant.py interview --data '<json>' --out 面试记录.md / training ...。
升级能力 A：个性化模板学习闭环（取自 SkillHub 参赛经验）
> 借鉴参赛作品「会议纪要模版定制」的 学习 → 生成 → 调整 → 沉淀 闭环。
触发
用户说：按我们公司风格出纪要 / 保存这个模板 / 套用上次的纪要格式 / 学习我的偏好。
工作流
- 正常生成一份纪要/议程初稿（模块 01 / 03）。
- 用户认可后执行
python scripts/meeting_assistant.py template --action save --kind <类型> --name <风格名> --data '<json>'，将结构（板块划分、行文风格、待办颗粒度）沉淀到assets/user_templates/。 <类型>支持全部渲染器：agenda / minutes / board / scorecard / report / retrospective / cluster / interview / training。- 后续同类会议：先
template --action list选模板，再--action apply --kind <类型> --name <风格名> --data '<新数据>'用模板结构套新内容渲染初稿，模型做语境适配。 - 持续迭代：每次调整都可沉淀为新版本，越用越贴合。
- 【强制】沉淀完成后完整列出全部增值选项供用户挑选（多语言输出 / 同步腾讯文档 / 特定发言人侧重版 / 定时任务自动出纪要 / 存为团队模板），不要只提其中一两项、不要等用户自己想起来问。
- 交付后主动提示（新手版话术）：每次交付初稿后顺带一句——「这份纪要要不要存成团队模板，下次同类型会议一键复用？需要对外分发的话，我也可以同步到腾讯文档生成在线链接。」把「沉淀团队模板」与「同步腾讯文档」作为默认勾选项主动抛出，而不是等用户问。
升级能力 B：交付前质检 QA Gate（取自 SkillHub 参赛经验）
> 借鉴参赛作品「slide-maker」的交付前独立评审 + 确定性检查。
触发
每一次对外交付（纪要/报告/看板/复盘等）前自动执行。
工作流
- 渲染产物先
python scripts/meeting_assistant.py qa --in <产物.md> --out <质检报告.md>：
- 是否残留{{...}}占位符；
- 决策是否带🔗 来源溯源标注（默认开启决策溯源）；
- 是否含敏感信息（薪资/合同/身份证/手机号等），命中则标红提示用户确认后再外发；
- 关键板块（结论/决策/行动项）是否齐全。
- （v2.5.0）确定性表格检查：「行动项」表存在负责人或 DDL 为空的行、「决策」表存在决策人为空的行、「待澄清问题列表」存在状态仍为待确认/未闭环的行，均计为 WARN，提示补全责任人与闭环。
- （v2.6.0）BANT/MEDDICC 方法论字段检查（O4）：检测<!-- methodology: BANT -->或<!-- methodology: MEDDICC -->标记后，按必填字段清单逐项检查——BANT 检查预算/决策者/需求/时间线 4 字段，MEDDICC 检查衡量指标/经济决策者/评估标准/决策流程/识别痛点/内部支持者/竞争对手 7 字段，缺项计 WARN。 - 输出 PASS / WARN / FAIL；WARN/FAIL 须修正或用户显式确认后才交付。
升级能力 C：会议预设模版（取自 SkillHub 参赛经验）
> 借鉴参赛作品「预定会议模版设置」。
触发
用户说：用上次的配置建会 / 保存这个会议模版 / 列出会议预设。
工作流
- 常用会议配置存为预设：
preset --action save --name <预设名> --data '<json>'。 - 下次建会：
preset --action list选择，preset --action emit --name <预设名>输出schedule_meeting的--argsJSON，结合本次时间直接调用。
升级能力 D：跨会议全局问答 / 说话人分析 / 时间戳片段（取自主流 AI 会议工具）
> 借鉴 Fireflies「AskFred 跨会议问答」、Fathom「说话人分析」、通用「时间戳片段」经验，全部为确定性脚本 + AI 组织，离线可回归。
触发
用户说：这些会都决定过啥 / 谁负责过某事 / 谁说得最多、有没有一言堂 / 把关键片段标出来。
工作流
- 全局问答：
index建索引 →ask检索命中 → 模型基于命中片段答复并标来源（见模块 04.4）。 - 说话人分析：
speaker渲染 talk-time 分布、参与度、被提及、启发式情绪信号（实名转写才有效，匿名需用户对应）。 - 时间戳片段：
clip渲染「录制链接 + 时间段标注」的片段索引（不承诺时间戳跳转）。
升级能力 E：同步交付到腾讯文档（P1，集成推送）
> 让纪要真正「发得出去」，而非停留在本地文件。
触发
用户说：把纪要同步到腾讯文档 / 发个在线链接给团队。
工作流
- 纪要先过 QA 门禁（升级能力 B）。
- 检查腾讯文档连接器是否已连接：未连接 → 先出本地文件并引导用户连接，不阻塞。
- 已连接 → 用连接器把纪要 Markdown 创建为新在线文档（标题建议
{{团队}}-{{会议主题}}-{{日期}}），返回链接由用户自行分享。 - 边界：AI 只创建新文档写入内容，不自动分发/@通知成员；多语言版本分别建档。
- 交付后主动提示（新手版话术）：连上腾讯文档后，交付纪要时主动问一句——「需要的话我可以把这份纪要同步到腾讯文档，生成一个团队都能打开的在线链接；也可以存成团队模板，下次同类会议直接套。」未连接时降级为本地文件并引导连接，不阻塞。 - 多格式导出（v2.5.0，G5；v2.6.0 增强 G13）：本地 Markdown 交付物可用
python scripts/meeting_assistant.py export --in <纪要.md> --format md|docx|pdf|csv|txt [--out <路径>]导出。md永远可用（轻度美化后落盘）；docx需要python-docx（缺失会友好提示pip install python-docx并退出，不崩溃）；pdf需要pandocCLI（缺失同样友好提示安装命令）；csv（v2.6.0）从 Markdown 提取行动项表输出 9 列 CSV（UTF-8 BOM，Excel 可直接打开）；txt（v2.6.0）去除所有 Markdown 语法标记输出纯文本。文档未连接外部系统时，先出本地 md，再按需导出。
附录 A：MCP 工具速查（数据层，保留原三大类）
> 详细参数与返回值见 references/api_references.md。调用统一前缀：mcporter call tencent-meeting-mcp <tool> --args '{...}'。
1. 会议管理
- schedule_meeting 创建会议（必填 subject/start_time/end_time；周期会议加 recurring_type/until_count）
- update_meeting 修改会议（先二次确认；meeting_code 先 get_meeting_by_code）
- cancel_meeting 取消会议（先二次确认）
- get_meeting 会议详情（默认只返回昵称）
- get_meeting_by_code 会议号 → meeting_id
2. 成员管理
- get_meeting_participants 实际参会明细
- get_meeting_invitees 受邀成员
- get_waiting_room 等候室成员
- get_user_meetings 进行中/即将开始会议列表
- get_user_ended_meetings 已结束会议列表（必填 start_time/end_time）
3. 录制与转写
- get_records_list 录制列表（取 record_file_id；meeting_code 先解析）
- get_record_addresses 录制下载地址
- get_transcripts_details 转写详情（record_file_id 必填）
- get_transcripts_paragraphs 转写段落分页
- search_transcripts 转写关键词搜索
- get_smart_summary 智能纪要（lang: default/zh/en/ja）
- export_asr_details 导出实时转写（meeting_id 必填）
附录 B：输出模板索引
所有交付物模板见 references/templates.md：议程、材料包、参会人快报、实时纪要、发言摘录/待澄清、会议纪要、待办派单、任务看板、效率体检、决策溯源、议题聚类、周报/月报、复盘、面试/培训台账、质检报告、中文排版规范、个性化模板/会议预设数据结构、10 类会议结构库（references/meeting-structure-library.md）、说话人分析、时间戳片段索引、全局问答答复。
模板/说明变更：质检报告模板、中文排版规范、个性化模板/会议预设数据结构（v2.1.0）；QA 同义词表、模板套用扩展至全部渲染器、看板闭环率口径说明（v2.1.1）；版本号与文档一致性修正（v2.1.2）；8 类会议结构库 + 党政公文体、说话人分析/时间戳片段/全局问答/腾讯文档同步交付 4 项新能力、行为契约（步骤0/结构选型/能力边界/FAQ）、升级能力 D/E（v2.2.0，见 references/meeting-structure-library.md 与各模块）。
不触发边界
- 腾讯文档独立编辑/批量管理（本技能仅在「同步交付」场景创建新文档写入纪要，不做文档本身的其他管理）。
- 通用日程/提醒（非腾讯会议）、即时通讯、企业微信审批/打卡、PSTN 通话、视频剪辑、Zoom/Teams/飞书/钉钉等其他会议平台原生的会议录制与纪要（本技能只对接腾讯会议 MCP）。
