Aily Doc Concept Explainer

---
name: aily-doc-concept-explainer
label: 概念解释
description: 概念解释：由浅入深讲清概念的定义、原理与本质，面向不同知识背景的读者。
---

# SKILL: aily-doc-concept-explainer

概念解释：由浅入深讲清概念的定义、原理与本质，面向不同知识背景的读者。适用于：用户希望彻底理解某个概念/术语/技术/理论，从直觉层到形式化层逐步深入，同时配合类比、图示、案例等多维度辅助理解。

---

## 1) Overview

### ⚠️ 输出形式（强制）
- **本 skill 被触发即代表用户期望生成飞书云文档**，主 Agent 无需询问用户是否需要写成文档，也不得以对话文本替代文档作为最终交付物。
- 数据收集完成后，必须通过 `task`（subagent_type: writer）委托 Writer Agent 创建飞书云文档。

### 飞书工具优先（必须遵守）
- 所有飞书相关信息获取与写作，先参考 `feishu-use-skills-map` 并按其指引调用对应技能
- 需要访问飞书文档/群消息/会议/任务时，必须先 `get_skills` 获取对应飞书技能说明

### 工具/Skill 明确清单（执行前先 get_skills）
- 必须先参考 `feishu-use-skills-map` 并调用对应技能
- 主要技能及用途：

| 工具 | 用途 | 适用场景 |
|------|------|---------|
| `knowledge_answer` | 检索内部知识库 | 公司内部对该概念的定义、使用惯例、内部文档 |
| `web_search` | 广泛检索公开信息 | 权威定义、原理解释、类比素材、历史演进、应用案例、常见误区 |
| `fetch` | 获取特定网页/文档全文 | 深入阅读权威教程、百科页面、技术博客、学术资料 |
| `aily-diagram` | 生成流程图/结构图/关系图 | 概念关系图谱、工作流程图、层次结构图、对比图 |
| `file` | 将素材写入 draft.md（append 模式） | 每个数据步骤完成后 |

### 证据与时间约束（与主/写作agent一致）
- 任何数据/结论必须来自可追溯来源；不确定则明确标注"需补充资料"。
- 若用户指定时间范围，必须严格筛选在时间窗内的资料，过期内容不得使用。
- 不可编造事实、链接或来源；引用必须有明确出处。
- 定义与原理部分必须引用权威来源（教科书、官方文档、权威百科、学术论文），不得仅依赖二手博客。

### 可读性规则（强制）
- 并列项>=3：优先使用无序/有序列表或表格
- 单段>150字必须拆分（列表/小节/Callout）
- 连续两段无列表且信息密度高：插入列表或 Callout
- 类比与图示穿插在正文中，不集中堆砌
- 公式/模型附带自然语言解释，不裸写公式

### 触发方式（Triggers）
当用户出现以下意图时触发本 skill：
- "由浅入深解释"
- "彻底搞懂"
- "本质是什么"
- "帮我理解XX"
- "XX到底是什么"
- "用通俗的话解释XX"
- "XX的原理是什么"
- "深入讲讲XX"

### 输入（Inputs）
- **必选**：概念/术语（一个明确的概念名称或短语）
- **可选**：
  - 期望深度（入门/标准/深度）
  - 背景知识（读者已有的知识水平，例如"我是非技术人员""我有计算机本科背景"）
  - 困惑点（读者具体不理解的方面，例如"不明白为什么需要XX""搞不清XX和YY的区别"）
  - 应用场景偏好（希望重点关注哪个领域的应用）

### 核心输出（Deliverables）
- **飞书云文档概念解析**：层次递进、结构清晰、多维解释、可读性强

### 质量标准
- **层次递进**：从直觉层（一句话+类比）到机制层（原理+流程）到形式化层（公式/模型）到权衡层（局限+对比），逐层深入，读者可按需停止阅读
- **多维解释**：同一概念至少使用 3 种解释维度——类比（生活化比喻）、图示（结构图/流程图）、形式化（公式/模型/定义），三者互补
- **准确性**：核心定义与原理必须有权威来源支撑，不得凭主观理解编写
- **区分度**：必须明确该概念与易混淆概念的边界

---

## 2) 任务分解示例（todo_write）

主 Agent 收到概念解释请求后，使用 `todo_write` 分解任务：

```json
{
  "todos": [
    {"content": "确认概念范围：明确用户要解释的概念、期望深度、背景知识、困惑点", "status": "in_progress"},
    {"content": "A1-权威定义检索：web_search + knowledge_answer 获取概念的权威定义与含义", "status": "pending"},
    {"content": "A2-原理与机制检索：web_search + fetch 获取概念的工作原理与核心机制", "status": "pending"},
    {"content": "A3-类比与图示素材：web_search 获取通俗解释与类比，准备 aily-diagram 输入", "status": "pending"},
    {"content": "A4-历史与演进检索：web_search 获取概念的起源、发展历程与版本演进", "status": "pending"},
    {"content": "A5-应用与案例检索：web_search 获取典型应用场景与实际案例", "status": "pending"},
    {"content": "A6-常见误区检索：web_search 获取常见误解、易混淆点与FAQ", "status": "pending"},
    {"content": "结构化分析：确定讲解层次、构建类比体系、整理公式模型、梳理关系图谱", "status": "pending"},
    {"content": "调用 writer agent 生成概念解析飞书云文档", "status": "pending"}
  ]
}
```

---

## 3) Module A — 资料获取（主 Agent 执行）

> **核心原则**：优先使用飞书工具获取内部知识，再用外部检索补充权威公开信息。每一步检索完成后，将结构化结果写入 `draft.md`，供后续 Writer Agent 使用。

### A1. 权威定义

**目标**：获取概念最权威、最准确的定义，确保后续所有解释建立在正确的基础上。

**web_search 查询**（中英文双语检索）：
```
- "{概念} 定义 含义"
- "{概念} 是什么 解释"
- "{concept} definition"
- "{concept} meaning explanation"
```

**knowledge_answer 查询**（内部知识库）：
```
knowledge_answer(
  query_list: [
    "{概念} 的定义和含义",
    "公司内部如何定义 {概念}",
    "{概念} 相关的内部文档和规范"
  ],
  explanation: "检索内部知识库中对该概念的定义、使用惯例和相关文档"
)
```

**来源优先级**：
1. 权威教科书/学术论文中的定义
2. 官方文档/标准组织的定义（如 IEEE、W3C、RFC 等）
3. 权威百科（维基百科、百度百科的引用来源）
4. 内部知识库中的定义

**写入 draft.md**（使用 `file(path: "/home/workspace/draft.md", mode: "append")`）：
```markdown
## A1. 权威定义

### 核心定义
- 定义1（来源：{教科书/论文/标准}）：...
- 定义2（来源：{官方文档}）：...

### 词源与命名由来
- 该概念的英文名/中文名的由来：...
- 命名背后的隐喻或思路：...

### 内部定义（如有）
- 公司内部对该概念的使用惯例：...
- 与通用定义的差异（如有）：...
```

---

### A2. 原理与机制

**目标**：获取概念背后的工作原理、核心机制和关键步骤，理解"它是怎么运作的"。

**web_search 查询**：
```
- "{概念} 原理 工作机制"
- "{概念} 工作原理 流程"
- "{concept} how it works"
- "{concept} mechanism principle"
- "{概念} 核心算法 核心方法"
```

**fetch 深度阅读**（对检索到的权威教程/百科进行全文阅读）：
```
fetch(
  url: "{权威教程/技术文档/百科页面URL}",
  prompt: "提取该页面中关于 {概念} 的工作原理、核心机制、关键步骤和技术细节"
)
```

**写入 draft.md**（使用 `file(path: "/home/workspace/draft.md", mode: "append")`）：
```markdown
## A2. 原理与机制

### 核心机制
- 该概念的核心工作原理：...（来源：{URL}）

### 关键步骤/流程
1. 步骤1：...
2. 步骤2：...
3. 步骤3：...

### 关键公式/模型（如适用）
- 公式1：... （含义：...）
- 公式2：... （含义：...）

### 技术细节
- 前置条件/假设：...
- 核心约束：...
- 输出/结果：...
```

---

### A3. 类比与图示素材

**目标**：收集用于直观理解的类比、比喻和可视化素材，降低读者的认知门槛。

**web_search 查询**：
```
- "{概念} 类比 比喻 通俗解释"
- "{概念} 用一句话解释"
- "{concept} analogy metaphor"
- "{concept} explained simply"
- "{concept} for beginners"
```

**准备 aily-diagram 的输入**：
根据检索到的原理与机制信息，准备以下类型的图示请求：
- **结构图**：概念的组成部分与层次关系
- **流程图**：概念的工作流程或关键步骤
- **关系图**：该概念与相关概念的关联
- **对比图**：该概念与易混淆概念的区别

**写入 draft.md**（使用 `file(path: "/home/workspace/draft.md", mode: "append")`）：
```markdown
## A3. 类比与图示素材

### 生活类比候选
- 类比1：{概念}就像{生活事物}，因为...（来源：{URL}）
- 类比2：{概念}可以理解为{日常场景}，其中...（来源：{URL}）
- 类比3：如果把{概念}比作{具体事物}，那么...（来源：{URL}）

### 类比评估
| 类比 | 覆盖维度 | 局限性 | 推荐度 |
|------|---------|--------|--------|
| 类比1 | 解释了XX方面 | 未覆盖YY | 高/中/低 |
| 类比2 | 解释了XX方面 | 未覆盖YY | 高/中/低 |

### 图示规划
- 图1（结构图）：展示{概念}的组成部分 → aily-diagram 输入描述
- 图2（流程图）：展示{概念}的工作流程 → aily-diagram 输入描述
- 图3（关系图）：展示{概念}与{相关概念}的关系 → aily-diagram 输入描述
```

---

### A4. 历史与演进

**目标**：获取概念的起源、演进历程和关键里程碑，帮助读者理解"为什么会有这个概念"。

**web_search 查询**：
```
- "{概念} 历史 演进 发展"
- "{概念} 起源 由来 发明"
- "{concept} history evolution"
- "{concept} origin development timeline"
- "{概念} 版本 迭代 变迁"
```

**写入 draft.md**（使用 `file(path: "/home/workspace/draft.md", mode: "append")`）：
```markdown
## A4. 历史与演进

### 起源
- 提出时间：...
- 提出者/提出组织：...
- 提出背景与动机：为了解决什么问题？（来源：{URL}）

### 演进时间线
| 时间 | 里程碑事件 | 关键变化 | 来源 |
|------|-----------|---------|------|
| YYYY | 概念首次提出 | ... | {URL} |
| YYYY | 重大改进/新版本 | ... | {URL} |
| YYYY | 广泛采用/标准化 | ... | {URL} |

### 演进驱动力
- 技术驱动：...
- 需求驱动：...
- 范式转移：...
```

---

### A5. 应用与案例

**目标**：获取概念在实际场景中的应用，帮助读者理解"这个概念有什么用"。

**web_search 查询**：
```
- "{概念} 应用 案例 实际场景"
- "{概念} 使用场景 应用领域"
- "{concept} use cases applications"
- "{concept} real world examples"
- "{概念} 最佳实践 best practice"
```

**写入 draft.md**（使用 `file(path: "/home/workspace/draft.md", mode: "append")`）：
```markdown
## A5. 应用与案例

### 典型应用场景
| 场景 | 描述 | 为什么用该概念 | 来源 |
|------|------|--------------|------|
| 场景1 | ... | ... | {URL} |
| 场景2 | ... | ... | {URL} |
| 场景3 | ... | ... | {URL} |

### 实际案例
#### 案例1：{案例名称}
- 背景：...
- 如何应用{概念}：...
- 效果/结果：...
- 来源：{URL}

#### 案例2：{案例名称}
- 背景：...
- 如何应用{概念}：...
- 效果/结果：...
- 来源：{URL}

### 不适用场景（同样重要）
- 场景X：为什么不适合使用该概念：...
- 场景Y：为什么不适合使用该概念：...
```

---

### A6. 常见误区

**目标**：收集关于该概念的常见误解、易混淆点和高频问题，帮助读者避开认知陷阱。

**web_search 查询**：
```
- "{概念} 常见误解 误区"
- "{概念} 常见错误 FAQ"
- "{概念} 区别 vs 对比"
- "{concept} common misconceptions"
- "{concept} myths FAQ"
- "{概念} 和 {易混淆概念} 的区别"
```

**写入 draft.md**（使用 `file(path: "/home/workspace/draft.md", mode: "append")`）：
```markdown
## A6. 常见误区

### 误区清单
| 误区 | 正确理解 | 来源 |
|------|---------|------|
| 误区1：认为{概念}是... | 实际上{概念}是...，因为... | {URL} |
| 误区2：把{概念}和{其他概念}混为一谈 | 两者的核心区别在于... | {URL} |
| 误区3：认为{概念}可以... | 实际上{概念}的边界是... | {URL} |

### 易混淆概念对比
| 维度 | {概念} | {易混淆概念A} | {易混淆概念B} |
|------|--------|-------------|-------------|
| 定义 | ... | ... | ... |
| 侧重点 | ... | ... | ... |
| 适用场景 | ... | ... | ... |
| 关键区别 | ... | ... | ... |

### 高频 FAQ
1. Q: {概念}和{相关概念}有什么区别？
   A: ...（来源：{URL}）
2. Q: {概念}的局限性是什么？
   A: ...（来源：{URL}）
3. Q: 什么时候应该使用{概念}？
   A: ...（来源：{URL}）
```

---

## 4) Module B — 结构化分析（主 Agent 执行）

> **核心原则**：将 Module A 收集的素材进行结构化整理，形成由浅入深的讲解层次，确保最终文档逻辑清晰、层次分明。

### B1. 确定讲解层次

根据概念的复杂度和用户的背景知识，确定四层递进结构：

```
┌─────────────────────────────────────────────────────────────┐
│ 第四层：权衡层（Trade-off Layer）                              │
│ - 局限性与边界条件                                             │
│ - 与替代方案的对比权衡                                         │
│ - 适用 vs 不适用场景                                           │
├─────────────────────────────────────────────────────────────┤
│ 第三层：形式化层（Formal Layer）                               │
│ - 数学公式/模型定义                                            │
│ - 严格的技术规格                                               │
│ - 证明/推导（如适用）                                          │
├─────────────────────────────────────────────────────────────┤
│ 第二层：机制层（Mechanism Layer）                               │
│ - 核心原理与工作流程                                           │
│ - 关键步骤与因果关系                                           │
│ - 组成部分与相互作用                                           │
├─────────────────────────────────────────────────────────────┤
│ 第一层：直觉层（Intuition Layer）                              │
│ - 一句话定义                                                   │
│ - 生活类比                                                     │
│ - 图示说明                                                     │
└─────────────────────────────────────────────────────────────┘
```

**层次深度决策规则**：
- 用户说"入门/通俗"：重点展开第一层和第二层，第三四层简要提及
- 用户说"标准"（默认）：四层均展开，第三层中等深度
- 用户说"深度"：四层均深度展开，第三层包含完整公式推导

### B2. 构建类比体系

从 A3 收集的类比候选中，筛选并构建一套互补的类比体系：

**筛选标准**：
1. **准确性**：类比是否正确映射了概念的核心机制？
2. **覆盖度**：多个类比组合后是否覆盖了概念的主要方面？
3. **局限标注**：每个类比的局限是否已明确？（类比一定有局限，必须说明"这个比喻在哪里会失效"）

**类比体系结构**：
- 主类比（覆盖核心机制的生活化比喻，用于"直觉层"）
- 补充类比（覆盖主类比未触及方面的比喻，用于"机制层"的辅助理解）
- 反面类比（"它不像什么"，用于纠正常见误解）

### B3. 整理关键公式/模型（如适用）

并非所有概念都有公式/模型，但若该概念涉及定量描述，则需整理：

**整理规范**：
- 每个公式必须附带"自然语言翻译"（把公式翻译成一句话）
- 每个符号必须在第一次出现时定义
- 公式之间的逻辑关系必须说明（从哪个公式推导出哪个公式）
- 给出公式的直觉解释（"这个公式在说什么"）

**写入 draft.md**（使用 `file(path: "/home/workspace/draft.md", mode: "append")`）：
```markdown
## B3. 公式/模型整理

### 核心公式
公式1：{LaTeX 或文本表述}
- 自然语言翻译：...
- 符号定义：{符号} = {含义}
- 直觉解释：这个公式告诉我们...

### 公式间关系
公式1 → 公式2：通过{条件/推导}得到...
```

### B4. 梳理与相关概念的关系图谱

**关系类型标注**：
- **上位概念**：{概念}属于哪个更大的范畴？
- **下位概念**：{概念}有哪些子类型/变体？
- **并列概念**：与{概念}处于同一层级的其他概念是什么？
- **前置概念**：理解{概念}之前需要先理解什么？
- **后续概念**：理解了{概念}之后可以进一步学习什么？
- **对立/替代概念**：与{概念}解决同一问题但思路不同的概念是什么？

**写入 draft.md**（使用 `file(path: "/home/workspace/draft.md", mode: "append")`）：
```markdown
## B4. 概念关系图谱

### 层次关系
- 上位概念：{大范畴} → 包含 → {概念}
- 下位概念：{概念} → 包含 → {子类型A}、{子类型B}

### 并列关系
- {概念} 与 {并列概念A}：都属于{大范畴}，但{概念}侧重...，{并列概念A}侧重...
- {概念} 与 {并列概念B}：都属于{大范畴}，但...

### 依赖关系
- 前置知识：先理解{前置概念}，再理解{概念}
- 后续学习：理解{概念}后，可进一步学习{后续概念}

### 替代/对立关系
- {概念} vs {替代概念}：解决同一问题，但{概念}用{方法A}，{替代概念}用{方法B}

### 图示请求（aily-diagram）
生成一张以 {概念} 为中心的关系图谱，包含上述所有关系类型。
```

---

## 5) Module C — 调用 Writer Agent 生成文档

### 任务分发

主 Agent 完成数据收集（Module A）和结构化分析（Module B）后，将所有素材写入 `draft.md`，然后调用 `task` 工具分发给 Writer Agent：

```json
{
  "description": "生成概念解析飞书云文档",
  "prompt": "基于 /home/workspace/draft.md 中的概念解析素材，生成一份由浅入深的飞书云文档概念解析。\n\n要求：\n1. 严格按照概念解析文档模板结构\n2. 四层递进：直觉层 → 机制层 → 形式化层 → 权衡层\n3. 类比必须标注局限性\n4. 公式/模型必须附带自然语言解释\n5. 易混淆概念必须有明确对比\n6. 所有定义和数据标注来源\n\n文档模板见下方。",
  "subagent_type": "writer"
}
```

### Writer Agent 执行流程

```
Writer Agent 收到任务
        ↓
1. file_read: 读取 /home/workspace/draft.md
        ↓
2. outline_generator: 基于 draft.md 素材生成结构化大纲
   - 输入：draft.md 中的素材 + 概念解析文档模板
   - 输出：符合模板的大纲（含每节标题和要点）
        ↓
3. feishu_doc_create: 基于大纲生成飞书云文档
   - 按大纲逐节填充内容
   - 插入 aily-diagram 生成的图示
   - 套用可读性规则格式化
        ↓
4. end: 返回飞书云文档链接
```

---

## 6) 详细文档模板（Writer Agent 遵循）

```markdown
# {概念} 解析

> 适合读者：{背景假设，例如"有基础编程经验，但不熟悉分布式系统"}
> 生成时间：YYYY-MM-DD

---

## TL;DR

**一句话定义**：{概念}是{一句话核心定义}。

**为什么重要**：{1-2句说明该概念的重要性和影响力}。

---

## 一、概念定位

### 1.1 一句话定义

{概念}是指{清晰、准确、不超过50字的定义}。

> 来源：{权威来源名称与链接}

### 1.2 所属领域与上下文

- **所属领域**：{大领域} → {子领域} → {概念}
- **出现背景**：{概念}出现在{什么场景}中，用于解决{什么问题}
- **在整体体系中的位置**：{概念}是{更大框架}的{哪个部分/环节}

### 1.3 与相关概念的关系

| 关系类型 | 相关概念 | 关系说明 |
|---------|---------|---------|
| 上位概念 | {大范畴} | {概念}是{大范畴}的一种 |
| 下位概念 | {子类型} | {子类型}是{概念}的具体形式 |
| 并列概念 | {并列概念} | 同属{大范畴}，但侧重点不同 |
| 前置知识 | {前置概念} | 理解{概念}需要先了解{前置概念} |
| 易混淆 | {易混淆概念} | 常被混淆，核心区别是... |

---

## 二、直观理解

### 2.1 生活类比

**主类比**：

{概念}就像{生活中的事物/场景}。

{展开解释类比的对应关系：
- {概念的特征A} 对应 {生活事物的特征A}
- {概念的特征B} 对应 {生活事物的特征B}
- {概念的特征C} 对应 {生活事物的特征C}}

> 类比局限：这个比喻在{某方面}会失效，因为{原因}。实际上{概念}还具有{类比未覆盖的特征}。

**补充类比**：

从另一个角度看，{概念}也可以理解为{另一个生活化比喻}。这个类比更好地解释了{概念的某个方面}。

### 2.2 图示说明

{插入 aily-diagram 生成的图示}

**图示解读**：
- {图中元素A}代表{概念的部分A}
- {图中元素B}代表{概念的部分B}
- {箭头/连线}表示{关系/流程}

---

## 三、工作原理

### 3.1 核心机制

{概念}的核心机制可以概括为：

1. **{机制要素1}**：{详细解释}
2. **{机制要素2}**：{详细解释}
3. **{机制要素3}**：{详细解释}

> 来源：{权威来源}

### 3.2 关键步骤/流程

{概念}的工作流程如下：

```
步骤1: {描述} → 步骤2: {描述} → 步骤3: {描述} → 输出: {描述}
```

**详细说明**：

| 步骤 | 输入 | 处理 | 输出 | 说明 |
|------|------|------|------|------|
| 步骤1 | ... | ... | ... | ... |
| 步骤2 | ... | ... | ... | ... |
| 步骤3 | ... | ... | ... | ... |

### 3.3 关键公式/模型（如适用）

**公式1**：{公式的LaTeX或文本表述}

- **自然语言翻译**：这个公式说的是{一句话解释}
- **符号定义**：
  - {符号1} = {含义}
  - {符号2} = {含义}
- **直觉理解**：{用日常语言解释公式背后的思想}

---

## 四、深层原理

### 4.1 为什么这样设计

{概念}之所以采用{当前的设计/定义/方法}，是因为：

1. **{设计理由1}**：{详细解释，包括历史背景和技术约束}
2. **{设计理由2}**：{详细解释}
3. **{设计理由3}**：{详细解释}

> 如果不这样设计，会面临{什么问题}。

### 4.2 数学/形式化表述（如适用）

{给出概念的严格数学定义或形式化描述}

- **前提假设**：{列出形式化表述成立的条件}
- **核心定理/性质**：{列出关键性质及其含义}
- **推导路线**：{简要说明从假设到结论的推导思路}

### 4.3 边界条件与局限

{概念}并非万能，它有以下边界和局限：

| 局限 | 具体表现 | 应对方法 |
|------|---------|---------|
| 局限1 | {在什么情况下失效} | {替代方案或改进方向} |
| 局限2 | {适用范围的限制} | {替代方案或改进方向} |
| 局限3 | {性能/效果的天花板} | {替代方案或改进方向} |

---

## 五、应用场景

### 5.1 典型应用

| 应用领域 | 具体场景 | 使用方式 | 效果 |
|---------|---------|---------|------|
| 领域1 | {场景描述} | {如何使用概念} | {带来的收益} |
| 领域2 | {场景描述} | {如何使用概念} | {带来的收益} |
| 领域3 | {场景描述} | {如何使用概念} | {带来的收益} |

### 5.2 实际案例

#### 案例1：{案例名称}

- **背景**：{案例的业务/技术背景}
- **问题**：{面临的具体问题}
- **如何应用{概念}**：{具体的应用方式}
- **结果**：{量化或定性的效果}
- **来源**：{案例出处}

#### 案例2：{案例名称}

- **背景**：{案例的业务/技术背景}
- **问题**：{面临的具体问题}
- **如何应用{概念}**：{具体的应用方式}
- **结果**：{量化或定性的效果}
- **来源**：{案例出处}

---

## 六、常见误区与FAQ

### 常见误区

| 误区 | 正确理解 |
|------|---------|
| {误区1：常见的错误认知} | {正确的理解，以及为什么会产生这个误区} |
| {误区2：常见的错误认知} | {正确的理解，以及为什么会产生这个误区} |
| {误区3：常见的错误认知} | {正确的理解，以及为什么会产生这个误区} |

### FAQ

**Q1: {概念}和{易混淆概念}有什么区别？**

A: {清晰的区分说明，附对比表格（如需要）}

**Q2: {关于概念的常见问题}？**

A: {准确的回答}

**Q3: 什么情况下应该/不应该使用{概念}？**

A: {使用决策指南}

---

## 七、延伸阅读

### 入门资源
- {资源1}：{简要说明为什么推荐}
- {资源2}：{简要说明为什么推荐}

### 进阶资源
- {资源3}：{简要说明为什么推荐}
- {资源4}：{简要说明为什么推荐}

### 权威参考
- {资源5}：{简要说明为什么推荐}
- {资源6}：{简要说明为什么推荐}

---

## 附录：术语表

| 术语 | 英文 | 定义 | 首次出现章节 |
|------|------|------|------------|
| {术语1} | {English} | {简要定义} | {章节编号} |
| {术语2} | {English} | {简要定义} | {章节编号} |
| {术语3} | {English} | {简要定义} | {章节编号} |
```

---

## 7) 执行流程图

```
用户: "帮我由浅入深解释 {概念}"
          ↓
┌─────────────────────────────────────────────────────────────┐
│                    主 Agent 执行                              │
├─────────────────────────────────────────────────────────────┤
│ 1. todo_write: 分解任务为 9 个子任务                          │
│                                                             │
│ 【资料获取 Module A】                                        │
│ 2. A1-权威定义                                               │
│    ├─ web_search: "{概念} 定义 含义"                          │
│    ├─ web_search: "{concept} definition"                     │
│    └─ knowledge_answer: 内部知识库检索                        │
│                                                             │
│ 3. A2-原理与机制                                             │
│    ├─ web_search: "{概念} 原理 工作机制 how it works"         │
│    └─ fetch: 权威教程/百科页面全文阅读                        │
│                                                             │
│ 4. A3-类比与图示素材                                         │
│    ├─ web_search: "{概念} 类比 比喻 通俗解释"                │
│    └─ 准备 aily-diagram 输入（结构图/流程图/关系图）          │
│                                                             │
│ 5. A4-历史与演进                                             │
│    └─ web_search: "{概念} 历史 演进 发展"                    │
│                                                             │
│ 6. A5-应用与案例                                             │
│    └─ web_search: "{概念} 应用 案例 实际场景"                │
│                                                             │
│ 7. A6-常见误区                                               │
│    └─ web_search: "{概念} 常见误解 误区 FAQ"                 │
│                                                             │
│ 【结构化分析 Module B】                                      │
│ 8. B1-确定讲解层次: 直觉层→机制层→形式化层→权衡层            │
│ 9. B2-构建类比体系: 主类比+补充类比+反面类比                  │
│ 10. B3-整理公式/模型（如适用）                                │
│ 11. B4-梳理概念关系图谱                                      │
│                                                             │
│ 12. 所有素材写入 draft.md                                    │
│                                                             │
│ 13. task(writer): 分发写作任务                               │
└─────────────────────────────────────────────────────────────┘
          ↓
┌─────────────────────────────────────────────────────────────┐
│                    Writer Agent 执行                         │
├─────────────────────────────────────────────────────────────┤
│ 1. file_read: 读取 draft.md                                  │
│          ↓                                                  │
│ 2. outline_generator: 基于素材+模板生成结构化大纲             │
│          ↓                                                  │
│ 3. feishu_doc_create: 按大纲生成飞书云文档                    │
│    ├─ 按四层递进结构填充内容                                  │
│    ├─ 插入 aily-diagram 图示                                 │
│    ├─ 套用可读性规则格式化                                    │
│    └─ 标注所有来源引用                                       │
│          ↓                                                  │
│ 4. end: 返回飞书云文档链接                                    │
└─────────────────────────────────────────────────────────────┘
          ↓
      飞书云文档概念解析
```

---

## 8) Checklist

### 主 Agent - 资料获取检查项（Module A）
- [ ] A1-权威定义：至少获取 2 个权威来源的定义
- [ ] A1-权威定义：中英文双语检索已执行
- [ ] A1-权威定义：knowledge_answer 内部知识已检索
- [ ] A2-原理与机制：核心工作原理已明确
- [ ] A2-原理与机制：关键步骤/流程已梳理
- [ ] A2-原理与机制：至少 1 个权威页面已 fetch 全文阅读
- [ ] A3-类比素材：至少收集 3 个候选类比
- [ ] A3-图示规划：至少规划 1 张图示（结构图/流程图/关系图）
- [ ] A4-历史演进：起源与关键里程碑已记录
- [ ] A5-应用案例：至少 2 个典型应用场景 + 1 个实际案例
- [ ] A6-常见误区：至少 3 个常见误区/误解已收集
- [ ] A6-易混淆概念：至少 1 组易混淆概念对比已完成
- [ ] 所有数据/定义已标注来源

### 主 Agent - 结构化分析检查项（Module B）
- [ ] B1-讲解层次已确定（直觉层/机制层/形式化层/权衡层的深度分配）
- [ ] B2-类比体系已构建（主类比+补充类比，局限性已标注）
- [ ] B3-公式/模型已整理（如适用），每个公式附自然语言翻译
- [ ] B4-概念关系图谱已梳理（上位/下位/并列/前置/替代）
- [ ] draft.md 已完整写入所有素材

### Writer Agent 检查项
- [ ] TL;DR 简洁有力（一句话定义 + 为什么重要）
- [ ] 四层递进结构完整（直觉 → 机制 → 形式化 → 权衡）
- [ ] 生活类比至少 1 个，且标注了局限性
- [ ] 图示至少 1 张，且有图示解读文字
- [ ] 公式/模型附带自然语言翻译（如适用）
- [ ] 易混淆概念有明确对比表
- [ ] 常见误区至少 3 条
- [ ] 所有定义和数据标注来源
- [ ] 术语表完整
- [ ] 可读性规则已遵守（列表/拆段/Callout）
- [ ] 已成功转换为飞书云文档

---

## 9) 常见失败模式与修复

| 失败模式 | 原因 | 修复方法 |
|---------|------|---------|
| 定义不准确 | 仅依赖二手博客，未查权威来源 | 必须引用教科书/官方文档/标准组织的定义，至少 2 个权威来源交叉验证 |
| 层次不递进 | 所有内容平铺在同一深度 | 严格按直觉层→机制层→形式化层→权衡层组织，每层的目标读者和表达方式不同 |
| 类比误导 | 类比不准确或未标注局限 | 每个类比必须经过"准确性检查"，并明确写出"这个类比在哪里会失效" |
| 公式裸写 | 只写公式不解释 | 每个公式必须附带自然语言翻译、符号定义和直觉解释 |
| 概念边界模糊 | 未与易混淆概念做对比 | 必须至少做 1 组易混淆概念对比表，明确"是什么"和"不是什么" |
| 只有理论无案例 | 缺少应用场景和实际案例 | A5 步骤必须执行，至少 2 个典型场景 + 1 个实际案例 |
| 深度不足 | 只停留在表面定义 | 检查是否完成了"原理与机制"和"深层原理"部分，确保回答了"为什么"而不只是"是什么" |
| 来源缺失 | 定义和数据未标注出处 | 强制格式：每个定义/数据后必须跟（来源：{名称}），无来源的内容标注"需补充资料" |
| 内部视角缺失 | 未查 knowledge_answer | A1 步骤中必须执行 knowledge_answer 检索，补充内部视角 |
| 图示缺失 | 未使用 aily-diagram | A3 步骤必须规划至少 1 张图示，Writer Agent 必须插入 |