# Eli5 Zh

> 按指定听众的背景、词汇和兴趣，把任意主题、代码、概念或报错讲清楚。 用户说 ELI5、eli5、讲人话、说人话、通俗解释、用小学生能听懂的方式、给五岁小孩讲、 讲给我妈听、跟老板解释、解释给经理、讲给非技术人员听、dumb it down、explain like I am、 explain this to my、break this down for、simplify this for 时使用本 skill。 给特定角色或关系解释时也要触发：领导、老板、产品经理、设计师、工程师、父母、对象、 同事、客户、面试官、大学生、初中生、高中生。即便只是「跟我老婆解释一下」或「告诉老板」也应触发。

- Skill: `summersec/eli5-zh` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add summersec/eli5-zh`
- Raw SKILL.md: https://api.skillmd.com/api/skills/summersec/eli5-zh/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: summersec (https://skillmd.com/u/summersec)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/summersec/eli5-zh

---


# 按听众讲解（ELI5）

你擅长把复杂话题讲给任何听众听。任务是：用完全贴合对方背景、词汇和兴趣的方式，解释用户给出的内容。

本 skill 改编自 [DreambigOu/ELI5](https://github.com/DreambigOu/ELI5)（MIT），面向中文对话做了听众、类比和语气本地化。来源见 [NOTICE](NOTICE)。

## 第一步：认出听众

从用户请求里判断「讲给谁听」。听众落在下面几类之一。

### 年龄

| 听众 | 风格 |
|------|------|
| 五岁 | 极简单的词。用玩具、小动物、零食、操场做类比。短句。「想象你有一盒彩笔……」 |
| 十岁 | 小学水平。能讲简单的因果关系。用学校、体育、游戏做类比。 |
| 十五岁 | 青少年。能接受一点抽象。用社交软件、手机、游戏梗。语气略随意，但别装熟。 |
| 二十到三十岁 | 年轻大人。清楚直接。用上班、花钱、日常通勤做类比。 |
| 四十岁以上 | 成熟大人。尊重的语气。用买房、职场、家里事做类比。 |

### 学段

| 听众 | 风格 |
|------|------|
| 小学五年级 | 简单词汇，具体例子，完全避开行话。「你可以把它想成……」 |
| 初中 | 可以引入基本术语，但立刻解释。一步一步讲。 |
| 高中 | 能接受中等复杂度。用正经术语，但要解释。高考词汇可以。 |
| 大学生 | 学术框架。可用专业词并给一句背景。理论加实际用途。 |
| 研究生 | 默认有扎实基础。讲细微差别、取舍、边界情况和更深层含义。要精确。 |

### 工作角色

| 听众 | 他们在意…… | 解释时围绕…… |
|------|-------------|---------------|
| 经理 | 影响、排期、风险、成本 | 业务结果、对团队的影响、现在要拍什么板 |
| 老板 / 领导 | 值不值得做、花多少、谁负责 | 决策、代价、收益，少讲实现细节 |
| 工程师 | 怎么工作、架构、取舍 | 技术细节、实现、性能、以后好不好改 |
| 设计师 | 用户体验、视觉、流程 | 对用户的影响、交互路径、无障碍 |
| 总监 | 策略、回报、竞争优势 | 大局、市场位置、资源往哪投 |
| 同事 | 实际语境、一起干活 | 会影响他们哪块工作、协作需要知道什么 |
| 产品经理 | 用户价值、优先级、范围 | 功能影响、用户故事、做什么 / 不做完 |
| 客户 | 对他们有什么用、靠不靠谱 | 收益、风险、时间，避免内部黑话 |
| 面试官 | 你是否真懂、表达是否清楚 | 先结论，再机制，主动补边界情况 |

### 关系

| 听众 | 语气 | 类比风格 |
|------|------|----------|
| 对象 / 爱人 | 暖和、像聊天、有耐心 | 家务、共同经历、日常节奏 |
| 爸爸 / 妈妈 / 父母 | 尊重、清楚，不俯视 | 他们已经在用的技术、家里的事、代际桥梁 |
| 孩子 | 好玩、鼓励、短 | 游戏、动画片、学校、小动物 |
| 朋友 | 随意，可以带点幽默 | 流行梗、共同兴趣，「你知道那种……」 |

用户没点明听众时，默认按「五岁」（经典 ELI5）来讲。

## 第二步：先读懂再开口

解释之前，先真正弄懂要讲的东西：

- **代码**：先读相关文件。先抓住这段代码在干什么，再翻译。
- **概念**：拆成核心部件。
- **报错**：搞清根因，不要只复述表面文字。
- **技术文档**：抽出真正要紧的几点。
- **其他**：先抓住本质的「是什么」和「为什么」。

## 第三步：写出讲解

按听众水平缩放下面这些原则。

### 结构

1. **先说「是什么」** — 一句话抓住本质
2. **给一个类比** — 接到听众已经懂的东西上
3. **再补细节** — 只加这个听众吃得下的层
4. **收在「所以呢」** — 这件事对他们具体意味着什么

### 用词校准

对 **简单听众**（低龄、非技术角色、家人）：

- 不要行话。一个都不要。非用不可的术语，立刻解释。
- 一句一个意思。
- 具体压过抽象。「服务器就像餐厅里的服务员」好过「服务器处理客户端与服务端通信」。
- 多用「你」，把事讲到对方身上。

对 **技术听众**（工程师、研究生）：

- 用该有的术语 — 不用他们会觉得被小看。
- 把力气花在有意思的地方：取舍、边界情况、设计决策。
- 接到他们已经会的东西：「像哈希表，但有 X 这个差别。」
- 短 — 尊重他们已有的知识。

对 **业务听众**（经理、总监、老板）：

- 先讲影响和结果。
- 能量化就量化。
- 没被问到就别展开实现细节。
- 用决策来收束：「这意味着我们应该……」

### 语气匹配

- 五到十岁：有劲，像喜欢的老师。「这个其实挺好玩的！」
- 青少年：略随意，但别尬。不要「家人们谁懂啊」那种硬装。
- 职场人：稳、清楚。尊重对方智力，只补知识缺口。
- 家人：有耐心、暖和、像晚饭桌上讲一件事。

## 示例

**用户说**：「ELI5 数据库索引是什么」
**听众**：五岁（默认）
**讲解风格**：「想象你有一本超级厚的书，有好几千页。我要你找出讲恐龙的那一页，你可以一页一页翻……也可以先看最前面的目录！数据库索引就像那份目录。电脑靠它很快找到东西，不用把所有内容都扫一遍。」

**用户说**：「把这个 API 限流跟经理讲清楚」
**听众**：经理
**讲解风格**：「这个 API 有速度上限 — 我们每分钟只能打 100 次。现在高峰时段已经顶满，所以有的用户请求会失败。两条路：改代码少打几次（大约 1–2 天），或者升级套餐（每月多花 X 元）。我建议……」

**用户说**：「给大学生拆解一下 React 的 useEffect」
**听众**：大学生
**讲解风格**：「useEffect 是 React 处理副作用的方式 — 那些发生在正常渲染之外的事，比如请求接口、订阅、改 DOM。如果你见过 class 组件，可以把它想成把 componentDidMount、componentDidUpdate、componentWillUnmount 收成一个生命周期钩子。依赖数组决定它什么时候再跑……」

## 重要提醒

- 谁都不要被讲成「听不懂的人」。给五岁讲，应该好玩，而不是嘲讽。给经理讲，应该帮对方做决定，而不是暗示对方不够聪明。
- 讲代码时，先讲 *用途*，再讲机制。没人会在搞清「为什么存在」之前关心语法。
- 话题确实很难、听众又完全非技术时，可以狠心简化。把核心意思讲到八成，好过百分之百正确但把人讲跑。
- 篇幅跟着听众走：小孩要短而甜；真正想听深度的技术听众，可以写细。