Meeting Notes Skill

首次交互强提醒（跨模型兼容，必须执行）：

• 在第一次响应里先输出“环境检查结果”（一段汇总即可），说明内置能力可直接使用：
  • 内置 TTS：macOS say（可直接用）
  • 内置 ASR：macOS Speech（可直接用）
  • 可选增强安装：edge-tts / openai-whisper / ffmpeg
• 若无法确认依赖状态，必须提示用户先执行：bash scripts/doctor.sh --strict
• 在 macOS 下，若缺少 ffmpeg，优先提示一键引导：bash scripts/bootstrap_macos.sh
• 不允许静默失败；失败时必须明确说明“缺少哪个依赖、安装命令是什么、下一步怎么做”。
• 首次使用输出格式强制包含两段：
  • 环境状态：已就绪项 / 缺失项
  • 安装命令：可直接复制执行的命令（按当前系统）

首次使用前先运行环境自检：

• bash scripts/doctor.sh --strict
• 若未通过，必须先完成安装，再执行 ASR/TTS（硬门禁）。
• 在 macOS 下可启用自动安装：执行 ASR/TTS 命令时加 --auto-install（底层调用 scripts/bootstrap_macos.sh）。

1) 输入与转换 (Input & Transformation)

0. 若用户仅表达“要整理会议纪要”但未提供内容，先收集输入来源：
   • 录音文件
   • 已转写文本
   • 会议主题 + 零散要点 收到任一输入后再继续后续步骤。 0.1 若输入为“文本会议纪要/会议文本”，默认同时执行 TTS，自动产出可播放录音文件；无需用户再次明确提出“转语音”。
1. 识别输入类型：实时流式音频、离线音频文件、或已转写文本。
2. 对音频输入先执行 ASR，再执行说话人分离，输出统一的语义片段：
   • timestamp_start
   • timestamp_end
   • speaker_id (如 S1, S2)
   • text_raw
3. 优先保证中英混合识别准确性，保留术语原文，不做主观翻译。
4. 若无法可靠识别发言人，显式标注 speaker_id: Unknown，并在风险提示中说明。

2) 智能重构与降噪 (Intelligence & Processing)

1. 对 text_raw 执行去口语化处理：移除“嗯、啊、那个”等语气词及明显离题寒暄。
2. 按语义议题而非时间顺序重组内容；将同一议题的分散发言聚合。
3. 对每个议题按“双钻结构”重写为：
   • 问题描述
   • 原因分析
   • 解决方案
   • 最终决议
4. 明确区分“已达成共识”和“仍待确认”。不得把猜测写成结论。

3) 结构化输出 (Output & Documentation)

严格使用 references/output-template.md 的版式。

强制规则

1. 拒绝输出大段散文；以结构化小节和 Markdown 表格为主。
2. Action Items 必须是 Markdown 表格，并包含：
   • 任务项
   • 负责人
   • 交付物/截止日期
   • 备注
3. 若某项结论没有明确 Action Item，必须在“风险提示”中单列提醒。
4. 摘要必须直接进入结论，不输出空洞开场句。
5. Action Items 硬门禁：
   • 负责人不得为空/待指定
   • 交付物/截止日期不得为空/待确认
   • 不满足时禁止“完成态”输出，标记为 DRAFT_PENDING 并提示补全。
6. 生成会议思维导图（安全模式）：
   • 从纪要提取“核心决议 / 待办事项 / 风险提示 / 议题脉络”生成导图数据。
   • 仅输出 html/svg/xmind（禁用 png/jpg/pdf 路径）。
   • 执行命令：python3 scripts/generate_meeting_mindmap.py --minutes <minutes-file> --topic <meeting-topic> --formats html,xmind
   • 若脚本失败，必须在回复中显式给出失败原因，并兜底输出 mermaid mindmap 文本，禁止省略导图结果。

4) TTS 播报稿生成 (TTS & Feedback)

1. 不全文朗读；仅提取“核心决议 + 待办事项 + 风险提示”生成 1-3 分钟播报稿。
2. 在播报稿中加入节奏标记（如 [停顿1s]、[加重]、[放慢]）。 2.1 朗读前必须清洗文本：去除 Markdown、URL、表格分隔符、控制标记和特殊符号，避免把符号读出来。 2.2 必须额外生成独立口播稿文件（<prefix>.spoken.txt），TTS 只读取口播稿，不可直接朗读会议文档。 2.3 口播稿结构固定为：开场一句 -> 核心决议（最多3条）-> 待办（最多3条，含负责人和截止）-> 风险（最多2条）-> 收束一句。
3. 按场景切换音色建议：
   • 项目部署/复盘：干练专业
   • 头脑风暴/团队同步：亲和清晰
4. 当用户未指定音色时，默认“干练专业”。
5. 当用户明确要求“生成录音/语音文件”时，除文本播报稿外，还必须提供可直接合成语音的最终朗读文本（去除控制标记版本）。 5.1 当用户仅提供文本纪要（未明确提语音）时，也必须生成语音文件（默认行为）。 5.2 文本输入默认生成两份音频：
   • 重点口播音频：<prefix>.mp3（基于 .spoken.txt）
   • 原文全文音频：<prefix>.full.mp3（基于 .full.txt） 5.3 音频格式强制为 mp3；若只能生成 m4a，必须转码为 mp3 后再交付。 5.4 原文全文音频必须“逐字朗读”：.full.txt 必须与用户输入文本一致，不允许清洗、改写、摘要或重排。
6. 文本转语音输出默认要求：
   • 格式：统一 mp3（若中间产物为 m4a，必须转码后交付）
   • 时长：1-3 分钟
   • 内容：仅“核心决议 + 待办事项 + 风险提示”
   • 命名规范：<会议主题>-<YYYYMMDD-HHMMSS>.<ext>
7. 在 macOS 本地优先使用 scripts/generate_tts_brief.sh 生成语音文件。
8. 跨平台（Linux/macOS/Windows）优先使用 scripts/audio_bridge.py：
   • 默认使用 provider=auto，优先已安装识别引擎（local whisper），再回退云端/系统内置。
   • 默认音色固定：zh-CN-XiaoxiaoNeural，默认风格：warm。
   • 如需回退可显式传参：--provider auto。
   • 不要求用户手动选择 provider/voice；若依赖缺失，直接给出安装提示并说明“安装后将自动恢复默认音色效果”。
   • 免费高质量 TTS 依赖：python3 -m pip install edge-tts
   • 使用 OpenAI 回退时需设置 OPENAI_API_KEY。
   • OpenAI 默认模型可通过环境变量覆盖：
     • OPENAI_ASR_MODEL (默认 gpt-4o-mini-transcribe)
     • OPENAI_TTS_MODEL (默认 gpt-4o-mini-tts)
9. 音色策略（默认统一）：
   • 默认固定：edge + zh-CN-XiaoxiaoNeural + warm
   • 可通过环境变量覆盖：MEETING_TTS_EDGE_VOICE=<voice-name>
   • 输出结果中必须注明“实际使用音色”。
10. 会议纪要文档与音频必须同名同时间戳，仅扩展名不同：

• 文档：<会议主题>-<YYYYMMDD-HHMMSS>.txt
• 音频：<会议主题>-<YYYYMMDD-HHMMSS>.m4a|mp3
• 音频生成后必须做可解码校验；不可播放时自动切换下一 provider 重试，不可直接交付损坏文件。

11. 全模型兜底返回格式（脚本不可用时）：

• 状态: SUCCESS 或 PARTIAL_SUCCESS（必须明确）
• 依赖检查: 已安装 / 缺失列表
• 会议纪要: 按模板完整输出
• 思维导图: 输出 mermaid mindmap 代码块
• 语音结果: 输出“未生成原因 + 安装命令 + 重试命令”

11. 执行命令（推荐）：

• 一键全量产出（推荐）：python3 scripts/generate_meeting_bundle.py --input <minutes-text-file> --topic <meeting-topic>
• 该命令强制校验 6 项产物：txt + spoken.txt + audio.mp3 + audio_full.mp3 + mindmap.html + mindmap.xmind。
• 任一缺失即失败，禁止返回“已完成”。

12. 执行命令（仅语音）：

• bash scripts/generate_tts_brief.sh <brief-text-file> <meeting-topic>
• 该脚本默认委托 audio_bridge.py 的 edge 神经语音链路（不再走本地 Tingting 默认路径）。
• 示例：bash scripts/generate_tts_brief.sh test-output/meeting-brief.txt 产品周会 test-output

13. 执行命令（跨平台）：

• TTS: python3 scripts/audio_bridge.py tts --input <brief-text-file> --topic <meeting-topic>
• ASR: python3 scripts/audio_bridge.py asr --input <audio-file> --topic <meeting-topic> --provider auto --language zh
• 自动安装依赖（macOS）：在上面命令后追加 --auto-install
• 内置 ASR 脚本（macOS）：scripts/builtin_asr.swift
• ASR provider=auto 默认路由：local -> openai -> builtin（优先安装引擎，不默认先走系统内置）。
• 对 m4a/mp3/aac/mp4 压缩音频，内置 ASR 强制先走 ffmpeg 转码为 wav；缺少 ffmpeg 时直接提示安装（brew install ffmpeg）。
• macOS 依赖一键引导：bash scripts/bootstrap_macos.sh（自动检测并安装 ffmpeg）。

14. 跨模型一致性建议（强制统一音色）：

• 固定 Provider：edge
• 固定音色：zh-CN-XiaoxiaoNeural
• 可设置环境变量：export MEETING_TTS_EDGE_VOICE=zh-CN-XiaoxiaoNeural

15. 音频后处理（降低 AI 味）：

• 默认在 audio_bridge.py tts 成功后自动执行后处理。
• 可单独执行：bash scripts/postprocess_audio.sh <input-audio> [output-audio]
• 后处理链：高通 + 低通 + 压缩 + 响度标准化（语音听感更自然）。

16. ASR 低置信度输出：

• 在转写 JSON 中输出 low_confidence_segments，用于人工复核。
• 优先复核这些片段再发布最终纪要。

17. Action Items 校验脚本：

• python3 scripts/validate_action_items.py <minutes.md>
• 校验失败时视为不可发布状态。

18. 思维导图脚本：

• python3 scripts/generate_meeting_mindmap.py --minutes <minutes-file> --topic <meeting-topic> --formats html,xmind
• 使用 ClawHub 导图引擎的安全封装版本（vendor），默认产出 .mindmap.json + .html + .xmind。

5) 质量门禁 (Quality Gate)

输出前逐条检查 references/quality-gate-checklist.md。 若未通过，不要直接提交最终纪要，先补齐缺失字段或标记“待补信息”。

6) 缺失信息处理 (Missing Data Policy)

1. 负责人缺失：填 待指定，并在备注要求会后确认。
2. 截止日期缺失：填 待确认，并在风险提示说明“时效不可追踪”。
3. 决议边界不清：填“待确认结论”，禁止伪造最终决策。