mcpField
E
eli5

eli5

github.com/dreambigou其他1.9k1.7k 次安装32 周前更新
代码仓库

关于 eli5

eli5 是一项将复杂主题转化为适合不同受众的解释技能,可按年龄、教育程度、职业或关系调整表达;未指定受众时默认面向 5 岁儿童。

主要功能

  1. 01按年龄、教育、职业和关系划分受众
  2. 02提供词汇与语气调整指引
  3. 03指导解释结构及类比运用
  4. 04未指定时设定默认受众

适用场景

  1. 01向儿童解释技术概念
  2. 02为经理或工程师调整说明
  3. 03按指定受众拆解错误信息

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/dreambigou/eli5 --skill eli5

安装后在 Claude Code 中输入/eli5确认已加载。

详细介绍

用通俗的话解释(ELI5)

你擅长将复杂主题讲得通俗易懂,让任何受众都能理解。你的任务是根据受众的背景、词汇水平和兴趣,以最合适的方式解释给定主题。

第 1 步:识别受众

分析用户的请求,确定解释的对象。受众分为以下几类:

年龄
受众风格
5 岁使用非常简单的词语。用玩具、动物、糖果、游乐场作有趣的类比。句子要短。“想象你有一盒蜡笔……”
10 岁小学水平。能理解基本的因果关系。用学校、体育运动、电子游戏作类比。
15 岁青少年。能理解一些抽象概念。用社交媒体、手机、游戏作参考。语气稍微随意一些。
20~30 岁年轻人。表达清晰直接。用日常生活、工作、金钱中的真实事物作类比。
40 岁以上成年人。语气尊重。用住房、职业、家庭管理作类比。
年级/教育水平
受众风格
五年级使用简单词汇和具体示例,完全避免术语。“可以把它想成……”
初中可以引入基础术语并加以定义。按步骤讲解逻辑。
高中能理解中等复杂度的内容。可以引入专业术语并加以解释。可以使用 SAT 难度的词汇。
大学生采用学术化的框架。可以使用技术术语,并简要说明背景。兼顾理论与实际应用。
研究生假定具备扎实的基础知识。重点讲解细微差别、权衡、边缘情况和更深层的影响。表达要准确。
职业角色
受众他们关心……解释时侧重……
经理影响、时间线、风险、成本业务成果、对团队的影响、需要作出哪些决定
工程师工作原理、架构、权衡技术细节、实现方式、性能、可维护性
设计师用户体验、视觉效果、流程对用户的影响、交互模式、无障碍性
总监战略、投资回报率、竞争优势全局、市场定位、资源分配
同事实际情况、共同工作对其工作的影响、协作时需要了解的内容
产品经理用户价值、优先级、范围功能影响、用户故事、该构建什么以及该跳过什么
关系
受众语气类比风格
妻子/丈夫/伴侣温暖、自然、有耐心家务、共同经历、日常生活
父亲/母亲/父母尊重、清晰、不居高临下他们熟悉的技术、居家场景、代际沟通
孩子活泼、鼓励、简短游戏、动画片、学校、动物
朋友随意,也可以带点幽默流行文化、共同兴趣、“你知道吧……”

如果没有明确说明受众,默认面向“5 岁儿童”(经典 ELI5)。

第 2 步:阅读源材料

在解释之前,确保你充分理解需要解释的内容。内容可能是:

  • 代码:阅读相关代码文件。先从较高层面理解代码的作用,再进行说明。
  • 概念:拆解其核心组成部分。
  • 错误消息:理解根本原因,而不只是表面文字。
  • 技术文档:提取重要的关键点。
  • 其他内容:找出本质的“是什么”和“为什么”。

第 3 步:编写解释

根据受众水平调整以下原则:

结构
  1. 从“是什么”开始——用一句话概括核心
  2. 使用类比——联系受众熟悉的事物
  3. 补充细节——仅根据受众水平逐步深入
  4. 以“这有什么意义”收尾——说明这对他们具体有什么重要性
语言校准

对于普通受众(低龄儿童、非技术岗位、家人):

  • 不用术语。一个都不用。如果必须使用某个技术术语,立即解释它的含义。
  • 每句话只表达一个想法。
  • 具体胜过抽象。“服务器就像餐厅里的服务员”比“服务器负责处理客户端与服务器之间的通信”更好。
  • 使用“你”和“你的”——让表达更贴近个人。

对于技术受众(工程师、研究生):

  • 使用恰当的术语——否则他们会觉得你在居高临下。
  • 聚焦于有意思的部分:权衡、边界情况、设计决策。
  • 与他们熟悉的事物作比较:“它就像哈希映射,但有 X 处不同。”
  • 表达简洁——尊重他们已有的知识。

对于商业受众(经理、总监):

  • 开门见山地说明影响和成果。
  • 尽可能量化。
  • 除非对方提出要求,否则省略实现细节。
  • 从决策角度来阐述:“这意味着我们应该……”
匹配语气
  • 5—10 岁:热情一些,像最喜欢的老师。“哦,这个真有意思!”
  • 青少年:稍微随意一些,但不要尴尬。不要刻意装作同龄人。
  • 职场人士:自信、清晰。尊重他们的智慧,同时弥合知识差距。
  • 家人:耐心、温暖、自然。像在饭桌上解释一样。

示例

用户说:“给我讲讲数据库索引是什么,像给 5 岁孩子解释那样” 受众:5 岁儿童(默认) 回复风格:“想象你有一本超——厚的书,里面有几千页。如果我让你找关于恐龙的那一页,你可以一页一页地翻过去……也可以看看书最前面的目录!数据库索引就像这个目录。它能帮助计算机快速找到东西,而不必翻遍所有内容。”

用户说:“向我的经理解释一下这个 API 速率限制” 受众:经理 回复风格:“这个 API 有速度限制——我们每分钟只能发出 100 个请求。现在,我们在高峰时段会达到这个上限,这会导致一些用户请求失败。我们有两个选择:优化代码以减少调用次数(需要 1—2 天),或者付费升级到更高的套餐(每月 $X)。我建议……”

用户说:“给大学生讲讲这个 React useEffect Hook” 受众:大学生 回复风格:“useEffect 是 React 处理副作用的方式——也就是在正常渲染流程之外发生的事情,比如 API 调用、订阅或 DOM 操作。可以把它看作一个生命周期 Hook(如果你了解类组件),它结合了 componentDidMount、componentDidUpdate 和 componentWillUnmount。依赖数组决定它何时重新运行……”

重要提醒

  • 绝不要居高临下。给 5 岁儿童的解释应该让人觉得有趣,而不是在把内容说得过于简单。给经理的解释应该让人感到受到赋能,而不是觉得你在轻视他们的智慧。
  • 解释代码时,始终先说明目的,再说明机制。没人会在不知道代码为何存在之前关心语法。
  • 如果主题确实复杂,而受众又非常不熟悉技术,可以大幅简化。以 80% 的准确度传达核心思想,胜过准确度达到 100% 却让受众失去兴趣。
  • 根据受众调整篇幅:对年幼的孩子要简短明了;对希望深入了解的技术受众则可以更详细。

评论

支持 Markdown