Menu
概念解释：由浅入深讲清概念的定义、原理与本质，面向不同知识背景的读者。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
文档创作年度报告：主要借助 `aily-doc` 获取用户年度文档信息（数量、点赞、评论、PV、UV 等），并基于这些指标与代表性文档产出年度总结型飞书云文档。
商业计划书：强调市场机会、产品与商业模式、竞争、团队、财务与风险，形成可评审BP。
季度/年度业务汇报：围绕指标达成、业务进展、问题与对策输出结构化业务汇报。
公司调研：基于官方与公开信息输出公司概况、业务结构、竞争位置、经营与风险的结构化研究。
竞品分析：通过统一维度对比产品与市场信息，形成结构化对比结论与机会点。
基于飞书群聊的**智能摘要与洞察**生成能力。从指定群聊/时间范围的消息中提取关键信息，识别决策、行动项、风险，生成**飞书云文档结构化摘要**。
| name | aily-doc-concept-explainer |
| label | 概念解释 |
| description | 概念解释：由浅入深讲清概念的定义、原理与本质，面向不同知识背景的读者。 |
概念解释：由浅入深讲清概念的定义、原理与本质，面向不同知识背景的读者。适用于：用户希望彻底理解某个概念/术语/技术/理论，从直觉层到形式化层逐步深入，同时配合类比、图示、案例等多维度辅助理解。
task（subagent_type: writer）委托 Writer Agent 创建飞书云文档。feishu-use-skills-map 并按其指引调用对应技能get_skills 获取对应飞书技能说明feishu-use-skills-map 并调用对应技能| 工具 | 用途 | 适用场景 |
|---|---|---|
knowledge_answer | 检索内部知识库 | 公司内部对该概念的定义、使用惯例、内部文档 |
web_search | 广泛检索公开信息 | 权威定义、原理解释、类比素材、历史演进、应用案例、常见误区 |
fetch | 获取特定网页/文档全文 | 深入阅读权威教程、百科页面、技术博客、学术资料 |
aily-diagram | 生成流程图/结构图/关系图 | 概念关系图谱、工作流程图、层次结构图、对比图 |
file | 将素材写入 draft.md（append 模式） | 每个数据步骤完成后 |
当用户出现以下意图时触发本 skill：
主 Agent 收到概念解释请求后，使用 todo_write 分解任务：
{
"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"}
]
}
核心原则：优先使用飞书工具获取内部知识，再用外部检索补充权威公开信息。每一步检索完成后，将结构化结果写入
draft.md，供后续 Writer Agent 使用。
目标：获取概念最权威、最准确的定义，确保后续所有解释建立在正确的基础上。
web_search 查询（中英文双语检索）：
- "{概念} 定义 含义"
- "{概念} 是什么 解释"
- "{concept} definition"
- "{concept} meaning explanation"
knowledge_answer 查询（内部知识库）：
knowledge_answer(
query_list: [
"{概念} 的定义和含义",
"公司内部如何定义 {概念}",
"{概念} 相关的内部文档和规范"
],
explanation: "检索内部知识库中对该概念的定义、使用惯例和相关文档"
)
来源优先级：
写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：
## A1. 权威定义
### 核心定义
- 定义1（来源：{教科书/论文/标准}）：...
- 定义2（来源：{官方文档}）：...
### 词源与命名由来
- 该概念的英文名/中文名的由来：...
- 命名背后的隐喻或思路：...
### 内部定义（如有）
- 公司内部对该概念的使用惯例：...
- 与通用定义的差异（如有）：...
目标：获取概念背后的工作原理、核心机制和关键步骤，理解"它是怎么运作的"。
web_search 查询：
- "{概念} 原理 工作机制"
- "{概念} 工作原理 流程"
- "{concept} how it works"
- "{concept} mechanism principle"
- "{概念} 核心算法 核心方法"
fetch 深度阅读（对检索到的权威教程/百科进行全文阅读）：
fetch(
url: "{权威教程/技术文档/百科页面URL}",
prompt: "提取该页面中关于 {概念} 的工作原理、核心机制、关键步骤和技术细节"
)
写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：
## A2. 原理与机制
### 核心机制
- 该概念的核心工作原理：...（来源：{URL}）
### 关键步骤/流程
1. 步骤1：...
2. 步骤2：...
3. 步骤3：...
### 关键公式/模型（如适用）
- 公式1：... （含义：...）
- 公式2：... （含义：...）
### 技术细节
- 前置条件/假设：...
- 核心约束：...
- 输出/结果：...
目标：收集用于直观理解的类比、比喻和可视化素材，降低读者的认知门槛。
web_search 查询：
- "{概念} 类比 比喻 通俗解释"
- "{概念} 用一句话解释"
- "{concept} analogy metaphor"
- "{concept} explained simply"
- "{concept} for beginners"
准备 aily-diagram 的输入： 根据检索到的原理与机制信息，准备以下类型的图示请求：
写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：
## A3. 类比与图示素材
### 生活类比候选
- 类比1：{概念}就像{生活事物}，因为...（来源：{URL}）
- 类比2：{概念}可以理解为{日常场景}，其中...（来源：{URL}）
- 类比3：如果把{概念}比作{具体事物}，那么...（来源：{URL}）
### 类比评估
| 类比 | 覆盖维度 | 局限性 | 推荐度 |
|------|---------|--------|--------|
| 类比1 | 解释了XX方面 | 未覆盖YY | 高/中/低 |
| 类比2 | 解释了XX方面 | 未覆盖YY | 高/中/低 |
### 图示规划
- 图1（结构图）：展示{概念}的组成部分 → aily-diagram 输入描述
- 图2（流程图）：展示{概念}的工作流程 → aily-diagram 输入描述
- 图3（关系图）：展示{概念}与{相关概念}的关系 → aily-diagram 输入描述
目标：获取概念的起源、演进历程和关键里程碑，帮助读者理解"为什么会有这个概念"。
web_search 查询：
- "{概念} 历史 演进 发展"
- "{概念} 起源 由来 发明"
- "{concept} history evolution"
- "{concept} origin development timeline"
- "{概念} 版本 迭代 变迁"
写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：
## A4. 历史与演进
### 起源
- 提出时间：...
- 提出者/提出组织：...
- 提出背景与动机：为了解决什么问题？（来源：{URL}）
### 演进时间线
| 时间 | 里程碑事件 | 关键变化 | 来源 |
|------|-----------|---------|------|
| YYYY | 概念首次提出 | ... | {URL} |
| YYYY | 重大改进/新版本 | ... | {URL} |
| YYYY | 广泛采用/标准化 | ... | {URL} |
### 演进驱动力
- 技术驱动：...
- 需求驱动：...
- 范式转移：...
目标：获取概念在实际场景中的应用，帮助读者理解"这个概念有什么用"。
web_search 查询：
- "{概念} 应用 案例 实际场景"
- "{概念} 使用场景 应用领域"
- "{concept} use cases applications"
- "{concept} real world examples"
- "{概念} 最佳实践 best practice"
写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：
## A5. 应用与案例
### 典型应用场景
| 场景 | 描述 | 为什么用该概念 | 来源 |
|------|------|--------------|------|
| 场景1 | ... | ... | {URL} |
| 场景2 | ... | ... | {URL} |
| 场景3 | ... | ... | {URL} |
### 实际案例
#### 案例1：{案例名称}
- 背景：...
- 如何应用{概念}：...
- 效果/结果：...
- 来源：{URL}
#### 案例2：{案例名称}
- 背景：...
- 如何应用{概念}：...
- 效果/结果：...
- 来源：{URL}
### 不适用场景（同样重要）
- 场景X：为什么不适合使用该概念：...
- 场景Y：为什么不适合使用该概念：...
目标：收集关于该概念的常见误解、易混淆点和高频问题，帮助读者避开认知陷阱。
web_search 查询：
- "{概念} 常见误解 误区"
- "{概念} 常见错误 FAQ"
- "{概念} 区别 vs 对比"
- "{concept} common misconceptions"
- "{concept} myths FAQ"
- "{概念} 和 {易混淆概念} 的区别"
写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：
## A6. 常见误区
### 误区清单
| 误区 | 正确理解 | 来源 |
|------|---------|------|
| 误区1：认为{概念}是... | 实际上{概念}是...，因为... | {URL} |
| 误区2：把{概念}和{其他概念}混为一谈 | 两者的核心区别在于... | {URL} |
| 误区3：认为{概念}可以... | 实际上{概念}的边界是... | {URL} |
### 易混淆概念对比
| 维度 | {概念} | {易混淆概念A} | {易混淆概念B} |
|------|--------|-------------|-------------|
| 定义 | ... | ... | ... |
| 侧重点 | ... | ... | ... |
| 适用场景 | ... | ... | ... |
| 关键区别 | ... | ... | ... |
### 高频 FAQ
1. Q: {概念}和{相关概念}有什么区别？
A: ...（来源：{URL}）
2. Q: {概念}的局限性是什么？
A: ...（来源：{URL}）
3. Q: 什么时候应该使用{概念}？
A: ...（来源：{URL}）
核心原则：将 Module A 收集的素材进行结构化整理，形成由浅入深的讲解层次，确保最终文档逻辑清晰、层次分明。
根据概念的复杂度和用户的背景知识，确定四层递进结构：
┌─────────────────────────────────────────────────────────────┐
│ 第四层：权衡层（Trade-off Layer） │
│ - 局限性与边界条件 │
│ - 与替代方案的对比权衡 │
│ - 适用 vs 不适用场景 │
├─────────────────────────────────────────────────────────────┤
│ 第三层：形式化层（Formal Layer） │
│ - 数学公式/模型定义 │
│ - 严格的技术规格 │
│ - 证明/推导（如适用） │
├─────────────────────────────────────────────────────────────┤
│ 第二层：机制层（Mechanism Layer） │
│ - 核心原理与工作流程 │
│ - 关键步骤与因果关系 │
│ - 组成部分与相互作用 │
├─────────────────────────────────────────────────────────────┤
│ 第一层：直觉层（Intuition Layer） │
│ - 一句话定义 │
│ - 生活类比 │
│ - 图示说明 │
└─────────────────────────────────────────────────────────────┘
层次深度决策规则：
从 A3 收集的类比候选中，筛选并构建一套互补的类比体系：
筛选标准：
类比体系结构：
并非所有概念都有公式/模型，但若该概念涉及定量描述，则需整理：
整理规范：
写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：
## B3. 公式/模型整理
### 核心公式
公式1：{LaTeX 或文本表述}
- 自然语言翻译：...
- 符号定义：{符号} = {含义}
- 直觉解释：这个公式告诉我们...
### 公式间关系
公式1 → 公式2：通过{条件/推导}得到...
关系类型标注：
写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：
## B4. 概念关系图谱
### 层次关系
- 上位概念：{大范畴} → 包含 → {概念}
- 下位概念：{概念} → 包含 → {子类型A}、{子类型B}
### 并列关系
- {概念} 与 {并列概念A}：都属于{大范畴}，但{概念}侧重...，{并列概念A}侧重...
- {概念} 与 {并列概念B}：都属于{大范畴}，但...
### 依赖关系
- 前置知识：先理解{前置概念}，再理解{概念}
- 后续学习：理解{概念}后，可进一步学习{后续概念}
### 替代/对立关系
- {概念} vs {替代概念}：解决同一问题，但{概念}用{方法A}，{替代概念}用{方法B}
### 图示请求（aily-diagram）
生成一张以 {概念} 为中心的关系图谱，包含上述所有关系类型。
主 Agent 完成数据收集（Module A）和结构化分析（Module B）后，将所有素材写入 draft.md，然后调用 task 工具分发给 Writer Agent：
{
"description": "生成概念解析飞书云文档",
"prompt": "基于 /home/workspace/draft.md 中的概念解析素材，生成一份由浅入深的飞书云文档概念解析。\n\n要求：\n1. 严格按照概念解析文档模板结构\n2. 四层递进：直觉层 → 机制层 → 形式化层 → 权衡层\n3. 类比必须标注局限性\n4. 公式/模型必须附带自然语言解释\n5. 易混淆概念必须有明确对比\n6. 所有定义和数据标注来源\n\n文档模板见下方。",
"subagent_type": "writer"
}
Writer Agent 收到任务
↓
1. file_read: 读取 /home/workspace/draft.md
↓
2. outline_generator: 基于 draft.md 素材生成结构化大纲
- 输入：draft.md 中的素材 + 概念解析文档模板
- 输出：符合模板的大纲（含每节标题和要点）
↓
3. feishu_doc_create: 基于大纲生成飞书云文档
- 按大纲逐节填充内容
- 插入 aily-diagram 生成的图示
- 套用可读性规则格式化
↓
4. end: 返回飞书云文档链接
# {概念} 解析
> 适合读者：{背景假设，例如"有基础编程经验，但不熟悉分布式系统"}
> 生成时间：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} | {简要定义} | {章节编号} |
用户: "帮我由浅入深解释 {概念}"
↓
┌─────────────────────────────────────────────────────────────┐
│ 主 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: 返回飞书云文档链接 │
└─────────────────────────────────────────────────────────────┘
↓
飞书云文档概念解析
| 失败模式 | 原因 | 修复方法 |
|---|---|---|
| 定义不准确 | 仅依赖二手博客，未查权威来源 | 必须引用教科书/官方文档/标准组织的定义，至少 2 个权威来源交叉验证 |
| 层次不递进 | 所有内容平铺在同一深度 | 严格按直觉层→机制层→形式化层→权衡层组织，每层的目标读者和表达方式不同 |
| 类比误导 | 类比不准确或未标注局限 | 每个类比必须经过"准确性检查"，并明确写出"这个类比在哪里会失效" |
| 公式裸写 | 只写公式不解释 | 每个公式必须附带自然语言翻译、符号定义和直觉解释 |
| 概念边界模糊 | 未与易混淆概念做对比 | 必须至少做 1 组易混淆概念对比表，明确"是什么"和"不是什么" |
| 只有理论无案例 | 缺少应用场景和实际案例 | A5 步骤必须执行，至少 2 个典型场景 + 1 个实际案例 |
| 深度不足 | 只停留在表面定义 | 检查是否完成了"原理与机制"和"深层原理"部分，确保回答了"为什么"而不只是"是什么" |
| 来源缺失 | 定义和数据未标注出处 | 强制格式：每个定义/数据后必须跟（来源：{名称}），无来源的内容标注"需补充资料" |
| 内部视角缺失 | 未查 knowledge_answer | A1 步骤中必须执行 knowledge_answer 检索，补充内部视角 |
| 图示缺失 | 未使用 aily-diagram | A3 步骤必须规划至少 1 张图示，Writer Agent 必须插入 |