---
name: meeting-transcript
description: Use when 用户提供讯飞听见、飞书妙记等会议录音转文字内容，需要完成说话人映射、观点/建议/问题/行动计划整理，并同时导出标准 Markdown 纪要与参考 ai-results-html 风格的本地 HTML 展示页。
---

# 学术会议录音文字处理

处理学术研讨、课题组会议、临床讨论等场景的录音转文字内容。

## 核心功能

1. **说话人映射** - 将"说话人1/2/3"映射为真实姓名
2. **个人观点提取** - 总结核心观点、建议、问题
3. **行动计划生成** - 明确责任人、时间节点、优先级
4. **争议与共识分析** - 对比不同说话人的观点
5. **双产物导出** - 先生成结构化 Markdown，再渲染 aging-analysis 风格 HTML

## 预设参与人员

AI会自动匹配以下预设人员：

| 称呼/错误识别 | 真实姓名 | 身份 |
|-------------|---------|------|
| 徐老师 | 徐明 | 资深教授/导师 |
| Ming | 徐明 | 英文名/别名，统一到真实姓名 |
| 黄老师 | 黄河 | 课题组长 |
| 一鸣/逸民 | 赵逸民 | 统计学专家 |
| Angus | Chenyu | 英文名/别名，统一到规范称呼 |
| 小狍 | Kuangyi | 昵称，统一到规范称呼 |
| 陈宇/晨宇 | 范晨宇 | 数据管理员 |

**优先级**：用户提供的映射 > 预设参与人员 > 同音词替换

### 规范名统一规则

- 如果同一人同时出现 **中文名 / 英文名 / 昵称 / 老师称呼**，默认统一到一个规范名字后再继续整理纪要。
- 对当前常见团队映射，默认按以下规范统一：
  - `徐老师`、`Ming` → `徐明`
  - `Angus` → `Chenyu`
  - `小狍` → `Kuangyi`
- 如果用户在当前任务里明确给了新的映射，始终以用户提供的映射覆盖预设规则。

## 处理流程

1. **说话人映射** - 将"说话人N"替换为真实姓名
2. **同音词/别名替换** - 自动修正语音识别错误，并把英文名、昵称、称呼统一到规范名
3. **观点提取** - 为每人提取核心观点、建议、问题
4. **行动汇总** - 按责任人和主题分类
5. **争议分析** - 识别共识和分歧
6. **双格式输出** - 产出 `.md` 与 `.html`；HTML 使用 `ai-results-html` 渲染器

## 输入格式

```
【学术会议录音整理】

**说话人映射**：
- 说话人1 = 张三（课题组长）
- 说话人2 = [未知，请推断]

【录音内容】
说话人1：大家好，今天我们讨论...
说话人2：我建议...
```

## 输出产物

- `会议纪要.md`：规范化的主产物，便于继续编辑、版本管理和再次渲染
- `会议纪要.html`：基于同名 Markdown 渲染的本地展示页，样式参考 `ai-results-html`
- Markdown 是唯一源稿；HTML 不直接手写，始终从 Markdown 渲染生成

## 默认行为

- **默认双交付**：只要用户没有明确说“只要 Markdown”“不要 HTML/网页”，就默认同时交付 `.md` 和 `.html`
- **默认顺手渲染**：Markdown 主稿完成后，不再停留等待；应立即继续渲染 HTML
- **同目录同主文件名**：优先使用同一个 basename，例如 `学术会议纪要_2026-03-11.md` 和 `学术会议纪要_2026-03-11.html`
- **路径优先级**：用户指定输出目录 > 当前任务目录；若用户未给目录，使用当前工作目录并在回复中写明绝对路径
- **回退原则**：若 HTML 渲染失败，保留 Markdown 主稿，并明确说明失败原因与下一步处理建议

## 默认完整工作流（一步到位）

1. **确定输出路径与文件名**  
   先确定输出目录和 basename；默认让 `.md` 与 `.html` 位于同一目录。
2. **整理并落盘 Markdown 主稿**  
   按本 skill 的结构输出会议纪要；如适合转发，补充 `可直接发送` / `汇报模板` 区块。
3. **自检 Markdown 可渲染性**  
   检查标题层级、表格、checkbox、真实姓名统一和引用块结构，确保 Markdown 是干净的渲染源。
4. **立即调用 ai-results-html 渲染器**  
   使用 `render_review_html.py` 从刚生成的 `.md` 直接产出 `.html`，不要额外等待用户再次要求。
5. **验证 HTML 结果**  
   至少确认 `.nav`、`.hero`、`.sidebar-toc`、`.mobile-toc`、`.footer` 存在；若有 `可直接发送` 等区块，再检查复制按钮。
6. **一次性交付两个文件路径**  
   回复中同时给出 Markdown 和 HTML 的绝对路径，并说明 Markdown 是源稿、HTML 是展示页。

## 优先使用包装脚本

默认优先使用这个一键脚本，而不是每次手写长命令：

```bash
python3 $HOME/.claude/skills/meeting-transcript/scripts/render_meeting_transcript_bundle.py \
  "/absolute/path/学术会议纪要.md"
```

它会自动完成这些事：

- 推断同目录同主文件名的 `.html`
- 从 Markdown 中提取 `会议主题`、`会议时间`、`会议时长`
- 自动生成会议纪要页面标题、副标题和常用 meta pills
- 自动调用 `ai-results-html` 的 `render_review_html.py`
- 自动检查 HTML 是否包含 `.nav`、`.hero`、`.sidebar-toc`、`.mobile-toc`、`.footer`
- 如果 Markdown 中有 `可直接发送` / `汇报模板` / `推荐回复` 等区块，会顺带检查复制按钮

常用可选参数：

```bash
python3 $HOME/.claude/skills/meeting-transcript/scripts/render_meeting_transcript_bundle.py \
  "/absolute/path/学术会议纪要.md" \
  --output-html "/absolute/path/自定义文件名.html" \
  --title "学术会议纪要｜HFpEF课题推进会" \
  --subtitle "2026-03-11 19:00 · 90分钟 · 基于录音转文字整理"
```

只有在你需要完全自定义底层参数时，才退回直接调用 `render_review_html.py`。

## 输出结构（Markdown 主稿）

```markdown
# 学术会议纪要

## 📋 会议基本信息
## 👥 说话人映射
## 🎤 说话人观点汇总
### 张三（课题组长）
#### 💡 核心观点
#### ✅ 提出的建议
#### ❓ 提出的问题
#### 📌 下一步行动
- [ ] 任务 - 截止：时间 - 优先级：高

## ⚖️ 争议与共识
## 📌 行动计划总表
## 💡 关键决策
## ❓ 待解决问题

## 📨 可直接发送汇报（可选）
**可直接发送：**

> 老师您好，今天会议已整理完成。核心决策包括……下一步需您确认的是……
```

对应 HTML 页面应保留 `ai-results-html` 的核心壳层：顶部导航（`.nav`）、hero 区（`.hero`）、侧边目录（`.sidebar-toc`）、移动端目录（`.mobile-toc`）和页脚（`.footer`）。

## HTML 渲染（参考 ai-results-html）

### 推荐方式：一键包装脚本

```bash
python3 $HOME/.claude/skills/meeting-transcript/scripts/render_meeting_transcript_bundle.py \
  "/absolute/path/学术会议纪要.md"
```

### 底层方式：直接调用 ai-results-html 渲染器

先产出结构化 Markdown，再使用下面的渲染命令生成本地 HTML 页面：

```bash
python3 $HOME/.claude/skills/ai-results-html/scripts/render_review_html.py \
  "/absolute/path/学术会议纪要.md" \
  "/absolute/path/学术会议纪要.html" \
  --title "学术会议纪要｜[会议主题]" \
  --subtitle "[会议日期/场景] · 基于录音转文字整理" \
  --badge "会议纪要" \
  --meta-pill "说话人映射" \
  --meta-pill "行动计划" \
  --meta-pill "Markdown + HTML" \
  --nav-link "打开 Markdown|/absolute/path/学术会议纪要.md" \
  --toolbar-link "源文件 Markdown|/absolute/path/学术会议纪要.md" \
  --footer-link "会议目录|/absolute/path"
```

如果 Markdown 中包含 `可直接发送`、`汇报模板`、`推荐回复` 等段落标题，渲染后的 HTML 可以自动生成复制按钮。

## 最终交付规则

最终回复默认应包含：

- Markdown 文件绝对路径
- HTML 文件绝对路径
- 一句说明：`Markdown 为源稿，HTML 已按 ai-results-html 风格渲染`

可直接复用以下回复模板：

```text
已完成会议纪要双产物输出：
- Markdown：/absolute/path/学术会议纪要_YYYY-MM-DD.md
- HTML：/absolute/path/学术会议纪要_YYYY-MM-DD.html

说明：Markdown 为后续修改和再渲染的源稿；HTML 已按 ai-results-html 风格生成，适合直接打开或转发。
```

## 异常回退

- `pandoc` 缺失、渲染器报错或模板不可用时：先保住 Markdown 主稿，不要因为 HTML 失败而中断整个会议纪要交付
- 回复中需明确：
  - Markdown 已生成的绝对路径
  - HTML 未生成的具体原因
  - 下一步建议（如补装 `pandoc` 后重新渲染）

## 质量标准

- 每人至少3个核心观点
- 待办事项使用 checkbox：`- [ ] 任务 - 截止：时间 - 优先级：高`
- 核心观点保留原文表达
- 全文统一使用规范姓名，不混用英文名、昵称和老师称呼
- 时间格式统一（本周五、2026-03-10）
- Markdown 标题层级清晰，可直接作为 HTML 渲染源
- Markdown 完成后默认立即继续渲染 HTML，不额外等待用户再次要求
- `.md` 与 `.html` 默认同目录、同主文件名
- HTML 页面保留 `.nav`、`.hero`、`.sidebar-toc`、`.mobile-toc`、`.footer`
- 若存在 `可直接发送`/`汇报模板` 等区块，HTML 中应出现复制按钮

## 详细模板

完整输入输出模板、示例、特殊场景提取项见 [references/templates.md](references/templates.md)
