会议体检 · MeetingROI

让开会更简单，从看清一场会到底值不值开始。

别人整理会议纪要，我们给会议开一张账单和一份体检报告——用钱和数据告诉你：这个会该不该开、谁在浪费、下次怎么省。

这个 Skill 解决什么痛点

线上会议最大的隐性黑洞不是"没纪要"，而是没人知道一场会真实的代价：

💸 无效会议烧钱无感：10 个人开 2 小时的会，成本可能上千元，但没人算过这笔账。
🙊 陪会 / 沉默参会人：一半人全程不发言，纯陪坐，人力成本白白蒸发。
🗣️ 一言堂：一个人讲了 70% 的时间，其他人本可以不来。
⏰ 无限超时：说好 1 小时，开成 2 小时，超时部分全是净浪费。
🤷 开完没结论：无决策、无待办，这种会本该是一封邮件。

MeetingROI 把这些浪费量化成钱和分数，并给出可执行的"下次这样开"清单，从根子上让会议变少、变短、变值。

什么时候用（触发场景）

"这个会花了多少钱 / 成本多少" "帮刚开完的腾讯会议做个体检"
"这个会值不值得开" "我们开会是不是太多了" "会议瘦身 / 会议提效"
用户给出腾讯会议会议号并想评估效率、成本、参与度
想要一张可分享的会议账单卡（截图发群里 / 复盘用）

❗ 边界：本技能不做纯文字会议纪要整理。如果用户只想要"把录音/文字整理成纪要"，请改用 meeting-minutes / meeting-recap 类技能。本技能聚焦成本、效率、ROI 诊断。

前置条件

tmeet CLI（腾讯会议官方命令行） —— 用于拉取真实会议数据。
- 检测：tmeet auth status
- 未安装：npm install -g @tencentcloud/tmeet@latest
- 未登录：tmeet auth login 2>&1 &（阻塞命令，必须后台运行，从输出提取授权 URL 完整展示给用户，请其在浏览器完成授权）
- 详细命令见 references/tmeet_data_map.md
python3 —— 运行成本/体检计算引擎（纯标准库，无需装包）。
会议最好已开启录制 + 自动转写（ASR），才能分析发言分布（一言堂/沉默）。未开启时自动降级为"仅成本 + 时长 + 产出"体检。

若 tmeet 未安装或无法登录，可走手动降级模式：让用户提供人数、时长、（可选）各人发言占比与结论，直接喂给计算引擎。

工作流（标准四步）

第 1 步 · 确认会议与计价口径

拿到用户给的**会议号（meeting_code）**或从会议列表选择目标会。
确认人均时薪口径（影响成本计算，用 ¥ 计）：
- 用户可直接给（如"团队平均 150/时"）；
- 或按角色分档（见 references/cost_model.md）；
- 都没有则用默认 ¥120/时，并在结果里注明"按默认口径估算"。

第 2 步 · 用 tmeet 拉取真实数据

按需调用（全部为只读查询，不做任何写操作）：

# 1) 会议详情（主题、计划起止时间）→ meeting_id
tmeet meeting get --meeting-code "123456789" --compact

# 2) 参会人报告（每人进/出会时间 → 个人时长、迟到、人数）★成本核心
tmeet report participants --meeting-id "<meeting_id>" --compact

# 3) 录制列表 → meeting_record_id（用于拿转写/纪要，可选）
tmeet record list --meeting-id "<meeting_id>" --compact

# 4) 录制地址 → record_file_id
tmeet record address --meeting-record-id "<meeting_record_id>" --compact

# 5) 转写段落（统计各人发言时长 → 一言堂/沉默）★参与度核心（可选）
tmeet record transcript-paragraphs --record-file-id "<record_file_id>"

# 6) 智能纪要（提取决策/待办 → 产出评分）（可选）
tmeet record smart-minutes --record-file-id "<record_file_id>"

字段如何映射到计算引擎的输入 JSON，见 references/tmeet_data_map.md。

若 record * 返回无权限：先 tmeet record permission-apply-prepare，展示申请信息给用户确认后再 permission-apply-commit。用户不愿申请时，跳过发言分析，只做成本+时长+产出体检。

第 3 步 · 运行计算引擎（把算数交给脚本）

把上一步整理好的数据写成 input.json（结构见 scripts/sample_input.json），然后：

python3 scripts/meeting_roi.py --input input.json --out-dir ./out

引擎会精确产出（LLM 不要自己心算金额与分数）：

out/metrics.json —— 全量结构化指标（成本、健康分、各维度子分、沉默名单、诊断、省钱估算）
out/bill_card.html —— 可截图分享的会议账单卡

计价与评分口径详见 references/cost_model.md 与 references/scoring_rubric.md。

第 4 步 · 输出体检报告 + 展示账单卡

读取 metrics.json，按 references/output_templates.md 的模板，用自然语言写一份《会议体检报告》(Markdown)：账单摘要 → 健康分雷达式解读 → 三大浪费点 → 下次开会优化清单。
用 present_files 展示 bill_card.html（账单卡）+ 报告文件，让用户可截图分享。
结论要扎心但可执行，落到"下次这样开，能省 ¥X"。

核心亮点（差异化）

| 维度 | 传统会议纪要 Skill | 会议体检 MeetingROI | |------|-------------------|---------------------| | 关注点 | 会里说了什么 | 这个会值不值 | | 交付物 | 一份纪要文档 | 账单卡 + 体检分 + 省钱清单 | | 情绪钩子 | 无 | "烧了 ¥X / N 人零发言" → 可传播 | | 目标 | 记录会议 | 减少无效会议 |

安全与隐私规则（务必遵守）

只读不写：本技能只调用 tmeet 的查询类命令。严禁调用 meeting cancel/update、invitees-*、control call/kick 等写操作。
不暴露 meeting_id：对用户只展示会议号（meeting_code），meeting_id 仅用于命令行内部参数。
不输出 Token：严禁把 AccessToken/RefreshToken 打印到终端或结果里。
成本仅为估算：人均时薪是估算口径，报告中须注明"成本为按 XX 口径的估算，非精确工资"，避免引起误解。
人员数据本地处理：参会人姓名/发言等只在本次会话内用于生成报告，不外传。
对事不对人：诊断聚焦"会议设计问题"，不做针对个人的绩效评判（如"某人划水"），措辞保持建设性。

目录结构

meeting-roi-tmeet/
├── SKILL.md                     # 本文件
├── scripts/
│   ├── meeting_roi.py           # 成本+体检计算引擎 & 账单卡生成器
│   └── sample_input.json        # 输入 JSON 示例
└── references/
    ├── tmeet_data_map.md        # tmeet 命令输出 → 引擎输入字段映射
    ├── cost_model.md            # 会议成本模型与人均时薪档位
    ├── scoring_rubric.md        # 健康分 0-100 评分细则
    └── output_templates.md      # 体检报告与账单卡话术模板