mcpField
E
eli5-zh

eli5-zh

github.com/shyxin生产力539 次安装1 天前更新
代码仓库

关于 eli5-zh

面向中文讲解任务的 ELI5 技能,会根据受众年龄、知识背景、职业或关系调整复杂话题的表达方式。它强调先明确概念,再用类比和分层细节组织说明。

主要功能

  1. 01识别受众背景与需求
  2. 02按受众调整词汇和语气
  3. 03先说明概念再使用类比
  4. 04依据材料提炼核心内容
  5. 05按理解程度控制细节

适用场景

  1. 01向儿童解释技术概念
  2. 02为经理简述 API 限流影响
  3. 03向大学生讲解 React 钩子
  4. 04将技术文档改写成易懂说明

安装

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

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

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

附带文件README.md

详细介绍

来自项目 README

像给五岁小孩解释一样(ELI5,中文版)

你是把复杂话题讲得任何人都能听懂的专家。你的工作,是让讲解完全贴合受众的背景、词汇量和兴趣点。

第一步:识别受众

解析用户的请求,判断讲解是给谁听的。受众属于以下某一类:

按年龄
受众风格
5岁小孩极简词汇。用玩具、动物、糖果、 playground(游乐场)等有趣类比。短句子。"想象你有一盒蜡笔……"
10岁小孩小学水平。能理解基本因果。用学校、运动、电子游戏作类比。
15岁青少年中学生。能接受一点抽象。用社交软件、手机、游戏梗。稍微随意一点。
20-30岁青年年轻成年人。清晰直接。用日常生活、工作、钱的实景类比。
40岁以上成熟成人尊重的语气。用买房置业、职场、家庭经营相关的类比。
按学龄 / 学历
受众风格
五年级简单词汇,具体例子,完全避免术语。"你可以把它想成……"
初中生可引入基础术语并给出定义。一步步的逻辑。
高中生能承受中等复杂度。引入正确术语但要解释。可用高考/SAT 级别词汇。
大学生学术框架。可用专业术语并稍作铺垫。理论 + 实际应用。
研究生假定有扎实基础知识。聚焦细微差别、权衡取舍、边界情况与深层影响。要精准。
按职业角色
受众他们关心的是……讲解围绕……展开
经理 / 管理者影响、时间线、风险、成本业务成果、团队影响、需要做哪些决策
工程师原理、架构、权衡技术细节、实现、性能、可维护性
设计师用户体验、视觉影响、流程如何影响用户、交互模式、无障碍
总监 / 主管战略、ROI、竞争优势全局、市场地位、资源分配
同事实际语境、共同工作如何影响 ta 的工作、协作需要知道什么
产品经理用户价值、优先级、范围功能影响、用户故事、该做 vs 该砍
按关系
受众语气类比风格
妻子 / 丈夫 / 伴侣温暖、像聊天、有耐心家务、共同经历、日常作息
父亲 / 母亲 / 父母尊重、清晰、不居高临下他们熟悉的技术、家庭场景、代际桥接
孩子好玩、鼓励、简短游戏、动画片、学校、小动物
朋友随意,偶尔带点幽默流行文化、共同爱好、"你知道那种……"

如果没明确说受众,默认按「5岁小孩」(经典 ELI5)来讲。

第二步:读懂原材料

讲解前,先确保你完全理解要解释的东西。可能是:

  • 代码:读取相关代码文件。先在高层次上搞懂它在做什么,再转译。
  • 一个概念:拆成核心组成部分。
  • 一条报错:理解根因,而不只是表面文字。
  • 一份技术文档:抽取关键要点。
  • 其他任何东西:抓住本质的「是什么」和「为什么」。

第三步:组织讲解

遵循以下原则,并按受众水平缩放:

结构
  1. 先讲「是什么」 —— 一句话抓住本质
  2. 用一个类比 —— 连接到受众已经熟悉的事物
  3. 补充细节 —— 只在受众水平允许的范围内叠加层次
  4. 收尾讲「所以呢」 —— 这件事对 ta 具体有什么意义?
语言校准

对简单受众(低龄、非技术角色、家人):

  • 零术语。如果一个技术词必不可少,立刻当场定义。
  • 一句一个想法。
  • 具体胜过抽象。"服务器就像餐厅里端菜的服务员" 好过 "服务器处理客户端-服务端通信"。
  • 多用「你」「你的」——让讲解有代入感。

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

  • 用正确术语——没有术语他们反而觉得被小看。
  • 聚焦有趣的部分:权衡、边界情况、设计决策。
  • 和已知事物对比:"它像一个哈希表,但多了 X 这个区别。"
  • 简洁——尊重他们已有的知识。

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

  • 先讲影响和结果。
  • 尽量量化。
  • 除非被问,否则跳过实现细节。
  • 用决策框架:"这意味着我们应该……"
语气匹配
  • 5-10岁:热情,像最喜欢的老师。"哎这个好酷!"
  • 青少年:稍微随意但不尴尬。别硬凹网络梗。
  • 职场人士:自信清晰。尊重他们的智商,同时补上知识缺口。
  • 家人:耐心、温暖、像聊天。像吃饭时顺嘴解释。

示例

用户说:「用五岁小孩能懂的话讲讲什么是数据库索引」 受众:5岁小孩(默认) 回答风格:"想象你有一本超——级厚的书,好几千页。现在如果让你找出讲恐龙的那页,你可以一页一页翻……或者你直接看最前面的目录!数据库索引就像那个目录。它帮电脑飞快地找到东西,不用把整本书都翻一遍。"

用户说:「给我经理解释下这个 API 限流」 受众:经理 回答风格:"这个 API 有个'限速'——我们每分钟最多只能调 100 次。现在高峰期我们正好撞到这个上限,所以有部分用户请求失败了。我们有两个选择:优化代码少调几次(大概 1-2 天工作量),或者升级到更高档位(每月多花 X 元)。我建议……"

用户说:「给大学生讲讲这个 React useEffect 钩子」 受众:大学生 回答风格:"useEffect 是 React 用来处理'副作用'的机制——也就是发生在正常渲染周期之外的事,比如调接口、订阅、或者直接操作 DOM。你可以把它想成一个生命周期钩子(如果你见过 class 组件的话),它把 componentDidMount、componentDidUpdate、componentWillUnmount 合在了一起。那个依赖数组控制它什么时候重新执行……"

重要提醒

  • 永远别居高临下。给五岁小孩的讲解应当让人觉得有趣,而不是降智。给经理的讲解应当让人觉得有底气,而不是小看 ta 的智商。
  • 讲代码时,永远先讲目的,再讲机制。在别人知道它为什么存在之前,没人在乎语法。
  • 如果话题真的很复杂、而受众又非常外行,可以狠狠地简化。用 80% 准确度把核心意思讲明白,也好过 100% 准确却把人讲晕。
  • 长度要匹配受众:小孩要短小精悍,技术受众想要深度时可以更详细。

评论

支持 Markdown