会必果

技能文档

---
name: huibiguo
title: 会必果
category: 办公效率
description: "从腾讯会议纪要/转写提取可追溯待办并跨会议追踪到闭环（含逾期预警、会前验收、跟进会、闭环看板）。当用户提到会议待办、行动项、action items、会后跟进、待办看板、会前准备、会议闭环时使用。任何涉及会议纪要待办提取与执行追踪的工作都应调用。"
---

# 会必果 · 会议行动闭环（huibiguo）

> 会议的价值不在开会本身，而在于决议落地。本技能把「纪要 → 待办 → 追踪 → 验收 → 跟进会」
> 打成一个闭环：每场会的待办自动活到下一场会。

## 上游能力声明

- **上游能力**：腾讯会议 Skill（tmeet-skill）。
- **复用范围**：腾讯会议登录授权、会议/录制/智能纪要/转写查询、参会报告、通讯录解析与建会能力。
- **原创增量**：可追溯行动项提取规范、本地跨会议账本、幂等状态机、DDL 雷达、会前验收包、闭环统计与跟进会编排。
- **边界原则**：不复制上游通用能力；所有腾讯会议云端操作继续通过官方 `tmeet` CLI 完成。

## 新手 30 秒入门

**这个技能是干什么的？** 管腾讯会议纪要里的待办——谁要在什么时间前做什么，自动追踪到闭环。

**什么时候触发？**
- 刚开完一场会，想把待办管起来 → 直接用
- 想看谁的待办快到期/逾期了 → 直接用
- 下次开会前，想知道上次欠了哪些账 → 直接用

**直接复制这些开场白就能开始：**
```
✅ "整理下今天下午项目周会的待办"
✅ "这周谁的待办快到期了？"
✅ "明天又要开项目周会了，帮我准备下"
✅ "拉个会追下那些烂尾的事项"
✅ "看看这个项目的会议闭环率怎么样"
```

**一句话流程：** 开完会 → 说"整理待办" → AI 提取待办请你确认 → 入账本 → 之后随时查到期/逾期 → 开会前生成作战包 → 逾期了拉跟进会 → 看闭环看板。

## 能力边界说明

### ✅ 擅长处理

1. **已结束会议的待办提取**：从智能纪要/转写中识别"谁、做什么、何时前完成"，附原话引用入账本。
2. **跨会议待办追踪**：到期/逾期预警、按负责人/会议/状态多视图看板、闭环率统计。
3. **会前作战包**：上次欠账验收单 + 本次议程建议 + 参会人出勤参考。
4. **逾期项一键跟进会**：自动带入未完成清单与原话，自动邀请责任人。
5. **偏好定制**：提醒天数、看板默认视图、负责人别名映射（见「定制化」）。

### ⚠️ 需要素材才能做

1. **待办提取**：需要会议已开启云录制并生成纪要/转写；无录制时无法提取（会明确告知并引导申请录制权限）。
2. **参会人洞察**：需要会议已结束，可调用 `tmeet report participants`。
3. **跟进会邀请**：需要被邀请人在企业通讯录中可被 `contact search` 命中。
4. **个性化议程**：会前作战包的议程建议需要账本里有同系列会议的历史待办，否则只能给通用模板。

### ❌ 超出范围（附替代方案）

1. **会中实时记录/焦点提醒**：本技能面向「已结束会议」，不提供实时能力 → 会中场景请用腾讯会议原生智能纪要的实时功能。
2. **仅导出原始纪要不做追踪**：→ 直接用 tmeet-skill 本体的 `record smart-minutes`。
3. **团队多成员共享账本**：当前账本为单机本地，不支持多人协作 → 团队场景可把看板 Markdown 导出到共享文档，待办状态由单人维护。
4. **外部任务系统（Jira/飞书任务）同步**：不在范围内 → 看板可导出 `--json`，由用户自行桥接。

> 用户提供「我不需要追踪/只看原始纪要/会议还没结束要实时记录」等明确表态时，不触发本技能。

## 受众说明

| 用户类型 | 如何使用 |
|---------|---------|
| **项目负责人 / 团队 leader** | 主力用户。会后说"整理待办"，会前说"准备作战包"，日常查 DDL 雷达。 |
| **个体贡献者（IC）** | 用负责人视图只看自己的待办闭环率，会议太多时按 `--owner` 过滤。 |
| **项目助理 / PMO** | 定期生成跨会议看板归档（`board.py --out`），作为项目周报的"会议落地"附录。 |
| **会议组织者** | 把本技能作为会议纪律工具——逾期项自动浮出，逼着每场会都"有结果"。 |

非腾讯会议企业版用户：tmeet CLI 依赖企业账号授权，个人版能力受限，会如实告知。

## 能力总览

| 场景 | 一句话说明 | 典型触发 |
|------|-----------|---------|
| 一、会后捕获 | 从智能纪要/转写提取待办，写入本地账本 | "整理下刚才会议的待办" |
| 二、DDL 雷达 | 今日到期 / 已逾期清单一键扫描 | "这周谁的待办快到期了" |
| 三、会前作战包 | 上次待办验收单 + 议程建议 + 参会人洞察 | "明天周会前帮我准备下" |
| 四、跟进会+看板 | 基于未完成待办一键建跟进会；跨会议看板 | "拉个会追下这些烂尾事项" |

## 何时不触发

- 仅需原始会议纪要/转写导出、不做待办追踪 → 直接使用 tmeet-skill 本体。
- 会议尚未结束且用户需要的是会中实时记录 → 本技能面向「已结束会议」。
- 用户明确说"不要记录/不要追踪"。

## 定制化

首次使用时，可让用户告知偏好，由 AI 写入 `~/.huibiguo/preferences.json`：

```bash
# DDL 雷达默认回看天数（默认 3）
python3 scripts/ledger.py config set due_in_days 7

# 看板默认视图：all / status / owner / meeting（默认 all）
python3 scripts/ledger.py config set board_view owner

# 负责人别名映射——纪要里喊"小张"，账本里统一记"张三"
python3 scripts/ledger.py config set owner_aliases '{"小张":"张三","老李":"李四"}'

# 作战包/议程语言（默认 zh，支持 en 双语团队）
python3 scripts/ledger.py config set agenda_language en

python3 scripts/ledger.py config list   # 查看当前全部偏好
```

- `due-in` 不传 `--days` 时自动取 `due_in_days`；`board.py` 不传 `--view` 时自动取 `board_view`。
- 别名映射在提取待办时由 AI 应用：纪要出现"小张负责…"时，入账 owner 记为"张三"，保证看板聚合不割裂。
- 偏好文件损坏不阻塞主流程，自动回落默认值。

## 前置检查（每次会话首次使用时执行）

按顺序检查，失败则停在对应步骤引导用户：

1. **tmeet CLI**：`which tmeet`，缺失则执行 `npm install -g @tencentcloud/tmeet@latest`。
2. **登录态**：`tmeet auth status`。未登录时引导授权——`tmeet auth login` 是阻塞命令，
   必须后台运行 `tmeet auth login 2>&1 &`，从输出提取授权 URL 完整展示给用户，
   请其在浏览器打开完成授权。首次调用 login 或切换过模型时，需将当前 Agent 类型与
   模型名分别写入 `TMEET_AGENT` / `TMEET_MODEL` 环境变量（无需询问用户）。
3. **账本初始化**：`python3 scripts/ledger.py init`（幂等，已存在则跳过）。

若评测环境没有腾讯会议账号或真实录制，运行 `python3 scripts/demo.py`。该离线演示不调用云端，
但会真实执行账本导入、证据校验、幂等去重、完成状态和看板渲染；不得将离线演示冒充真实云端联调。

> 脚本路径：本文件中所有 `scripts/*.py` 均指本技能目录下的相对路径，执行前先 `cd` 到技能根目录。
> 账本位置：`~/.huibiguo/ledger.json`，可用环境变量 `HBG_HOME` 覆盖。
> 所有数据仅存用户本机，不上传任何服务器。

## 场景一：会后捕获（提取待办 → 入账本）

目标：会议结束后 30 秒内，把"谁、在什么时间前、做什么"结构化落账。

```
步骤 1  确定目标会议
  用户未指明会议时：python3 scripts/fetch_minutes.py --recent --days 7
  → 将列表以「会议号 + 主题 + 时间」展示给用户挑选（禁止展示 meeting_id）。
步骤 2  拉取材料
  python3 scripts/fetch_minutes.py --meeting-id <内部ID>
  → 优先取智能纪要；不可用时自动降级转写段落，并在 source 字段如实标注。
步骤 3  AI 提取待办（语义工作由模型完成，脚本只做确定性规整）
  按下节「提取规范」从 minutes_text（或 transcript_excerpt）提取，
  写入临时 JSON 文件（格式见 references/data-schema.md）。
步骤 4  落账前确认
  将提取结果以表格展示给用户核对，确认后执行：
  python3 scripts/ledger.py add --file <临时文件>
  → add 命令幂等，重复导入不会复活已完成/进行中的待办。
步骤 5  回报
  展示新增条数、跳过原因，并提示可用 `python3 scripts/board.py` 查看看板。
```

### 提取规范（Trust 核心：每条待办必须可追溯）

- 四要素：`task`（做什么）、`owner`（谁负责）、`deadline`（截止时间，可无）、`quote`（纪要/转写中的原话）。
- **`quote` 必填**：摘录支撑该待办的原话（≤50 字），禁止编造。用户可据此核对，杜绝"AI 幻觉待办"。
- `owner` 必须是会上明确指派的人；纪要中无人认领的提议（如"大家可以看看"）不提取，
  但可在回报中单独提示用户"存在未认领事项"。
- `deadline` 只取会上明确的时间承诺（"周五前"→ 推算为具体日期并填 ISO 格式）；
  无法确定则留空，**禁止自行脑补 DDL**。
- 颗粒度：一条待办 = 一个可验收动作；过粗（"推进项目"）须拆细，过细（"打开文档"）须合并。

## 场景二：DDL 雷达（到期/逾期预警）

```
python3 scripts/ledger.py due-in --days 3   # 3 天内到期
python3 scripts/ledger.py overdue           # 已逾期未完成
```

- 输出已按紧急度排序；向用户展示时按「🔥 逾期 / ⚠️ 今天到期 / 📅 即将到期」分组。
- 若存在逾期项，主动建议进入场景四（拉跟进会或标记处理）。
- 用户口头汇报"某事做完了"时：`python3 scripts/ledger.py list --owner <姓名>` 找到条目，
  展示确认后执行 `python3 scripts/ledger.py done <id> --note "<完成情况>"`。

## 场景三：会前作战包（会前 5 分钟）

目标：让会议有备而来——先验收上次欠账，再定本次议程。

```
步骤 1  找到关联会议
  python3 scripts/ledger.py list --meeting-code <会议号>  （同系列会）
  或全量：python3 scripts/ledger.py list --status open
步骤 2  生成「待办验收单」
  列出该系列会上次遗留的未完成待办（owner/任务/DDL/已逾期天数），
  建议会议第一项议程即为逐条验收。
步骤 3  （可选）参会人洞察
  若用户需要了解上次出勤：tmeet report participants --meeting-id <内部ID>
  仅展示姓名与参会时长等关键字段，不聚合不排名（tmeet 响应处理规则）。
步骤 4  组装作战包（模板见 references/templates.md）
  = 上次欠账验收单 + 本次议程建议 + 参会人出勤参考。
  议程建议由 AI 基于未完成待办生成，须标注"建议"，由用户定夺。
```

## 场景四：跟进会 + 跨会议看板

### 一键跟进会

```
步骤 1  python3 scripts/ledger.py overdue（或 list --status open）
步骤 2  向用户确认：跟进会主题、时间、需邀请的 owner 名单
        （时间必须为 ISO8601 带时区，如 2026-07-28T14:00:00+08:00；
        结束时间 ≤ 开始时间时必须向用户确认，禁止自行推断）
步骤 3  人员解析：tmeet contact search --keyword <姓名> 获取 openId
        （仅此邀请场景允许使用通讯录；多人同名时列出候选项请用户确认，禁止自行挑选）
步骤 4  创建会议：tmeet meeting create（议程正文自动带入未完成待办清单，
        模板见 references/templates.md）
步骤 5  回报严格包含：会议主题 / 会议时间 / 会议号(meeting_code) / 入会链接 / 已邀请成员姓名
        （禁止展示 meeting_id 与 open_id；姓名缺失时用 invitees-list + contact search 补齐）
```

### 跨会议看板

```
python3 scripts/board.py                  # 终端直接阅读（状态/负责人/会议三视图 + 执行闭环小结）
python3 scripts/board.py --out board.md   # 导出 Markdown 归档
python3 scripts/board.py --json           # 机器可读，供其他工具消费
```

- 看板含「会议执行闭环小结」：追踪会议数、待办总数、全局闭环率、逾期未闭环数，
  用于观测会议承诺的执行状态。
- 看板数据全部来自本地账本，可放心贴入内部文档。

## 安全与边界（继承并遵守 tmeet-skill 全部安全规则）

- **写操作二次确认**：`meeting create`、账本批量导入前，必须向用户展示操作详情并获得
  明确肯定（"确认/是/yes"）后才执行。
- **ID 展示纪律**：对外展示一律使用 `meeting_code`（会议号）；`meeting_id` 仅作 CLI 参数内部
  传递；`open_id` 永不展示，成员一律显示姓名。
- **通讯录限场景**：`contact search` 仅用于会议邀请与受邀人姓名解析，多结果必须用户确认。
- **隐私本地优先**：账本、看板均在本机；向 tshoot feedback 反馈问题时须脱敏
  （姓名 张三→张*、会议号 123456789→12****789），且二次确认后才上报。
- **诚实降级**：纪要不可用降级转写时会明确标注 `source`；提取不到待办时如实告知
  "本场会议未识别到明确行动项"，禁止凑数。

## 常见错误处理

| 现象 | 处理 |
|------|------|
| `user config is empty` | 引导 `tmeet auth login`（后台运行，展示授权 URL） |
| 会议无录制文件 | 说明原因，提示可在会后申请录制权限（permission-apply-prepare → 用户确认 → commit） |
| 纪要尚未生成 | 提示"录制处理中，稍后重试"，不得用空材料强行提取 |
| 账本损坏 | 报错并给出账本路径，建议备份后重新 `init`，历史会议可重新捕获 |

## 腾讯生态协同

会必果专注「会议纪要 → 待办闭环」这条链，沉淀与触达交给腾讯自家产品。当用户提出以下诉求时，按路由切换到对应腾讯 skill：

| 用户诉求 | 切换到的腾讯 skill | 会必果提供的数据 |
|---------|------------------|----------------|
| "发到群里/同步给团队/做在线看板" | **腾讯文档**（官方 skill） | `board.py --format smart-sheet` 智能表格结构；作战包 Markdown |
| "存下来/归档/以后能查到" | **ima**（腾讯知识库 skill） | 会议纪要摘要 + 闭环快照 Markdown |
| "提醒下逾期的同事" | **企业微信**（群机器人 webhook / 企微 API） | `ledger.py overdue` 逾期清单 |
| "发封邮件催一下" | **QQ邮箱 / Agently Mail**（官方 skill） | 逾期清单 Markdown |
| "看看参会人在 TAPD 的负载" | TAPD 开放 API（需凭证，可选） | 参会人姓名列表 |

协同原则：会必果产出**已脱敏的结构化数据**（Markdown / 智能表格 JSON），由对应腾讯 skill 消费落地。会必果不重复实现文档编辑/消息发送/邮件能力——这是 skill 编排的正道。详细流程见 `references/tencent-ecosystem.md`。

典型完整闭环（腾讯全家桶）：
```
腾讯会议(tmeet) ──纪要──► 会必果 ──待办──► 腾讯文档(智能表格共享看板)
                                ├──逾期──► 企业微信(群消息@责任人)
                                └──归档──► ima(会议记忆知识库)
```

## 参考文件

- `references/data-schema.md` — 账本 JSON Schema、待办导入文件格式、字段约束。
- `references/templates.md` — 会前作战包模板、跟进会议程模板、看板示例。
- `references/tmeet-commands.md` — 本技能用到的 tmeet 命令子集与关键参数速查。
- `references/tencent-ecosystem.md` — 腾讯文档/ima/企业微信/QQ邮箱/TAPD 协同路由与数据契约。
- `references/anti-patterns.md` — 常见错误用法与改进对比（避免差输出）。
- `references/faq-deep.md` — 深度 FAQ（边缘场景/兼容/合规）。
- `references/demo-walkthrough.md` — 端到端演示：从一场真实会议到闭环看板。
- `references/trace-evidence.md` — TRACE 五维证据、验证命令与待补真实评测项。

## FAQ（通用问题）

**Q1：必须开云录制才能用吗？**
待办提取依赖录制产物（智能纪要/转写）。未开录制时本技能会明确告知，并引导申请录制权限或建议下次开启云录制。不会用空材料强行编造待办。

**Q2：AI 提取的待办会乱编吗？**
不会。每条待办强制回填纪要/转写原话（`quote`），落账前还会展示核对表请你确认。无原话支撑的"提议"只作提示不入账。

**Q3：同一场会重复提取会重复入账吗？**
不会。`meeting_code + 任务 + 负责人`已存在 `open`/`done` 记录会自动跳过；已完成的待办不会被"复活"，仅 `cancelled`（取消后重新指派）允许重新入账。

**Q4：数据存在哪？会上传吗？**
全部在 `~/.huibiguo/`（账本 + 偏好），可用 `HBG_HOME` 环境变量覆盖。除 tmeet CLI 与腾讯会议云端的正常交互外，不向任何第三方发送数据。

**Q5：没有企业通讯录能邀请人入跟进会吗？**
`contact search` 命中不到则无法解析 openId。此时会如实告知，可改为只建会议、入会链接手动转发。

**Q6：能和现有的 Jira/飞书任务打通吗？**
当前不直接同步。看板可 `board.py --json` 导出机器可读数据，由你自行桥接到外部系统。

**Q7：支持哪些 Agent？**
兼容任何支持 Skills 的 Agent。脚本层零第三方依赖，不绑定平台。深度兼容问题见 `references/faq-deep.md`。

使用说明

# 会必果

从腾讯会议纪要中提取可追溯待办，跨会议追踪到闭环，含逾期预警、会前验收、跟进会与闭环看板。

## 使用

会后提取待办：
```
"整理下今天下午项目周会的待办"
```

查看到期/逾期：
```
"这周谁的待办快到期了？"
```

会前准备作战包：
```
"明天又要开项目周会了，帮我准备下"
```

一键拉跟进会：
```
"拉个会追下那些烂尾的事项"
```

## 工作原理

1. 从腾讯会议智能纪要/转写中提取「谁、做什么、何时前」结构化待办，每条附原话引用
2. 写入本地账本（`~/.huibiguo/ledger.json`），支持幂等导入、多视图看板
3. 会前自动生成作战包：上次欠账验收单 + 议程建议 + 参会人出勤
4. 逾期项可一键创建跟进会，自动带入未完成清单并邀请责任人
5. 依赖腾讯会议 tmeet CLI 获取纪要与建会，数据全部存本地

## 前置条件

- 腾讯会议企业版账号（tmeet CLI 授权）
- 会议已开启云录制并生成智能纪要/转写

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。