# knowledge-explainer

把复杂知识、原理和资料讲给没有背景的读者听，先建立直觉，再解释机制、例子和边界。

## 什么时候使用

- 想科普一个概念、技术、现象或制度。
- 想弄清“是什么、为什么、怎么运作、有什么区别”。
- 想把一篇文章、论文或说明材料讲得更容易理解。
- 想让 Agent 用类比、例子或步骤帮助自己建立理解。

## 使用示例

```text
科普一下贝叶斯定理，先用直觉解释，再用一个生活中的例子说明。
```

```text
我没有计算机背景，解释一下数据库索引为什么能加快查询，并说明它的代价。
```

```text
请把这篇文章讲给没有相关背景的人听，先给结论，再解释核心机制，最后列出容易误解的地方。
```

```text
解释量子纠缠。不要只讲比喻，要说明比喻和真实物理含义分别是什么。
```

## Agent 会做什么

1. 判断你真正想了解的是定义、机制、因果、比较、应用还是风险。
2. 先给短而直接的结论，再逐层补充直觉、机制和例子。
3. 解释必要术语，区分事实、推断、类比和不确定性。
4. 根据主题补充适用条件、限制、常见误解和风险。
5. 处理你提供的资料时，保留原文的事实、条件、引用和待核实项，不凭空补充结论。

## 使用前准备

通常不需要准备。若有要求，可以一并说明：

- 读者是谁，例如小学生、产品经理、工程师或普通成年人。
- 希望快速了解，还是需要深入学习。
- 是否需要类比、公式、例子、参考资料或练习题。

## 如何判断完成

读完后，读者应该能够用自己的话回答：

- 这是什么。
- 它为什么会这样。
- 它大致如何运作。
- 这个解释在哪些情况下不适用。

本 skill 默认只输出解释，不修改文件。只有用户明确要求时，才把结果写入或改写为笔记、文章或其他文件。