Ray-MM — 会议纪要生成

Overview

任意格式会议材料 →（输入适配层）→ 统一转写文本 →（docx-js 从零生成）→ 标准 Word 会议纪要（.docx）。

v2.0.0 两大能力：
1. 输入扩大化：不再只吃 Markdown——PDF / Word / Excel / PPT / 图片（OCR）/ 录音 / 录像均可，统一转成 .transcript.md 后再生成纪要
2. 格式固化：样式规范内置（references/format-spec.md），生成脚本模板内置（references/gen-template.js）——默认不再需要搜索/解包模板 DOCX；模板仅作可选微调

v2.2.0 内容提炼压缩强化（吸收 meeting-minutes-ai）：
- 待办事项具体性规则：每条待办须是具体任务（做什么+达到效果+责任/时限），模糊表述降级为可执行动作
- 风险与阻塞项：OPEN 小节扩展——不只是遗留问题，还收录会阻断进度的风险/阻塞及对策

v2.3.0 信息分类修正（根据实战反馈）：信息分类（决策/待办/未决/数据）仅作为内部分析工具，正文与表格不出现 [决策]/[待办]/[数据]/[未决] 内联标签，待核实项集中列于 APPENDIX（2026-09-04 用户实测：正文内联标签干扰阅读效率）。

触发条件

以下任一关键词出现时使用此 skill：
- 会议纪要 / meeting minutes / 生成纪要 / 会议记录转 word
- 安全月会 / 环保例会 / 事故剖析会 等化工会议纪要
- 用户提供任意格式会议材料（文档/图片/录音/录像），要求转成纪要

开场参数确认（动手前必做）

收到会议材料后，先确认以下参数再生成（缺省用默认值，不反复追问）：

忠实引用纪律（最高优先级）

> 背景：外部会议纪要 skill 的核心纪律——忠实引用、不补充、引用标记。AI 生成会议纪要最大的风险是编造讨论内容。

• 忠实引用：纪要内容必须能在源材料中找到出处——"谁说的/决定了什么/下一步做什么"
• 不补充：材料没有的内容一律不写。禁止"合理推断"出结论、禁止润色成"会议决定"（除非原文明确说了）
• 引用标记：不确定是否忠实的内容打 [待核实] 标记，交付时提醒用户核对
• 豁免：仅格式性内容（日期补当天、姓名补职位全称）可补，且必须在交付说明中列明补了什么

工作流程

Step 0: 输入适配（多格式 → 统一转写文本）

# 文档/图片类（单文件或整个目录）
python scripts/input-extract.py <文件或目录> [--ocr] [--out <输出目录>]

# 音视频类
python scripts/transcribe_audio.py <音频/视频文件> [--model small|medium|large-v3] [--out <输出目录>]

统一产出的转写文本就是 Step 2 的标准输入——后续步骤与输入来源无关。

Step 1: 读取格式规范（内置，无需模板）

# 默认：直接读固化格式规范（页面/表头/字体/编号/待办表全在此）
Read: references/format-spec.md

# 生成脚本模板（复制为 gen_minutes.js，只需填内容区）
Copy: references/gen-template.js → <工作目录>/gen_minutes.js

仅当用户明确提供模板 DOCX 并希望参照其风格时，才解包模板提取配色/字体微调（format-spec.md 中覆盖默认值），正常情况下跳过。

Step 1.5: 转录文本校对（ASR 输入时必做，v2.1.0 新增）

> 背景：whisper/腾讯会议等语音转文字产出，错别字 95% 是中文同音字替换——不校对直接进纪要 = 把错误固化进正式文档（化工场景：数字、物料名、人名错了后果严重）。

触发条件（满足任一即自动执行）：
- 转写文本含时间戳（== 00:00:00 ==）或说话人标注（发言人1： / 张三： / Speaker 1:）
- 来源是录音/录像转写（Step 0 音视频链路）
- 用户说"先校一下 / 转写有错字 / 同音字纠正"

纠错三档纪律（不可豁免）：
| 置信度 | 处置 |
|--------|------|
| 高置信（上下文+专业常识可确定，如"已正响"→"已整改"） | 直接改 |
| 中置信（同音可疑但无法确定） | 不静默改，标 [待核实：原词→疑似xx] |
| 数字、金额、比例、日期、人名、物料名 | 一律只标不改，回听/查原始材料人工定 |

• 优先级：化工专名（物料/CAS/装置）＞ 人名职务 ＞ 通用同音/形似
• 专名词库（v2.4.0）：化工会议高频同音词见 references/asr-glossary.md（爆破片/尾气系统/液位/自力式调压阀等实测正词）——是提示库不是替换库，命中先判上下文置信度再走三档纪律；人名/企业名只标不改
• 留痕可溯：只纠错别字不改原意；每处程序化纠错在交付说明中列出（原词→正词）
• 红线：拿不准就标，不替音频做主——严格咬合忠实引用纪律（纠错≠脑补）

两处以上同音字错误可引导用户回听音频人工核实。

Step 2: 解析会议内容（从统一转写文本）

> 音视频转写稿通常无结构标记——由 AI 依据内容主题归纳议题（仍须忠实引用，可打 [待核实]）

Step 3: 安装 docx-js 依赖

mkdir -p <temp_workdir> && cd <temp_workdir>
npm init -y && npm install docx

使用系统 npm（which npm 获取路径）。安装到临时目录，任务结束后清理。

Step 4: 填写生成脚本

打开复制的 gen_minutes.js，只需修改三处：
1. OUTPUT 路径
2. HEADER_TEXT（页眉/标题，一般=<会议主题>会议纪要）
3. topics / actions 两个内容数组（忠实引用纪律下从转写文本提取）

样式（编号配置/辅助函数/表格构建/页面设置）全部内置，不要改动。也不编辑任何模板 XML。

Step 5: 验证和输出

# 运行脚本
NODE_PATH=<node_modules_path> node gen_minutes.js

# 验证生成的 DOCX（段落/表格数、无 U+FFFD 乱码、关键内容存在）
python scripts/validate.py <output.docx> --need "关键词1,关键词2" --rows <待办行数>

# 清理临时文件
rm -rf <temp_dir>

输出文件命名：会议纪要-<主题简称>-<MMDD>-<YYYY>.docx，放在源材料同级目录（或用户指定目录）。

固化格式速查

详细规范见 references/format-spec.md；要点：
- 页面：US Letter 12240×15840，页边距上下 1440 / 左右 1800；页眉右"会议标题"（微软雅黑 9pt 灰斜体），页脚居中"第 X 页"
- 表头表格 3 行 4 列：标题跨列（微软雅黑 28pt 加粗居中）/ 时间·地点（Garamond 22pt 标签加粗 + 20pt 值斜体）/ 人员·CC抄送
- 编号：Level 0 1. / Level 1 1.1 / Level 2 a)；议题标题 等线 22pt 加粗 #002060
- 正文：等线 21pt，行距 360；红色 #C00000 斜体用于备注/[待核实]
- 待办表：表头 #002060 白字 18pt，数据行交替 #F2F6FC/白，列宽 1600/5040/2000
- 结构：TOPIC → CONTENT（三级编号，正文不带类型标签）→ OPEN（遗留问题+风险阻塞，有才放）→ ACTION（待办表）→ APPENDIX

常见陷阱

1. 不要编辑模板 XML：会议内容量大、结构多变，直接编辑 XML 极易出错（run 合并、RSID 冲突、编号断裂）。始终用 docx-js 从零生成（模板 references/gen-template.js）。

2. 不要用 python-docx 替代 docx-js：python-docx 对多级编号的支持有限且 API 繁琐。docx-js 的 numbering config 更直观可控。

3. docx-js 隐式依赖：npm 安装 docx 包后，确保运行时 NODE_PATH 指向正确的 node_modules 目录。

4. 中文引号处理：docx-js 的 TextRun 直接支持中文全角引号（""''），无需实体编码。不需要使用 “ 等 XML 实体。

5. 表格宽度：始终使用 WidthType.DXA，不用 PERCENTAGE（Google Docs 不兼容）。columnWidths 之和必须等于 table width。

6. ShadingType.CLEAR：表格底色必须用 ShadingType.CLEAR，不用 SOLID，否则背景变黑。

7. 验证：生成后务必运行 scripts/validate.py，检查段落数量与编码（U+FFFD 零容忍）。

8. 中文路径与 bash：脚本/参数含中文路径时走 Python 或 PowerShell 直调，勿经 bash 中转（cd 可能成功但 mv/cp 失败）。

9. 音视频输入：faster-whisper 首次运行会下载模型（small≈460MB / medium≈1.5GB）；无 GPU 环境用 compute_type="int8"（脚本已默认）。

输入适配依赖速查

维护记录