WorkBuddy 会议助手（Meeting Assistant）v1.0.10

这个技能是什么？ 一个帮你把会议价值留住的纪要助手。它把会议的采集、提炼、确认、分发串成一条流水线：自动拉取腾讯会议/IMA 录音或企业微信会议纪要，按 15 类场景（面试、周会、复盘、头脑风暴、通用兜底……）套好模板提炼成结构统一的纪要，你过目确认后一键分发到钉钉、飞书、腾讯文档或企业微信。

它能帮你解决什么？

• 省时间：不用再手动听录音、敲纪要
• 有重点：固定模板，每次产出结构一致，回头好找
• 放心发：敏感内容先预览再发，不会误发；同一场会议不会重复推送
• 不割裂：腾讯会议、钉钉、飞书之间的搬运活，它替你串起来

快速开始

• 开完会了 / 整理一下 → 自动拉最近会议录制 → 套场景模板 → 预览确认 → 推送
• 发钉钉 / 发飞书 / 发腾讯文档 → 取内容 → 加工 → 本人预览 → 确认后推群/创建文档
• 整理企业微信里的会议纪要 / 把企业微信这场会发一下 → 读企业微信会议纪要文档/群消息 → 套模板 → 预览 → 推送
• 按 XX 模板整理 → 指定场景（面试/复盘/周会…）→ 套模板加工
• 发到腾讯文档让我手动改 → 取内容 → 加工 → 创建智能文档 → 返回文档链接

首次用需一次性 OAuth 授权（tmeet/dws/lark-cli/wecom）；无录制可粘贴智能纪要走手动模式。

简化说法识别表

不确定简化说法能不能识别？对照下表：

定位

纯编排器：获取/转写/推送委托外部 CLI 与连接器，本 Skill 只做调度+模板加工+隐私闸门+去重。

• 获取：tmeet（腾讯会议）、ima-mcp（IMA）、wecom（企业微信会议纪要文档/群消息）
• 推送：dws（钉钉）、lark-cli（飞书）、tencent-docs（腾讯文档）、wecom（企业微信文档/群消息）
• 加工：15 类场景模板固化在 references/templates/

场景模板体系（核心）

内置 15 类场景模板（含兜底），Agent 自动识别并套用对应模板。

场景索引表

场景识别依据：详见 references/scene-decision-tree.md，按「显式指定→标题/内容关键词→易混淆区分→兜底 generic」决策，置信度 ≤ 70% 主动询问。

场景识别与确认

1. 自动选场景：标题+内容关键词匹配；用户显式指定优先
2. 预览即确认：Step 4 预览时可见场景是否选对
3. 无匹配兜底：默认 generic.md

降级模式

输出模式选择

按需求与会议复杂度自动切换：

• 精简模式：说「简版」「只要待办」「快速」，或短会/少人/单议题 → 仅基本信息 + 决策项 + 待办 + 跟进。
• 完整模式：复盘、多议题或明确要求 → 7 段式（信息/要点/决策/待办/待澄清/跟进/复盘）。

默认完整；明确要求精简时切换。

新手引导：依赖连接自检

依赖自检清单

未就绪时的授权引导

腾讯会议 → tmeet auth login IMA → 连接器市场启用 ima-mcp 钉钉 → dws auth login 飞书 → lark-cli auth login --scope "im:message.send_as_user" 腾讯文档 → 连接器市场启用 tencent-docs 并登录 企业微信 → npm install -g @wecom/cli@0.1.9 后 wecom-cli init --noninteractive 授权

交互原则：按选定源检查、列清单不阻塞；未就绪不进取内容，连好后复检。

首次配置（去硬编码）

环境相关值首次运行时提供并缓存到 config.json：ima_kb_id/feishu_default_group/dingtalk_default_group/wecom_default_chat/output_format（默认 markdown）。状态目录 ~/.workbuddy/workbuddy-meeting-assistant/（Win %USERPROFILE%.workbuddy...）。首次运行 python scripts/init_state.py 自动创建。

飞书授权固定流程（send_as_user scope）

飞书推送走 --as user，必须命中 im:message.send_as_user scope（仅登录不够，缺则报 missing_scope 被拦截）。

补齐步骤：

1. lark-cli auth login --scope "im:message.send_as_user" --no-wait --json 取 verification_url + device_code
2. lark-cli auth qrcode "" --output feishu_auth_qr.png 生成二维码给用户
3. lark-cli auth login --device-code "" 轮询至授权完成
4. 重跑 auth status 确认 scope 已含 im:message.send_as_user

device_code 约 10 分钟有效，过期重走第 1 步；不跨会话缓存 url / device_code。

架构总览（工作流节点图）

本 Skill 用工作流编排组织执行：每个处理步骤是一个节点（Node），节点间的数据流向由**连线（Edge）**显式声明。完整节点-连线定义见 references/workflow.json，字段规范与命令手册见 references/workflow-engine.md。

源(Step1)          加工(Step2/3)              闸门(Step4)     推送(Step5)
tmeet-record ─┐
ima-media ────┤
wecom-doc ────┼─► dedup-check ─► split-chunks ─► scene-classify
wecom-msg ────┤      │                                   │
manual-paste ─┘   (已处理→终止)                    template-render
                                                     │    ▲
                                              fact-discipline │
                                                     │    │ (纠正场景回边)
                                              privacy-gate ─┘
                                                     │ preview_confirmed
        ┌──────────────┬──────────────┬──────────────┼──────────────┐
        ▼              ▼              ▼              ▼              ▼
  dingtalk-send  feishu-send  tencent-docs-  wecom-doc-   wecom-msg-send
                              create         create
        └──────────────┴──────────────┴──────┬───────┴──────────────┘
                                             ▼
                                       state-writer (写 processed.json, Step6)

• 三类节点：source（取料）→ processor（加工）→ sink（推送/写状态）
• 共享上下文：config.json（静态配置）+ processed.json（去重状态）
• 唯一回边：privacy-gate 的场景纠正回到 template-render

工作流编排

执行方式：按 references/workflow.json 的 DAG 拓扑序逐节点执行；Step 0~6 为阶段别名（对话中仍说"Step 4 隐私闸门"）。每个节点的完整命令、参数、失败处理见 references/workflow-engine.md。

节点简表

关键规则（节点执行时遵守）

• 缺依赖或缺认证不往下走：任一节点 needs 未就绪，先给「新手引导」授权引导，连好后复检。
• 只抽取不臆造：template-render 失败/原料为空即停止说明错误；fact-discipline 强制标 [来源] + 置信度 ✅/⚠️/❓，缺失留 [待填写]。
• 隐私闸门是硬规则：privacy_gate_required=true 的 sink（dingtalk/feishu/wecom-msg）发群前必须本人预览确认；false 的（tencent-docs/wecom-doc 建文档）免闸门。
• 查询优化：tmeet 默认 --compact 降上下文；展示用 meeting_code 不暴露 meeting_id；多结果候选必用户确认。
• 文件沉淀（可选）：你明确说"存一下"才沉淀到 output/{source_id}_{date}_{scene}/，默认只在对话输出，不主动持久化。

扩展指南

新增源/推送平台/加工器，只需在 workflow.json 加一个节点 + 若干连线 + 自检清单加一行，无需改 SKILL.md 散文。详细三步法见 references/workflow-engine.md 第 5 节。

无权限处理（腾讯会议录制权限申请）

源 A 的 smart-minutes 返回无权限时：

1. permission-apply-prepare --meeting-record-id "" 拉预览
2. 完整展示并询问是否同意申请
3. 确认后 permission-apply-commit 展示 approval_url
4. 未确认/取消 → 终止

错误处理与回退

任何步骤失败都不静默跳过、不编造纪要。错误提示统一为定位 → 原因 → 方案三步：

断点续跑（checkpoint）

复杂流程（多平台推送 / 长会议分段）中途出错，不需要从头再来：

• 每个节点成功后写入 checkpoint.json（{step, node_id, timestamp}），失败后从最近断点接着跑
• 说"进度"查看断点；说"从 Step X 重来"回退到指定节点

checkpoint vs processed.json：后者是最终去重记录（推送成功才写）；前者是中间断点（每节点成功都写），用于失败恢复。

常见错误

• Step 1 取料失败：接口超时（网络波动）→ 自动重试 1 次仍失败 → 检查网络后说"重试"，或换会议；权限/未登录不重试，引导 tmeet auth login
• Step 3 加工失败：原料为空或解析异常 → 停止说明哪个输入源出问题，确认后重试
• 腾讯会议无权限：走「无权限处理」流程申请
• 飞书 / 钉钉无权限：飞书 missing_scope → 回「飞书授权固定流程」补 scope；钉钉失败 → dws auth login；未解决前不推送
• Step 5 推送失败：网络超时 → 自动重试 1 次仍失败 → 保留全文，改发本人或换平台，恢复后重推（成功再写 processed.json）

自动重试规则：网络超时/瞬断类错误，LLM 静默重试 1 次；权限/配置错误不重试，直接引导修复。

错误速查表

输出示例（脱敏）

# 产品周会 · 周会纪要
📅 2026-07-13 10:00 · 👥 产品组

## 本周完成
- 支付链路重构 v1 灰度，错误率降至 0.3%

## 下周计划
- v2 全量上线（目标 7/20）

## 阻塞/风险
- 风控接口文档未对齐（待补充）

## 行动项
| 任务 | 负责人 | 截止 | 优先级 |
| 补齐风控接口文档 | 待定 | 2026-07-17 | 高 |

📎 来源：rec_20260713_abc123

📎 来源 即去重主键 source_id（腾讯会议=record_file_id，IMA=media_id）。

完整操作示例（边界情况处理）

示例 1：tmeet 未登录 + 无录制 → 手动粘贴回退

用户：帮我整理一下今天的产品周会
Agent：[Step 0] 检查 tmeet 登录态 → 未登录
Agent：[降级模式] 提示用户：tmeet 未登录，先执行 `tmeet auth login`；或直接粘贴智能纪要走手动模式
用户：我直接贴转写吧
Agent：[Manual Mode] 粘贴转写 → 识别为「周会」场景 → 套 weekly-sync 模板 → 预览确认 → 推送

→ 不卡死：tmeet 不可用给手动粘贴回退。

示例 2：飞书推送报 missing_scope → 补授权

用户：把这场复盘发飞书
Agent：[Step 5] `lark-cli im +messages-send --chat-id "oc_xxx" --markdown "..." --as user`
Agent：→ 返回错误 `missing_scope: im:message.send_as_user`
Agent：提示用户缺 scope，引导补齐：`lark-cli auth login --scope "im:message.send_as_user"` → 生成二维码 → 用户扫码授权 → 重跑推送

→ 飞书须 --as user + 对应 scope。

示例 3：超 3 个月窗口 → 用 meeting_code 单独查询

用户：帮我整理 3 月 15 日那场面试
Agent：[Step 1] `tmeet record list` 仅回溯近 3 个月 → 超出窗口
Agent：提示用户提供 `meeting_code`，用 `meeting get` 单独查询
用户：会议号是 ABC-DEF-GHI
Agent：`tmeet meeting get --meeting-code "ABC-DEF-GHI"` → 录制 → 模板 → 预览 → 推送

→ 超窗口需 meeting_code。

示例 4：多平台推送，飞书失败 → 断点续跑

用户：把这场复盘发钉钉和飞书
Agent：[Step 5] 推送钉钉 → 成功，写 checkpoint.json
Agent：[Step 5] 推送飞书 → missing_scope 失败
Agent：提示：钉钉已成功，飞书缺 scope。补授权后说"继续"，从飞书接着跑
用户：lark-cli auth login --scope "im:message.send_as_user"（补授权）
用户：继续
Agent：[Step 5] 读 checkpoint.json → 从 feishu-send 接着跑 → 推送成功

→ 断点续跑：中途出错不需要从头再来，从最近成功的节点接着干。

去重记录格式

processed.json 每条含 source/source_id/scene/title/pushed_to/pushed_at。source_id 为去重主键（腾讯会议=record_file_id，IMA=media_id），同条不重推。

不触发场景（交给其他 Skill）

• 腾讯会议管理/预约/取消 → tmeet
• 钉钉文档/审批/考勤 → dingtalk-unified/dws
• 飞书文档/审批/日历 → lark-im/lark-cli
• IMA 问答/检索 → ima-skills
• 腾讯文档编辑/修改/删除 → tencent-docs
• 企业微信会议预约/取消、通讯录/表格/待办、文档编辑 → wecom-unified

依赖安装指引

本 Skill 为纯编排器，依赖以下已发布的 CLI / 连接器（需使用者自行安装登录）：

• tmeet（腾讯会议）：随 WorkBuddy 客户端附带，或于腾讯会议开放平台获取。安装后 tmeet auth login 完成 OAuth。
• dws（钉钉）：随 WorkBuddy 客户端附带，或于钉钉开放平台获取。安装后确保 dws auth status 已认证。
• lark-cli（飞书）：随 WorkBuddy 客户端附带，或于飞书开放平台获取。安装后 lark-cli auth login + lark-cli auth login --scope "im:message.send_as_user"。
• tencent-docs（腾讯文档）：在 WorkBuddy 连接器市场启用 tencent-docs 并登录。
• ima-mcp（IMA 知识库）：在 WorkBuddy 连接器市场启用 ima-mcp 并登录。
• wecom-cli（企业微信）：npm install -g @wecom/cli@0.1.9，装后 wecom-cli init --noninteractive 授权；仅用 doc/msg 域读写纪要文档与群消息。

若 command -v 检测不到，先按上述排查安装；不要硬跑后续步骤。

反模式与 FAQ

反模式（不要做）

常见问题（按场景速查）

遇到问题先查这里：不确定哪错了先看「快速诊断」；边界情况先看「边界情况速查」。

快速诊断

• 没反应/没动静？ → 先查依赖自检清单，看哪个工具没装好/没登录。
• 推送失败了？ → 看错误处理章节的"定位+原因+方案"，或查错误速查表。
• 节点卡住了？ → 看对话里的阶段别名（Step 1 取料 / Step 3 加工 / Step 4 / Step 5），定位到 workflow.json 节点图。
• 不确定做到哪了？ → 说"进度"，查看 checkpoint.json 当前断点。
• 想重来某一步？ → 说"从 Step X 重来"，回退到指定节点接着跑。

边界情况速查

• 会议跨天怎么算？ → 按会议开始时间归属到当天，去重按 source_id 不按日期。
• 能同时推多个平台吗？ → 每轮选一个平台；多平台需分轮推送（断点续跑支持中途失败后接着推下一个）。
• 纪要太长推不出去？ → 钉钉/飞书单条消息有长度限制，超长自动分段推送，或改用腾讯文档/企业微信文档。
• 群里没人说话怎么取料？ → 企业微信源需会议结束后 AI 纪要文档已生成；群里无消息时改用 doc get_doc_content 读文档。
• 历史会议能补发吗？ → 腾讯会议仅回溯近 3 个月，超出需提供 meeting_code 单独查；IMA/企业微信按 source_id 去重，已推送的不会重复发。

取料与识别

• 会议超 3 个月找不到？ → tmeet record list 仅回溯近 3 个月，超出需你提供 meeting_code 用 meeting get 单独查。
• 多场会议怎么选？ → 多结果一律列出让你确认，AI 不自行猜测。
• 智能纪要和转写不一致？ → 优先智能纪要，转写作补充；冲突处标 ⚠️ 交你判断。
• IMA 知识库 ID 怎么填？ → 首次用到时问你，写入 config.json 缓存，后续复用。
• 会议号在哪看？ → 展示用 meeting_code（会议号），绝不暴露 meeting_id。

加工与输出

• 只要待办 / 简版？ → 说「简版」「只要待办」即切精简模式，仅出基本信息 + 决策 + 待办。
• 场景选错了怎么换？ → Step 4 预览时直接说"这是复盘不是周会"，回到 Step 3 换模板重加工。
• 转写里"说话人01"匿名？ → 需你协助指认，指认前不猜测责任人。
• 超长转写爆 token？ → python scripts/split_transcript.py --max-chars 4000 --overlap-chars 200 分段摘要。
• 纪要能存本地文件吗？ → 你明确要求"存一下"才沉淀到状态目录 output/，默认只在对话输出。

推送与去重

• 同一场会重复推送？ → processed.json 按 source_id 去重，已处理标灰提示。
• 推送失败怎么办？ → 先重试一次；仍失败保留全文，建议改发本人或换平台。
• 推钉钉 / 飞书要本人确认吗？ → 含敏感内容必须先发本人预览确认，绝不直推群。
• 钉钉群 ID 搜不到？ → 完整群名常搜空，用短片段关键词（"AI""协作"）命中再精确匹配；参数含 / 与 == 加引号。
• 飞书群 chat_id 怎么找？ → lark-cli im +chat-search --query "<群名>" 取 oc_xxx。

授权与连接

• smart-minutes 无权限？ → permission-apply-prepare 预览 → 你确认 → permission-apply-commit 拿 approval_url。
• 飞书报 missing_scope？ → lark-cli auth login --scope "im:message.send_as_user" 补 scope（仅登录不够）。
• 定时任务能"会议一结束就触发"？ → 仅支持周期轮询，不支持事件触发。
• 状态目录能手动建？ → 不能，用 python scripts/init_state.py 自动建，避免编码问题。
• CLI 检测不到？ → command -v 为空先按「依赖安装指引」装好再跑。

腾讯文档

• 要先授权吗？ → 首次在 WorkBuddy 连接器面板启用 tencent-docs 并完成 OAuth 登录。
• 找不到腾讯文档连接器？ → 设置 → 连接器 → 搜索「腾讯文档」→ 启用。
• 推送后文档在哪？ → 创建在你自己的账号下，成功后返回链接，浏览器直接编辑。
• 能指定保存到某文件夹？ → create_smartcanvas_by_mdx 不支持 parent_id，需指定目录改用 manage.create_file。
• 推送后还能改吗？ → 腾讯文档可在浏览器任意编辑 / 分享；钉钉 / 飞书需重新生成再推。

企业微信

• 能直接拉企业微信会议的转写吗？ → 多数企业未授权机器人会议权限（wecom-cli meeting 报"暂不支持"），改读会议生成的 AI 纪要文档（doc get_doc_content）或群里的纪要消息（msg get_message）。
• 纪要文档链接怎么用？ → 直接把 doc.weixin.qq.com/XXXX 链接或 docid 传给 doc get_doc_content 读 Markdown。
• 怎么回推企业微信？ → doc create_doc 建文档（你账号下可编辑），或 msg send_message 发群/个人（发群须先本人预览）。
• 企业微信 CLI 检测不到？ → npm install -g @wecom/cli@0.1.9 后 wecom-cli init --noninteractive 授权。

工作流节点

• 节点执行到哪了？ → 看对话里的阶段别名（Step 1 取料 / Step 3 加工 / Step 4 / Step 5），对应 references/workflow.json 节点图。
• 节点执行失败怎么办？ → 看错误处理章节"定位+原因+方案"，或查错误速查表。
• 想跳过某个节点可以吗？ → 分段（split-chunks）可跳过（转写 <6000 字符自动直通）；隐私闸门不可跳过（安全规则）。
• 自动重试是怎么工作的？ → 网络超时/瞬断类错误，LLM 静默重试 1 次；权限/配置错误不重试，直接引导修复。

已知坑位（实测）

1. tmeet record list 已含 record_file_id，无需再走 record address
2. dws chat search 整名搜不到群，改用短片段关键词
3. 钉钉本人 ID 从 dws auth status 顶层动态取
4. openConversationId 含 / 与 ==，参数须加引号
5. IMA fetch_media_content 返回转写全文，传 media_id 即可
6. lark-cli 发消息在 im 域，须显式 --as user
7. 超长转写必用 split_transcript.py --max-chars 4000 --overlap-chars 200
8. 临时目录用 tempfile.mkdtemp()，不写死 /tmp
9. create_smartcanvas_by_mdx 不支持 parent_id，需用 manage.create_file
10. tencent-docs 与 ima-mcp 同理：连接器面板启用→登录
11. tencent-docs 不需隐私闸门（文档在你账号下）
12. tencent-docs 无默认群概念，不缓存 ID
13. MDX 兼容 Markdown，直接传 mdx 参数
14. 企业微信 meeting 域需企业授权，多数未开通；取料只走 doc/msg 域
15. wecom-cli doc get_doc_content 传 type:2 返回 Markdown，可直接进模板加工