关于 eli5
eli5 是一种用于清晰解释内容的通俗语言风格技能。它帮助助手按请求选择表达形式并保留技术标识;除非用户要求持续使用,否则风格仅适用于当前请求。
主要功能
- 01采用直白易懂的解释
- 02保留准确的技术细节
- 03选择合适的回答形式
- 04单次风格请求不延续
- 05将文档等格式交由相关技能处理
适用场景
- 01用通俗语言解释技术概念
- 02回应单次 ELI5 请求
- 03在文字说明与图示间选择
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mblode/ agent-skills --skill eli5安装后在 Claude Code 中输入/eli5确认已加载。
附带文件evals/evals.jsonreferences/formats.md
详细介绍
通俗语言写作风格
- **不适用于:**产品文案或文档(使用
ghostwriter),也不适用于幻灯片(使用presentation-creator)。
解释时请采用此风格。只有当用户要求持续采用这种模式时,才在后续回复中继续使用;单次 ELI5 请求不会永久改变会话风格。
- 保留准确的标识符、路径、命令、错误、数字和引用的源文本,并围绕它们进行解释。
- 避免弱化语气的词语:只不过、显然、仅仅、容易、当然、如你所知。
- 在撰写的文字中不要使用 em dash,也不要用两侧带空格的连字符代替。对于宣传性词汇和其他机器写作痕迹,请检查
ghostwriter/references/tells.md,这是该集合唯一的列表;字面意义上的技术用法和引文除外。 - 只有在类比能阐明机制时才使用类比;如果类比的局限会影响答案,请指出。解释没有说清楚时,请换一种表述方式,而不是把同一个类比说得更长。
- 先给出解释或结果。只有读者需要采取行动时才提供下一步。不要把 Agent 已获授权完成的工作交给用户。
只返回解释本身。不要宣布已启用该风格,不要限定句子数量,不要强制总结,也不要在发送前列检查清单。
选择形式
默认使用散文。用户指定形式,或内容的结构难以用散文表达时,再选择更高一级的形式。每升一级,撰写和检查成本都会增加,因此选择足以表达意思的最低一级形式。
| 形式 | 适用情况 | 成本 |
|---|---|---|
| 普通散文 | 大多数回答 | 无 |
| 受控英语 | 用户要求 STE100 或“简化技术英语”,或者答案是非母语读者需要遵循的流程或复杂机制 | 无 |
| 图示 | 部件及其关联、随时间展开的序列、状态或数据路径 | 低 |
| HTML 页面 | 读者需要通过更改输入并查看结果来学习,或主题需要多个相互关联的视图 | 中 |
| 解释视频 | 用户要求视频,或主题涉及动态过程(例如算法逐步运行、曲线变化) | 高:渲染、旁白、审阅 |
用户指定形式时,请使用该形式;不要劝用户改用散文。自行选择形式时,未经询问不得使用图示以上的形式;只有在明显有帮助时,才用一行提供下一级形式。
“80% STE100”、“soft STE100”或类似表述,指的是 references/formats.md 中的宽松配置文件,而不是完整规范。图示、HTML 和视频的制作方法(工具选择、旁白键、审阅步骤)也在同一文件中;制作普通散文以外的形式前,请先加载该文件。
边界
这些规则适用于助手的文字表达及其撰写的解释。产品文案、技术文档和 README 结构由 ghostwriter 负责,PR 正文由 pr-creator 负责,幻灯片由 presentation-creator 负责,数据图表则由已安装的 dataviz 技能(如有)负责。
维护
evals/evals.json 包含用于评估此技能行为和路由场景的内容;撰写解释时不要加载它。
评论
支持 Markdown