声控纪要官（Voice Meeting Minutes）

> 把会议中零散的"记一下"自动收集成干净的结构化待办清单，附带诊断报告告诉你哪些被过滤了、为什么。

快速上手

三句话搞懂：

1. 在聊天里用触发词开头说任务，Skill 自动提取
2. 散会时喊一声"出纪要"，拿到排好优先级的待办表
3. 被过滤或解析不出来的内容，诊断报告会告诉你发生了什么

最快试一下：

记一下，重构登录页和优化首页，月底前完成，小李负责。
加一条，整理用户反馈以及写周报，今天下班前，小王负责。
记住，采购服务器两台，下周一前，大刘负责，紧急！
出纪要。

粘贴以上四行到对话里，你会得到一份按优先级排序的待办清单 + 诊断报告。

> ⚠️ 先看这个：本 Skill 处理的是文字输入，不是语音识别。用微信/飞书的语音转文字功能转成文字后再粘贴就行了。

常见误区

新手最容易踩的五个坑：

❌ 误区 1：以为"记住"后面随便说什么都行

在聊天里说"记住了没""记住了吗"这些口头禅时，Skill 会把它当作触发。但由于后面没有实际任务内容，结果会被过滤掉——你会在诊断报告里看到"内容过短，疑似误触发"。

> ✅ 正确做法：说"记住了没"之前，先单独说一句带触发词的任务。或者干脆用"记一下""加一条"这类不容易误触的词。

❌ 误区 2：用太简短的子任务名称

记一下，重构登录页和提交，周五前交。

"提交"只有 2 字，不满足子任务最低 3 字的要求，不会自动拆分。

> ✅ 正确做法：确保每个子任务至少 3 字——
> > 记一下，重构登录页和提交日报，周五前交。 ← "提交日报" 3 字，可拆分 >
>
> 另外，「采购服务器和数据库」这种短复合名词也可能不被拆分——因为"数据库"只有 3 字且无动词，Skill 保留了整个任务。
> 想强制拆分的，还是建议用两条独立指令。

❌ 误区 3：用超模糊日期表述

「下下周五」「Q3 结束前」「下周左右」——这些太模糊了，仍然不识别，会被标注为「待确认」。
但现在「月底前」「月初」「月中」「年底前」「季度末」「下月底」都已经支持！

> ✅ 支持的范围：
> - 月底前 / 下月底前 / 月初 / 下月初 / 月中 ✅
> - 年底前 / 年末 / 季度末 ✅
> - 下周一 / 这周五 / 今天 / 明天 / 后天 ✅
> - 7月28号前（绝对日期）✅
> - ~~下下周五~~ → 还是需要改成 8月7号
> - ~~Q3 结束前~~ → 还是需要改成 9月30号前

❌ 误区 4：负责人写团队名或角色

"让前端组做""交给产品"——Skill 会试图把"前端组"当成人名，解析结果可能不准。

> ✅ 正确做法：用具体人名或 @人名——
> - 负责人小张 / 小李负责 / 交给小王
> - @alice / @zhangsan

❌ 误区 5：先打完所有会议记录再想"加个待办"

如果全篇都是讨论、没有触发词，Skill 会提示"未检测到触发词"，然后给你一份触发词列表。

> ✅ 正确做法：会议中实时用触发词标注任务，散会时再输出纪要。而不是事后追记。
> 如果确实有纯讨论文本需要提取任务，可以先手动加触发词再粘贴。

FAQ

Q：和直接手动记笔记有什么区别？
A：手动记笔记你需要自己分辨哪些是任务、哪些是闲聊，然后自己排版。Skill 帮你做了这三件事：自动忽略闲聊、自动分优先级、自动对齐格式。而且每项过滤都有解释，你知道什么被跳过了。

Q：能把语音直接扔进去吗？
A：不能。需要先用微信/飞书/腾讯会议的语音转文字功能转成文字，再粘贴进来。

Q：多人同时说话能不能识别谁是谁？
A：不会区分说话人。建议粘贴前按发言人分段整理，或者在每句话前标注人名（如"小张：记一下，..."）。

Q：生成的待办能自动同步到飞书/企业微信/Notion 吗？
A：目前不支持自动同步。输出的 Markdown 表格可以直接复制粘贴到这些工具里。

Q：会记住我之前的待办吗？下次开会能接着用吗？
A：不会。每次解析独立，不跨会话记忆。需要续接上次会议的，请手动把上次输出合并进新输入。

Q：为什么不支持修改/撤销？比如"把刚才那条改成 XX"？
A：因为这需要 Skill 理解上下文修改意图，目前只做一次性解析。建议在最终输出的待办清单里手动调整。

Q：输出结果里有日期识别错了怎么办？
A：看诊断报告的「字段缺失提醒」区，手动改对应项即可。常见原因是非标准表述（如"下下周五"）或日期表述夹在复杂句子里。

高手技巧

技巧 1：组合触发词，一条指令覆盖完整信息

越完整，越少手动补。理想格式：

记一下，{任务描述}，{截止日期}前，负责人{姓名}，{优先级标记}。

示例：

记一下，大屏数据看板重构，8月15号前，负责人小明，紧急！

一条指令四个字段全拿到，零手动调整。

技巧 2：善用 --verbose 模式排查

当发现解析结果和预期不一致时，加 -v：

echo "记一下，XXX..." | python parse_meeting.py -v

详细诊断报告会告诉你：哪些触发词被检测到了、每个字段是如何解析的、哪条被过滤了及其原因。

技巧 3：用 --input 批量处理会议记录

如果会议已经录完文字，把全文保存为 .txt，一次性分析：

python scripts/parse_meeting.py --input meeting.txt --format markdown --output 待办.md

支持 --format json 输出机器可读格式，方便接入自动化流程。

技巧 4：在聊天里养成"一句一触发"的习惯

会议中每冒出一个待办，立刻口头标记：

"等一下，记一下，这个需求下周三前给方案，小王负责。"
"加一条，数据迁移脚本本周内跑通，大刘搞一下。"

这样散会时散落的零散讨论就自动组织成了清单，不用事后回忆。

技巧 5：混合中英文任务

TODO：refactor payment module，这周内，@alice
记一下，首页加载速度优化，周五前

中英混合基本可用，英文名用 @name 格式识别率最高。

输入方式

触发条件

一句话怎么用？

记一下，UI 改版这周五前交，负责人小张。
TODO：重构登录模块，下周三前完成，小李负责。
加个待办，采购服务器两台，7月30号前。

解析能力一览

识别字段

自动过滤

以下内容不会进入待办池：
- 问候寒暄、无结论讨论、八卦闲聊
- 反问/疑问句（"记住了没""做了吗"）
- 纯应答（"好的""收到""知道了"）
- 过短内容（触发词后不足 4 字）

能力边界

解析限制

行为边界

明确不支持

• 语音直接识别、实时音频流
• 跨会话记忆、自动同步外部工具

诊断反馈

任何输入问题都会输出诊断报告，不会静默失败：

• 📊 统计表：触发了几个、过滤了几个、成功解析几个
• 🔽 过滤明细：每条被过滤的原因
• 📝 字段缺失：哪些任务的日期/负责人缺失
• ❌ 异常记录：解析出错的指令及错误信息
• 💡 建议：全部被过滤时的改进方向

加 --verbose / -v 查看更详细的解析过程。

输出示例

## 📋 会议待办清单 — 2026年7月21日

### 🔴 紧急
| # | 任务 | 截止日期 | 负责人 | 状态 |
|---|------|---------|--------|------|
| 3 | 采购服务器两台 | 07月30日（周四） | ⚠️ 待认领 | ⬜ 待办 |

### 🔵 一般
| # | 任务 | 截止日期 | 负责人 | 状态 |
|---|------|---------|--------|------|
| 1 | UI 改版 | 07月24日（周五） | 小张 | ⬜ 待办 |
| 2 | 重构登录模块 | 07月29日（周三） | 小李 | ⬜ 待办 |

---
共 3 项待办 | 紧急 1 项 | 本周内 1 项 | 未分配 1 项

脚本参考

parse_meeting.py

# stdin 直输
echo "记一下，UI 改版这周五前交，负责人小张。" | python scripts/parse_meeting.py

# 文件输入，输出到文件
python scripts/parse_meeting.py --input meeting.txt --format markdown --output 待办.md

# JSON 输出 + 详细诊断
python scripts/parse_meeting.py --input meeting.txt --format json -v

# 指定会议日期和参与人
python scripts/parse_meeting.py --input meeting.txt --meeting-date "2026-07-21" --participants "小张, 小李, 小王"

HTML 模板

assets/todo_template.html — 可视化待办清单，暗色主题、响应式、支持打印、优先级彩色标记。

注意事项

1. 单条指令单任务：一句触发词只解析一个任务，多个任务请用多条指令
2. 实时标记优于事后追记：会议中直接用触发词标注，效果最好
3. 日期不确定可以不写：缺少日期时标注为「待确认」，不会丢弃任务
4. 诊断报告必看：输出末尾的诊断报告比待办清单本身更有价值