القائمة
概念解释：由浅入深讲清概念的定义、原理与本质，面向不同知识背景的读者。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
文档创作年度报告：主要借助 `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 必须插入 |