# 学习研究类会议纪要生成逻辑

## 一、输出结构总览

```
学习研究类会议纪要
├── 一、会议信息
└── 二、学习研究内容
    ├── 1. 议题标题1 (分享人)
    │   ├── 背景与目的
    │   ├── 核心议题概述
    │   ├── 关键讨论成果
    │   └── 下一步研究方向
    ├── 2. 议题标题2 (分享人)
    └── ...
```

---

## 项目类型区分规则 ⭐⭐⭐

**核心问题**：周报中没有"学习类"标签，工程类和学习研究类项目都混在"P0任务完成情况"和"详细工作内容"中。

**区分方法**：
1. **资料库指引** ⭐：项目在 `input/成员本周资料库/` 下有对应md文件 → 学习研究类
2. **语义判断**：根据任务描述的性质（知识获取/技能提升 vs 产出交付/功能实现）语义判断

**资料库路径**：`D:\AA_Work\skills合集\AIEC-团队开发规范Skills\.claude\skills\meeting-minutes-generator-v1\input\成员本周资料库\`

**背景**：成员会以周报为顶层，讲到对应学习内容时打开资料库里的md进行分享。

---

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

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

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

#### 数据来源映射

| 字段 | 主要来源 | 处理逻辑 |
|------|---------|---------|
| 会议时间 | 会议转写文件名 | 从文件名提取日期："20251118134948-转写..." → "2025-11-18" |
| 参会人员 | 成员周报文件名列表 | 提取所有周报的作者名：`20251118-闫旭隆周报.md` → "闫旭隆"<br>**规则**：固定"连云波"+交了周报的人即为参会人员 |
| 记录整理人 | 固定值 | 固定为"Claude" |

#### 需要的动作
1. 解析会议转写文件名，提取日期并格式化为"YYYY-MM-DD"
2. 遍历周报文件名，提取所有姓名并去重，组成参会人员列表
3. 自动计算会议次数（根据历史纪要数量）或默认显示"第X次周会"
4. 记录整理人固定填写"Claude"

---

### 第二部分：学习研究内容

#### 输出格式
```markdown
### 1. 议题标题 (分享人)

**背景与目的：**
- 学习来源及理论背景
- 研究目的与问题背景

**核心议题概述：**
- 核心观点或理论要点
- 关键技术或方法论

**关键讨论成果：**
- 会议讨论中的Q&A
- 成员反馈与建议
- 形成的共识或结论

**下一步研究方向：**
- 方向1：具体方向描述
- 方向2：具体方向描述
- 方向3：具体方向描述
```

#### 数据来源映射

**核心原则**：三个数据源是互补关系，需要合并整合

| 字段 | 数据来源（互补关系） | 提取与合并逻辑 |
|------|---------------------|---------------|
| 议题标题 | 周报"P0任务完成情况"+"详细工作内容"  +  会议转写议题识别 | 从会议转写识别讨论主题，与周报学习内容匹配去重 |
| 分享人 | 周报项目所属作者+会议转写上下文推断 | 从会议转写识别发言人，匹配周报作者 |
| 背景与目的 | 周报项目内容描述 + 资料库文档上下文（需要Agent总结精要） | 周报提供学习目的，资料库提供理论背景 |
| 核心议题概述 | 周报学习项目总结 + 资料库文档上下文（需要Agent总结精要） | 资料库提供详细理论要点，周报提供简要总结 |
| 关键讨论成果 | ⭐会议转写讨论片段 + 周报反思 | 会议转写提取Q&A和讨论结论，周报补充个人反思 |
| 下一步研究方向 | 会议转写讨论结论 + 周报下周计划 | 会议讨论中形成的研究方向，结合周报计划 |

#### 需要的动作

**说明**：动作1-3由主窗口在 Phase 1.5 执行，动作4-5由 Phase 4 执行。

**动作1：扫描资料库（主窗口执行）**
- `Glob: input/成员本周资料库/*.md`
- **轻量读取**：只读取文件名 + 前100行（标题、摘要）
- ⚠️ 不读取完整内容，避免污染上下文
- 提取：文件名、文档标题、简要描述
- 作为"确定学习研究类"的强指引

**动作2：遍历周报提取项目（主窗口执行）**
- 遍历所有周报的"P0任务完成情况"+"详细工作内容"
- 对每个项目判断类型：
  - 检查资料库是否有对应md → `has_library_file=true`
  - 语义判断是否为学习研究类（知识获取/技能提升 vs 产出交付/功能实现）
- 提取：项目名、成员、周报描述

**动作3：合并去重（主窗口执行）**
- 资料库有 + 周报有 → 学习研究类（资料库里有的周报一定有）
- 资料库无 + 周报有（语义判断为学习类） → 学习研究类
- 去重后构建 `learning_projects` 列表：
  ```python
  learning_projects = [
    {
      "name": "Claude Code Skill学习",
      "member": "闫旭隆",
      "has_library_file": true,
      "library_path": "input/成员本周资料库/xxx.md",
      "weekly_content": "周报描述..."
    }
  ]
  ```

**动作4：提取详细内容（调用 transcript_searcher Agent）**
- 主窗口传递 `learning_projects` 给 Agent
- Agent 根据 `has_library_file` 字段决定内容来源：
  - `true`：读取 `library_path` 资料库md + 会议转写
  - `false`：仅从会议转写上下文推断
- Agent 提取：议题标题、分享人、背景与目的、核心议题概述、关键讨论成果、下一步研究方向
- **合并规则**：
  - 背景与目的：周报学习目的 + 资料库/会议背景
  - 核心议题概述：资料库核心内容（有资料库时）或会议推断（无资料库时）
  - 关键讨论成果：会议Q&A + 反馈 + 共识
  - 下一步方向：会议讨论结论 + 周报下周计划

**动作5：结构化输出（主窗口执行）**
- 遍历 Agent 返回的 topics，按模板格式化
- 按议题组织内容（通常2-5个议题）
- 按讨论顺序或重要性排序
- 每个议题独立成节，格式统一

---

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

| 字段 | 数据来源 | 优先级规则 | 说明 |
|------|---------|-----------|------|
| **议题标题** | 会议转写 + 周报 | **会议优先** | 会议中讨论的主题更准确，周报标题作为补充 |
| **分享人** | 会议转写推断 + 周报作者 | **会议为准** | 从会议上下文识别实际分享人 |
| **背景与目的** | 周报 + 资料库 | **互补合并** | 周报提供学习目的，资料库提供理论背景 |
| **核心议题概述** | 资料库 + 周报 | **资料库优先** | 资料库提供详细理论，周报提供简要概括 |
| **关键讨论成果** | 会议转写 + 周报 | **会议为主** | 会议讨论内容是核心，周报反思作为补充 |
| **下一步方向** | 会议转写 + 周报 | **会议优先** | 会议讨论中形成的方向更明确，周报计划作为补充 |

---

## 四、特殊情况处理

**情况1：资料库文件过大**
```
资料库中PDF/论文超过50页
处理：只提取摘要、引言、结论章节，不读取全文
```

**情况2：多人分享同一主题**
```
会议中多人共同讨论一个理论/项目
处理：分享人标注为"张三、李四"，合并所有人的观点到一个议题
```

**情况3：周报学习内容会议未讨论**
```
周报中提到的学习内容，但会议中未讨论
处理：保留该议题，标注"（未在会议中讨论）"，内容仅基于周报和资料库
```

**情况4：会议讨论内容周报未提及**
```
会议中临时讨论的学习内容，但周报中未记录
处理：保留该议题，基于会议转写提取背景和讨论内容
```