会议纪要 + 工作简报一体化助手
把散落的会议文字稿，变成可归档、可检索、可交付的正式文档资产。
核心主张：结论优先、四要素齐全、代号脱敏、人审不跳过。
硬约束（任何时候都不能破）
- 客户代号脱敏：对外文档一律用代号（C001 形式）。未登记代号的客户禁止出稿，先登记。
- 人审门不可跳过：每份文档生成后必须输出「待确认清单」，等用户确认后才进入下一步。
绝不自动发邮件、自动发群、自动外发。 - 禁止臆造：原始稿没有的责任人、日期、数字、结论，一律不补写，标「待确认」进人审清单。
- 待办四要素：内容 + 责任人 + 截止日期 + 责任方，缺一项即标「待确认」。
- 原始稿只读：
01_原始稿/下文件永不修改，整理基于副本。
详见 references/delivery_standards.md（长文档，按需读取）。
环境
需要 Python 3.10+ 与依赖 python-docx（≥1.1）、openpyxl（≥3.1）。首次运行先自检：
"$PY" -c "import docx, openpyxl" || "$PY" -m pip install python-docx openpyxl
路径约定（每次会话按实际环境推导，不要写死）：
- $PY = 本机可用的 Python 解释器（python / python3；WorkBuddy 托管环境用其托管版本）
- $S = 本技能目录下的 scripts/（以 SKILL.md 所在位置推导）
- 纪要库根目录可用环境变量 MMH_ROOT 覆盖，默认由 assets/default_root.txt 记忆
Windows 下如遇输出乱码，在命令前加 PYTHONIOENCODING=utf-8。
首次使用
"$PY" "$S/init_store.py" --root "<你的纪要库目录>"
"$PY" "$S/client_registry.py" add "客户全称" --alias "简称" --industry 行业
--root 会持久化到 assets/default_root.txt；后续所有脚本自动定位该库。
客户代号字典存在 _config/clients.json，与 db 一并备份。
工作流路由
按用户意图选一条执行，不要混。
| # | 意图 / 触发词 | 流程 |
|---|---|---|
| A | 整理纪要 / 写会议纪要 / 按纪要模板整理 | 见「A. 单场纪要」 |
| B | 上次和甲方 X 聊了啥 / 甲方最近有什么问题 / X 客户做了哪些工作 | 见「B. 问询检索」 |
| C | 出 5 项优先级清单 | query_store.py priorities --n 5 |
| D | 3 桶 / 我方承诺未交付 / Y 时段交付了什么 | query_store.py buckets |
| E | 出 X 月简报 / 给甲方 X 写月度简报 / 月底整理一下 | 见「E. 月度简报」 |
| F | 周报 / 月报 / 周例会 / 月度例会 | 见「F. 周际联动」 |
| G | 登记客户代号 / 新建客户 | client_registry.py add |
| H | 归档纪要（只有文字稿要入库） | ingest_minutes.py --text |
A. 单场纪要（最高频）
- 输入：读取文字稿（
.docx/.txt/.md）；录音告知用户先用asr-transcribe转写。 - 判定类型：对照
references/meeting_types.md定为 8 类之一；是例会再标recurring。 - 结构化：按类型骨架抽出 topics / decisions / risks / todos / commitments / next_meeting。
套用骨架与噪声处理规则，先把该表读进来。 - 脱敏：客户名 → 代号；未登记则先
client_registry.py add（可--auto-register）。 - 入库：
"$PY" "$S/ingest_minutes.py" --json '<结构化JSON>' - 出稿：
"$PY" "$S/gen_minutes_docx.py" --meeting-id <返回的id> - 人审门 G2：输出「待确认清单」，等用户确认。默认生成的是脱敏版；内部版加
--client-name。
B. 问询检索
"$PY" "$S/query_store.py" search "关键词" --client C001 # 跨会议检索
"$PY" "$S/query_store.py" timeline --client C001 # 客户时间线
"$PY" "$S/query_store.py" meeting --id 3 # 单场全文
"$PY" "$S/query_store.py" stats # 库统计
「上次和甲方 X 聊了啥」→ 先 resolve 出代号，再 timeline 取最近 2–3 场，
用自然语言总结：聊了什么、定了什么、欠了什么、下次何时。回答要带纪要编号，便于追溯。
C. 5 项优先级清单
"$PY" "$S/query_store.py" priorities --n 5 [--client C001]
输出含逾期天数与责任人。用表格呈现，末尾补一句「第 1 项建议今日处理，因为…」。
打分逻辑见 references/schema.md。
D. 3 桶交付清单
"$PY" "$S/query_store.py" buckets --client C001 --from 2026-09-01 --to 2026-09-30
三桶：已交付 / 我方承诺·未交付 / 待甲方第三方。
「我方承诺未交付」是欠账，回答时要点名最久未交付的 1–2 项并给出补救建议。
E. 月度简报
"$PY" "$S/gen_brief_docx.py" --month 2026-09 --client C001 --data-only # 先看聚合数据
"$PY" "$S/gen_brief_docx.py" --month 2026-09 --client C001 --sender "XX项目组"
先跑 --data-only 核对场次与三桶计数，确认无误再出稿。
输出为信函式（致/自/事由 → 六章正文 → 此致敬礼 → 附件清单）。
「月底整理一下」不指定客户时，先输出全量 --data-only 让用户确认范围，再逐客户出稿。
人审门 G3：外发前必须提示用户经项目负责人审核称谓与数字。
F. 周际联动（周例会 / 月度例会）
三步走，prepare 之后必须让用户逐项确认五态，不允许自动捏造进展：
1) "$PY" "$S/weekly_rollover.py" prepare --week 2026-W38 --client C001
→ 输出上期开放项 + 建议状态，把清单给用户逐项确认
2) "$PY" "$S/weekly_rollover.py" apply --week 2026-W38 \
--status '{"12":"已完成","13":"进行中"}' \
--progress '{"13":"已完成初稿，待评审"}'
→ 写回五态；开放项自动承接为本周待办（已延期项顺延至本周日）
3) "$PY" "$S/weekly_rollover.py" deliver --week 2026-W38 --client C001
→ 一次产出：博维附件10 格式纪要 docx + 本周追踪事项 xlsx
月度例会用 --monthly，周期格式改为 2026-09。
用户实在没空逐项确认时用 auto（全部默认「进行中」承接），但必须在人审清单里
逐条列出「未反馈，默认承接」的事项。
xlsx 特性：冻结首行、自动筛选、状态/优先级/责任方下拉、完成行整行浅绿、
风险行浅橙、逾期日期红字加粗、独立「汇总」页（五态分布 + 责任方分布）。
G. 客户代号
"$PY" "$S/client_registry.py" add "全称" --alias "简称,别名" --industry 行业
"$PY" "$S/client_registry.py" list
"$PY" "$S/client_registry.py" resolve "天威"
"$PY" "$S/client_registry.py" redact --in 原文.txt --out 脱敏.txt
脚本速查
| 脚本 | 作用 |
|---|---|
init_store.py |
初始化/查看纪要库（--root 设默认目录） |
client_registry.py |
客户代号登记、解析、文本脱敏 |
ingest_minutes.py |
结构化 JSON / 原始稿入库（自动脱敏） |
query_store.py |
search / priorities / buckets / todos / overdue / timeline / meeting / stats |
gen_minutes_docx.py |
博维附件10 格式正式纪要 docx |
gen_brief_docx.py |
信函式月度工作简报 docx |
gen_tracker_xlsx.py |
本周追踪事项 xlsx（筛选/下拉/浅绿） |
weekly_rollover.py |
周际联动：prepare / apply / auto / deliver |
docx_util.py |
公文排版工具（字体、表格、签发栏、页脚页码） |
mmh_core.py |
共享核心：路径、建表、代号、脱敏、检索、周期 |
所有脚本输出统一 JSON（{"ok":true/false, ...}），解析失败时先看 error 与 hint 字段。
日程集成（可选）
自动填纪要表头的三层降级路线：企微 CalDAV → gcal MCP → ICS 离线 → 手工问 5 项。
只在用户提到日程/日历/下次会议时才走这条路，实现细节读 references/calendar_integration.md。
读取日程可自动执行；创建或修改日程必须先展示条目并等待用户确认。
参考文档（按需读取，不要一次全读）
| 文件 | 何时读 |
|---|---|
references/meeting_types.md |
整理纪要前，判定类型与骨架 |
references/delivery_standards.md |
出稿与外发前，核对脱敏/人审/措辞 |
references/calendar_integration.md |
需要同步日程时 |
references/schema.md |
写自定义 SQL、备份迁移、调优先级打分 |
assets/附件10_模板说明.md |
需要替换真实模板或调字体时 |
输出风格
- 结论先行，用表格；纪要编号（MMH-YYYY-NNN）必须带上，便于追溯。
- 每份交付物末尾固定输出「【待确认清单】」，不允许为空。
- 蓝白配色
#1565C0用于 xlsx 表头与汇总强调色。
