https://github.com/gkzzhs/lark-dispatch
会后知识智能分发 Agent — 基于飞书 CLI，AI 自动从会议纪要提取决策/待办/知识点，按人分发到飞书任务/知识库/消息。飞书 AI 校园挑战赛 2026 参赛作品。
https://github.com/gkzzhs/lark-dispatch
ai-agent feishu knowledge-management lark-cli meeting-notes openclaw
Last synced: 2 days ago
JSON representation
会后知识智能分发 Agent — 基于飞书 CLI，AI 自动从会议纪要提取决策/待办/知识点，按人分发到飞书任务/知识库/消息。飞书 AI 校园挑战赛 2026 参赛作品。
- Host: GitHub
- URL: https://github.com/gkzzhs/lark-dispatch
- Owner: gkzzhs
- License: mit
- Created: 2026-04-15T03:13:50.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-28T04:08:48.000Z (about 1 month ago)
- Last Synced: 2026-04-28T06:18:52.255Z (about 1 month ago)
- Topics: ai-agent, feishu, knowledge-management, lark-cli, meeting-notes, openclaw
- Size: 46.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
📨 lark-dispatch
基于飞书 CLI 的会后知识智能分发 Agent
会议结束后，AI 从纪要中提取决策、待办、知识点，识别相关人，经用户确认后按人分发——任务建到飞书任务、知识沉淀到文档、通知发到相关人。
---
## 当前验证状态
第三周期已完成真实飞书执行闭环验证：基于真实飞书妙记，lark-dispatch 通过手动触发同一 Skill 流程生成确认草稿，并在用户确认后完成 bot IM 推送、飞书任务创建、知识沉淀文档和分发报告文档生成。
同时，项目已完成 OpenClaw cron 配置与 run history 验证，证明主动触发入口可创建、可运行、可追踪。第四周期已将 OpenClaw 更新到 2026.5.2，并验证 cron isolated session 可读取真实飞书妙记、生成确认草稿；确认后的真实分发仍必须等待用户确认后执行。
证据入口：[最终评审摘要](docs/最终评审摘要.md) / [评审快速入口](docs/评审快速入口.md) / [第三周期证据登记表](docs/第三周期证据登记表.md) / [主动触发 Demo](docs/主动触发Demo.md) / [效果验证报告](docs/效果验证报告.md)
## 😩 它解决什么问题
你一定经历过这种场景——
一场一小时的会，决策讨论了 5 条，待办口头分了 3 个，还冒出几个好想法。会议纪要？飞书 AI 帮你生成了。然后呢？
**然后就没有然后了。**
纪要存在文档里，相关人不知道、不看、不翻。口头分的待办没人建任务，两周后才发现没人做。有价值的技术讨论散落在一次会议里，团队无法复用。
我之前做了 [lark-retro](https://github.com/gkzzhs/lark-retro)，解决了"数据收集 + 报告生成"的问题。但跑了一段时间发现：**报告生成了，然后死在了知识库里，没人看。**
所以我做了 lark-dispatch：**开完会，AI 帮你把决策、待办、知识点分给该知道的人。知识不落地，不散会。**
## 🧭 Before / After
| | Before（手动） | After（lark-dispatch） |
|---|---|---|
| **信息提取** | 人工翻会议纪要，逐条识别 | AI 分类：待办 / 决策 / 知识点 |
| **责任分配** | 口头说"你来做"，无记录 | 用户确认后创建飞书任务，指定负责人 |
| **知识沉淀** | 存文档，没人翻 | 生成知识沉淀文档，保留来源和分类 |
| **通知到人** | 群里 @一下，容易漏 | 用户确认后按信息类型定向通知，失败/跳过可追溯 |
| **总耗时** | 50-75 分钟 | < 3 分钟 |
## ⚡ 核心工作流（6 步）
```
Step 1 定位会议
↓ 用户说"帮我处理今天下午的产品评审会" → 搜索日历 + 妙记
Step 2 AI 提取
↓ 从会议纪要中提取：待办项 / 决策项 / 知识点
Step 3 解析相关人
↓ 识别每条信息的相关干系人 → 调用通讯录匹配 open_id
Step 4 用户确认 ← 关键门控
↓ 展示提取结果，用户可修改/删除/补充，确认后才执行
Step 5 执行分发
↓ 待办 → 创建飞书任务 | 决策 → 发消息通知 | 知识 → 写入知识库
Step 6 生成报告
↓ 输出分发执行报告：成功/失败/跳过，附飞书文档链接
```
**核心设计原则：AI 辅助提取，人类拍板执行。** Step 4 的确认门控确保 AI 提取错误不会导致错误分发。
## 📊 效果验证
**前三场历史样本完成 25 条信息提取；第三周期补齐真实飞书执行闭环；第四周期修复 cron runtime 后，已验证 cron 可自动进入确认草稿阶段。**
| 指标 | 第一场（Mini Camp） | 第二场（OPC 创造营） | 第三场（威海OPC共创） | 累计 |
|------|:------------------:|:------------------:|:------------------:|:----:|
| 会议类型 | 公开直播（多租户） | 公开直播（多租户） | 企业内部（同租户） | — |
| 信息提取总数 | 10 条 | 12 条 | 3 条 | **25 条** |
| 提取准确率 | 100% | 100% | 100% | **100%** |
| 分发成功率 | 100%（4/4） | 100%（5/5） | 核心链路已验证 | 历史样本成功，cron 到确认草稿已验证 |
| 降级跳过 | 6 条（跨租户） | 8 条（跨租户） | self-send 限制 | 14 条跨租户 |
| 流程中断 | 0 次 | 0 次 | 0 次 | **0 次** |
| 效率提升 | 17–25x | 17–25x | 17–25x | — |
三场覆盖了「多租户公开会议降级」和「企业内部同租户精准分配」两类场景；第三周期进一步验证了用户确认后的真实 IM、任务、文档和报告生成能力。
> 完整验证数据见 [效果验证报告 v1.3.1](docs/效果验证报告.md)，第三周期证据见 [第三周期证据登记表](docs/第三周期证据登记表.md)。
## 🏗️ 技术栈
纯 SKILL.md 实现，零代码。依赖飞书 CLI (lark-cli) 的原子能力：
| 能力 | 飞书 CLI 命令 | 用途 |
|------|-------------|------|
| 日历搜索 | `calendar +agenda` | 定位目标会议 |
| 妙记读取 | `minutes search` / `minutes get` | 获取会议纪要内容 |
| 通讯录查询 | `contact +search-user` / `contact +get-user` | 解析相关人 open_id |
| 任务创建 | `task +create` | 创建待办任务并指定负责人 |
| 消息发送 | `im +messages-send` | 定向通知决策相关人 |
| 文档创建 | `docs +create` | 生成分发报告 |
| 知识库写入 | `wiki +node-create` | 沉淀知识点到知识库 |
## 📁 项目结构
```
lark-dispatch/
├── README.md # 本文件
├── LICENSE # MIT License
├── scripts/
│ ├── check-docs-api.sh # 飞书 docs v1/v2 dry-run 参数兼容检查
│ ├── check-docs.sh # 文档、示例与安全口径一致性检查
│ └── smoke-test.sh # 非破坏性环境与能力验收脚本
├── skills/
│ └── lark-dispatch/
│ └── SKILL.md # 核心 Skill 定义（可直接安装使用）
├── docs/
│ ├── 评审快速入口.md # 当前能力、复测命令和边界说明
│ ├── 最终评审摘要.md # 最终能力、证据和边界摘要
│ ├── 场景定义文档.md # 完整场景分析与产品设计
│ ├── 真实实测Runbook.md # 真实飞书最小闭环实测步骤
│ ├── 效果验证报告.md # 真实数据验证结果
│ ├── 主动触发Demo.md # OpenClaw cron 主动触发说明
│ ├── 第三周期冲刺计划.md # 复赛前验证与材料计划
│ └── 用户反馈采集模板.md # 真实用户反馈采集表
└── demo/
├── confirmation-draft.md # Step 4 确认草稿示例
├── dispatch-report.md # 示例分发报告
└── knowledge.md # 示例知识沉淀
```
## 🚀 快速开始
### 前置条件
- [飞书 CLI](https://github.com/larksuite/cli) >= 1.0.13，已验证版本：1.0.17 / 1.0.19 / 1.0.20 / 1.0.27；推荐使用最新稳定版
- 已完成 `lark-cli auth login`（user 身份）
- 所需 Scope：`minutes:minutes.search:read`、`minutes:minutes.basic:read`、`minutes:minutes:readonly`、`minutes:minutes.artifacts:read`、`minutes:minutes.transcript:export`、`contact:user:search`、`task:task:write`、`wiki:node:create`、`docx:document:create`、`docs:document.content:read`、`im:message.send_as_user`
- bot 私聊推送还需要飞书开发者后台开通 `im:message:send_as_bot` 并发布；这是应用身份权限，不以 user `lark-cli auth check` 作为唯一判断，实测以 bot dry-run 或真实发送返回为准
- ⚠️ 本项目依赖飞书官方 CLI Skills，使用前需要先安装官方 Skills：
```bash
npx skills add https://github.com/larksuite/cli -y -g
```
### 安装
将 `skills/lark-dispatch/` 目录复制到你的 Agent 的 skills 目录下即可。
### 本地检查与非破坏性验收
先运行文档与示例一致性检查，避免旧 scope、旧参数或安全门控说明回潮：
```bash
cd lark-dispatch
bash scripts/check-docs.sh
bash scripts/check-docs-api.sh
```
再运行环境能力验收。脚本只执行只读请求和 `--dry-run` 写入预览，不会创建飞书任务、文档、知识库节点或消息。
```bash
bash scripts/smoke-test.sh
```
如果默认样例妙记 token 不在你的权限范围内，可改用自己可访问的 token：
```bash
LARK_DISPATCH_SMOKE_MINUTE_TOKEN="" bash scripts/smoke-test.sh
```
### 真实实测
当前环境通过本地检查与非破坏性验收后，就可以安排真实最小闭环实测。真实实测会创建飞书资源，必须按 [真实实测 Runbook](docs/真实实测Runbook.md) 执行，并分两次确认：
1. 用户确认进入真实实测：允许读取真实妙记、生成确认草稿、做重复分发检查。
2. 用户确认真实执行：只按确认草稿中的条目创建任务、文档、报告或消息。
### 使用
#### 手动触发
对你的 Agent 说：
```
帮我处理一下今天下午的产品评审会
```
Agent 会自动执行 6 步流程，在 Step 4 展示提取结果等你确认。
确认草稿示例见 [demo/confirmation-draft.md](demo/confirmation-draft.md)。真实执行前，Agent 还会搜索同会议标题或妙记 token 的历史分发报告；若发现疑似重复分发，必须再次询问用户是否继续。
#### 主动触发 Demo（OpenClaw cron 定时触发）
本项目支持通过 OpenClaw 定时任务配置主动触发入口。第三周期已验证 cron 配置与 run history 可真实产生；第四周期已验证 cron isolated session 可读取真实飞书妙记并生成确认草稿：
1. 配置 cron 任务，每 30 分钟检查最近结束的会议，并要求确认前不执行分发：
```bash
openclaw cron add \
--name "lark-dispatch 会后会议扫描" \
--every 30m \
--session isolated \
--model deepseek/deepseek-chat \
--thinking medium \
--light-context \
--no-deliver \
--message "检查今天已结束且有妙记的会议，若发现未分发会议，运行 lark-dispatch 工作流：提取待办、决策、知识点，生成确认草稿，不要在用户确认前创建任务或发消息。"
```
2. 已验证该任务可创建、可手动触发、可产生 run history
3. 已验证 cron 可进入真实妙记读取和确认草稿生成；确认后的 IM、任务、文档和报告仍需用户明确确认后执行
### 当前环境验证
2026-04-30 第三周期真实验证：
- `openclaw --version`：OpenClaw 2026.4.26
- `openclaw models status --plain`：`deepseek/deepseek-chat`
- `lark-cli --version`：1.0.23
- 当前 README 主动触发示例已改用 `--model deepseek/deepseek-chat`，与本机当前默认模型保持一致
- 同日使用旧参数 `--model zai/glm-5-turbo` 创建 cron 任务成功，但触发 cron run 时因本机未配置 zai provider API key 失败；该失败已记录在 [第三周期证据登记表](docs/第三周期证据登记表.md)，不计为成功 E2E
2026-05-03 第四周期回归验证：
- `openclaw cron list`：`No cron jobs.`，无残留测试任务
- `vc +notes` 读取真实妙记成功，已生成确认草稿；本次回归停留在确认前，未发送真实 IM、未创建真实任务或文档
- `task`、`docs`、`wiki`、`im` dry-run 均通过，证据位于 `docs/assets/phase4/`
- OpenClaw 已更新到 2026.5.2；cron isolated session 已成功读取真实飞书妙记并生成确认草稿，证据见 `docs/assets/phase4/cron-fix-summary-2026-05-03.md`
- 同日手动触发同一 Skill 流程完成真实飞书闭环：任务、bot IM、知识沉淀文档、分发报告均已创建成功
2026-05-09 非破坏性复测：
- `lark-cli --version`：1.0.27
- `openclaw --version`：OpenClaw 2026.5.2
- `vc +notes` 可读取样例妙记并返回 `ok=true`；当在线 AI 产物缺少 `chapters/todos` 时，流程使用逐字稿 fallback 并在确认草稿中标注来源
- `task`、`docs`、`wiki`、`im`、`drive` 写入类命令均通过 `--dry-run` 验证，未创建真实资源
- `openclaw cron list` 无启用任务；`openclaw cron list --all` 可看到历史 disabled 任务，属于已停用证据记录，不会主动触发
2026-05-10 真实最小闭环实测：
- 输入会议：威海OPC共创，妙记 token `obcn27xt34ox9s245x877j56`
- 执行范围：主闭环只执行 1 条未分配任务、1 份知识沉淀文档、1 份分发报告，按用户确认跳过 IM；随后用户单独确认后补测 1 条 bot IM
- 飞书任务创建成功：https://applink.feishu.cn/client/todo/detail?guid=31540b59-3d1e-4dc0-9373-9429fcddcfd5
- 知识沉淀文档创建成功：https://www.feishu.cn/docx/KbPDd9YryofBZgxHUW0cFBZnnhf
- 分发报告文档创建并更新成功：https://www.feishu.cn/docx/F7Esdur9EoVGGXxPYizcBeAKnbf
- bot IM 补测成功：message_id `om_x100b50c888c774a4c3700aafb8fcaae`，chat_id `oc_1942d821be9157fea4eee1780e85e5b8`
- docs v2 真实创建并 overwrite 更新成功：https://mxevfgxd6ba.feishu.cn/docx/QcCqdXBKSo94SOxctG8cbevGnZf
- 第三方/群聊 bot IM 已实测受阻：目标 `oc_ca2752dd467518a5b5c5bddf77676ef9` 返回 bot 不在会话中，需要先加 bot 入会话或提供 `ou_` open_id
- 已记录本地 registry：`docs/assets/live-runs.jsonl`
- 完整证据见 `docs/assets/live-2026-05-10/summary.md`；最终检查为 `check-docs` 56 ok、`check-docs-api` 4 ok、`smoke-test` 23 ok / 1 warning、`git diff --check` 通过
2026-04-28 在本机完成一次非破坏性验证：
- `lark-cli --version`：1.0.20
- `openclaw --version`：OpenClaw 2026.4.26
- `openclaw cron add` 使用 `--disabled --no-deliver --model zai/glm-5-turbo` 创建临时任务成功，随后删除，`openclaw cron list` 确认无残留任务
- `vc +notes`、`contact +search-user`、`task +create`、`docs +create`、`wiki +node-create`、`im +messages-send` 的 dry-run 验证通过，未创建真实任务、消息或文档
## 🔗 相关项目
- [lark-retro](https://github.com/gkzzhs/lark-retro) — 基于飞书 CLI 的 AI 回顾 & 周报工作流（lark-dispatch 的前身）
- [飞书 CLI](https://github.com/nicepkg/lark-cli) — 飞书命令行工具
## 🏆 参赛信息
本项目为**飞书 AI 校园挑战赛 2026** OpenClaw 赛道参赛作品，课题方向：企业办公知识整合与分发 Agent。
## 📄 License
[MIT](LICENSE)
---
开完会，AI 帮你把该知道的事告诉该知道的人。