# Q&A资源库类会议纪要生成逻辑

## 一、输出结构总览

```
Q&A资源库类会议纪要
├── 一、会议信息
├── 二、工作问题 Q&A
│   ├── 1. 项目名称1
│   │   ├── 主要问题
│   │   └── 解决方案
│   ├── 2. 项目名称2
│   └── ...
└── 三、重点工作方法
    ├── 方法1
    │   ├── 方法描述
    │   ├── 适用场景
    │   └── 关键要点
    ├── 方法2
    └── ...
```

---

## 核心定位说明 ⭐⭐⭐

**Q&A资源库类会议纪要是二次提取产物**：
- **执行时机**：在工程类和学习研究类会议纪要生成之后执行
- **核心目的**：知识沉淀，构建可复用的Q&A资源库
- **数据来源**：
  - "工作问题 Q&A"：从已生成的工程类/学习研究类纪要中提取
  - "重点工作方法"：从会议转写+周报中新提取

**依赖文件**：
- 已生成的工程类会议纪要（必需）
- 已生成的学习研究类会议纪要（可选）
- 会议转写文件（用于提取工作方法）
- 成员周报（用于提取工作方法）

---

## 二、章节数据来源与处理动作

### 第一部分：会议信息

#### 输出格式
```markdown
一、会议信息
- 会议时间：2025-11-18
- 参会人员：连云波、江争达、闫旭隆、陶西平、郝倩玉
- 记录整理人：Claude
```

#### 数据来源映射

| 字段 | 主要来源 | 处理逻辑 |
|------|---------|---------|
| 会议时间 | 已生成的工程类会议纪要 | 直接复用"会议信息"章节的会议时间 |
| 参会人员 | 已生成的工程类会议纪要 | 直接复用"会议信息"章节的参会人员 |
| 记录整理人 | 固定值 | 固定为"Claude" |

#### 需要的动作
1. 读取已生成的工程类会议纪要文件
2. 提取"一、会议信息"章节内容
3. 直接复用，格式保持一致

---

### 第二部分：工作问题 Q&A

#### 输出格式
```markdown
## 二、工作问题 Q&A

### 1. 项目名称：会议纪要信息提取
- **主要问题：** 转写说话人识别不准确，导致无法正确归属发言内容
- **解决方案：**
  1. 采用语义分析替代说话人标记
  2. 通过上下文推断发言者身份
  3. 结合周报内容进行交叉验证

---

### 2. 项目名称：Skill架构设计
- **主要问题：** Agent间数据传递方式不清晰
- **解决方案：**
  1. 主窗口传递标识符和文件路径
  2. Agent通过temp/目录交换数据
  3. Agent直接返回文字结果给主窗口
```

#### 数据来源映射

**核心原则**：二次提取，从已生成纪要中汇总

| 字段 | 数据来源（优先级从高到低） | 提取逻辑 |
|------|---------------------------|---------|
| 项目名称 | 工程类纪要"问题及解决方案"章节标题 | 提取"问题N: XXX"中的项目/问题名称 |
| 主要问题 | 工程类纪要"问题描述"字段 | 直接提取，精简为1-2句话 |
| 解决方案 | 工程类纪要"解决方案"列表 | 直接提取，保持列表格式 |

**补充来源**（学习研究类纪要）：

| 字段 | 数据来源 | 提取逻辑 |
|------|---------|---------|
| 项目名称 | 学习研究类纪要的议题标题 | 从学习议题中识别问题讨论部分 |
| 主要问题 | "关键讨论成果"中的Q&A | 提取讨论中的问题部分 |
| 解决方案 | "关键讨论成果"中的答案/共识 | 提取讨论中形成的解决方案 |

#### 需要的动作

**动作1：提取工程类纪要中的问题（主窗口执行）**
- 读取已生成的工程类会议纪要
- 定位"### 2. 重点项目问题及解决方案"章节
- 解析每个问题块，提取：
  - 问题标题（作为项目名称）
  - 问题描述（精简为主要问题）
  - 解决方案列表
  - 责任人（可选，用于追溯）
  - 截止时间（可选，用于追溯）

**动作2：提取学习研究类纪要中的Q&A（主窗口执行，可选）**
- 读取已生成的学习研究类会议纪要（如存在）
- 定位每个议题的"关键讨论成果"部分
- 识别Q&A格式内容：
  - 问题：通常以"Q:"、"问题"、"？"等标识
  - 答案/方案：紧随问题之后的回答内容

**动作3：提取成员反馈中的问题（主窗口执行，可选）**
- 从工程类纪要"### 4. 组内成员工作进展"中提取
- 识别"收到的反馈/学习建议"部分中包含的问题和建议
- 转化为Q&A格式

**动作4：合并去重（主窗口执行）**
- 将所有来源的问题进行语义匹配
- 相似度 > 80% 视为同一问题，合并解决方案
- 按项目分组，同一项目的多个问题归类在一起

**动作5：格式化输出（主窗口执行）**
- 按项目编号组织输出
- 格式：### {序号}. 项目名称：{project_name}
- 包含：主要问题 + 解决方案列表

---

### 第三部分：重点工作方法

#### 输出格式
```markdown
## 三、重点工作方法

- **方法 1：语义分析替代说话人标记**
  - 当转写文本说话人识别不准确时，通过分析发言内容的语义特征来判断发言者
  - 适用场景：会议转写处理、发言归属分析
  - 关键要点：
    - 关注发言中的人称代词和上下文
    - 结合周报内容进行交叉验证
    - 利用任务分配信息推断发言者

- **方法 2：渐进式披露原则**
  - Skill设计中采用三级加载系统，元数据→主体→资源按需加载
  - 适用场景：Claude Code Skill开发、大型项目架构
  - 关键要点：
    - 元数据始终在上下文中（~100词）
    - 主体内容触发时加载（<3k词）
    - 详细资源按需读取
```

#### 数据来源映射

**核心原则**：会议转写 + 周报，两者结合

| 字段 | 数据来源 | 提取逻辑 |
|------|---------|---------|
| 方法标题 | 会议转写中的方法分享 + 周报经验总结 | 从分享内容中提炼方法名称 |
| 方法描述 | 会议转写详细讲解 + 周报总结描述 | 合并两者，形成完整描述 |
| 适用场景 | 会议讨论上下文 + 周报应用场景 | 从讨论中识别方法的适用范围 |
| 关键要点 | 会议讲解要点 + 周报经验要点 | 提炼为3-5条核心要点 |

#### 需要的动作

**动作1：从会议转写提取方法分享（调用 Agent）**
- 调用 transcript_searcher Agent
- 搜索意图：提取会议中分享的工作方法、技巧、最佳实践
- 识别特征：
  - "方法是..."、"技巧是..."、"经验是..."
  - "我的做法是..."、"建议..."、"注意..."
  - 总结性、经验性、指导性语句
- 提取字段：方法名称、详细描述、提出人

```python
Task(
  subagent_type="transcript_searcher",
  description="提取工作方法",
  prompt="""提取会议中分享的工作方法、技巧、最佳实践。

识别特征：
- 方法论讲解（"方法是..."、"技巧是..."）
- 经验分享（"我的做法是..."、"建议..."）
- 总结性语句（"总结一下..."、"关键是..."）

需提取字段：
- 方法名称（简短标题）
- 方法描述（详细说明）
- 提出人（从上下文推断）
- 相关项目（方法关联的项目）

返回JSON格式。
"""
)
```

**动作2：从周报提取经验总结（主窗口执行）**
- 遍历所有周报
- 从"详细工作内容"中识别方法论/经验总结内容
- 识别特征：
  - 带有"方法"、"技巧"、"经验"等关键词的段落
  - 总结性、归纳性描述
  - 可复用的工作模式
- 提取：方法标题、描述、作者

**动作3：合并整理（主窗口执行）**
- 将会议方法与周报方法进行语义匹配
- 相似方法合并，补充细节
- 为每个方法生成完整结构：
  - 方法标题
  - 方法描述（合并会议详细讲解 + 周报简要描述）
  - 适用场景（从会议讨论上下文推断）
  - 关键要点（提炼为3-5条）

**动作4：格式化输出（主窗口执行）**
- 按方法编号组织输出
- 格式：- **方法 {序号}：{方法标题}**
- 包含：描述 + 适用场景 + 关键要点列表

---

## 三、关键数据优先级规则总结

| 字段 | 数据来源 | 优先级规则 | 说明 |
|------|---------|-----------|------|
| **会议信息** | 工程类纪要 | **直接复用** | 无需重新提取 |
| **Q&A-项目名称** | 工程类纪要 > 学习类纪要 | **工程类优先** | 工程类问题更明确 |
| **Q&A-主要问题** | 工程类纪要 > 学习类纪要 | **工程类优先** | 工程类描述更完整 |
| **Q&A-解决方案** | 工程类纪要 + 学习类纪要 | **互补合并** | 合并所有解决方案 |
| **方法-标题** | 会议转写 > 周报 | **会议优先** | 会议分享通常更正式 |
| **方法-描述** | 会议转写 + 周报 | **互补合并** | 会议详细 + 周报简要 |
| **方法-适用场景** | 会议讨论上下文 | **仅会议** | 从讨论中推断 |
| **方法-关键要点** | 会议转写 + 周报 | **互补合并** | 提炼核心要点 |

---

## 四、特殊情况处理

**情况1：工程类纪要不存在**
```
处理：无法生成Q&A资源库类纪要，提示用户先生成工程类纪要
原因：工程类纪要是Q&A的主要数据来源
```

**情况2：学习研究类纪要不存在**
```
处理：正常生成，仅使用工程类纪要作为Q&A数据来源
说明：学习研究类纪要是可选补充来源
```

**情况3：工程类纪要中无问题章节**
```
处理：
- 如果学习研究类纪要存在且有Q&A → 使用学习研究类纪要
- 如果都没有 → "二、工作问题 Q&A"章节输出"本次会议无记录的问题讨论"
```

**情况4：会议中无方法分享**
```
处理：
- 如果周报中有经验总结 → 使用周报内容
- 如果都没有 → "三、重点工作方法"章节输出"本次会议无记录的方法分享"
```

**情况5：同一问题在多个来源中重复**
```
工程类纪要和学习研究类纪要都有同一问题
处理：
- 语义匹配后合并
- 问题描述取更完整的版本
- 解决方案列表合并去重
```

**情况6：方法分享过于零散**
```
会议中零散提到多个小技巧，但没有系统性方法
处理：
- 相关技巧归类合并为一个"方法"
- 标题使用归纳性名称（如"XX相关技巧汇总"）
```

---

## 五、执行流程总结

```
Phase 1: 检查依赖
├── 检查工程类会议纪要是否存在（必需）
├── 检查学习研究类会议纪要是否存在（可选）
└── 检查会议转写和周报文件（用于提取方法）

Phase 2: 提取会议信息
└── 从工程类纪要复用"会议信息"章节

Phase 3: 提取工作问题 Q&A
├── 从工程类纪要提取"问题及解决方案"
├── 从学习研究类纪要提取"关键讨论成果"中的Q&A（可选）
├── 从成员反馈中提取问题建议（可选）
└── 合并去重，按项目分组

Phase 4: 提取重点工作方法
├── 调用Agent从会议转写提取方法分享
├── 从周报提取经验总结
└── 合并整理，生成完整方法结构

Phase 5: 最终输出
├── 组装所有章节
└── 写入文件：output/Q&A资源库类会议纪要_{date}_第X次周会.md
```

---

## 六、输出文件命名规则

- **文件名格式**：`Q&A资源库类会议纪要_{date}_第X次周会.md`
- **日期格式**：YYYY-MM-DD
- **周会次数**：与工程类纪要保持一致

**示例**：`Q&A资源库类会议纪要_2025-11-18_第二次周会.md`