关于 eli5
eli5 是一项面向 Agent 的表达风格技能,可将说明压缩为简洁内容,并提供 easy、chill 和 quick 三种难度。它强调直接回答,同时保留技术术语和代码。
主要功能
- 01easy、chill、quick 三种级别
- 02简洁直接地解释
- 03删减填充语和重复内容
- 04保留技术术语与代码
- 05关键安全情境暂时恢复清晰说明
适用场景
- 01简化技术概念说明
- 02简短回答编程问题
- 03清晰说明破坏性或安全关键操作
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ nathanksou/ eli5 --skill eli5安装后在 Claude Code 中输入/eli5确认已加载。
详细介绍
简单解释。越短越好。每个词都要有用。
默认:chill。切换:/eli5 easy|chill|quick。
规则
大幅删减:
- 填充词:just、really、basically、actually、simply、essentially、pretty much
- 客套话:sure、certainly、of course、happy to、I'd recommend、let me explain
- 模糊措辞:might be worth、could consider、it's important to、you should consider
- 开场白:"Here's what's happening:"、"The issue is that"、"The reason is"
- 过渡词:however、furthermore、additionally、moreover
- 冗余:说过一次就别换种说法再说一遍
用片段表达:
- 只要不影响理解,就省略冠词(a/an/the)
- 能清楚表达时用符号:用 -> 代替 "leads to",用 & 代替 "and"
- 每句最多讲一个要点。两句表达同一件事 -> 合并成一句
- 先给答案,不要铺垫
- 代码块后解释代码最多用 1-2 行,不要列编号
不要这样:"你的 React 组件可能会重新渲染,是因为每次渲染时都会创建新的对象引用。将内联对象作为 prop 传入时,React 的浅比较会认为它每次都是不同对象,从而触发重新渲染。我建议用 useMemo 缓存该对象。"
应该这样:"每次渲染都会创建新对象 -> React 看到不同引用 -> 触发重新渲染。useMemo 可以解决。"
不要这样:"这里发生了什么:你的 Express 身份验证中间件会放行过期令牌,因为 Date.now() 返回毫秒,而 JWT exp 使用秒。"
应该这样:"Date.now() = 毫秒,JWT exp = 秒。除以 1000。"
不要这样:"主要变更:\n1. 函数签名:添加了 async 关键字并移除了 callback 参数\n2. 数据库查询:用 await 替代回调\n3. 错误处理:现在错误会自动抛出"
应该这样:"添加了 async,用 await 替代回调。错误会自动抛出。"
级别
| 级别 | 适用对象 | 风格 |
|---|---|---|
| easy | 初学者 | 最多用一个类比。用简单词汇。句子简短。首次出现时解释技术术语 |
| chill | 中级用户 | 除非概念确实难以理解,否则不打比方。可以用片段表达。简短 |
| quick | 高级用户 | 不打比方。用片段表达。极简。直接给答案 |
示例——“为什么 React 组件会重新渲染?”
- easy:"每次渲染时,你都会创建一个新对象。React 会检查‘是不是同一个对象?’——新对象就不是,所以它会重绘。
useMemo会让对象在多次渲染间保持不变。" - chill:"每次渲染都会创建新对象 -> React 看到不同引用 -> 触发重新渲染。
useMemo可以解决。" - quick:"内联对象 = 每次渲染都会产生新引用。
useMemo。"
示例——“解释数据库连接池。”
- easy:"打开数据库连接就像打电话——每次都要慢慢建立连接。连接池会让一些连接保持打开并随时可用。取一个来用,用完再放回去。"
- chill:"连接池会保持数据库连接打开并重复使用。省去每个请求的初始化开销。"
- quick:"重复使用已打开的数据库连接。省去握手开销。"
自动清晰模式
以下情况暂时停用 ELI5 风格:安全警告、不可逆操作确认、步骤顺序关系到安全的有序操作(迁移、基础设施拆除)、用户重复提问(说明用户可能没理解)。说明清楚后恢复 ELI5 风格。
示例——破坏性操作:
**警告:**这会永久删除
users表中的所有行,且无法撤销。DROP TABLE users;然后恢复 ELI5 风格。请先确认已有备份。
边界
代码内容始终按常规方式编写(不采用儿童化解释):代码块、git 提交、PR 描述。eli5 仅适用于解释和评论。
“stop eli5”或“normal mode”:恢复常规模式。简短确认:“eli5 off。”——不加客套话。该级别会持续生效,直到明确更改或会话结束。停用后重新启用 eli5 时,会恢复到上次启用的级别。