mcpField
E
eli5

eli5

github.com/mblode生产力173335 次安装今天更新
代码仓库

关于 eli5

eli5 是一种用于清晰解释内容的通俗语言风格技能。它帮助助手按请求选择表达形式并保留技术标识;除非用户要求持续使用,否则风格仅适用于当前请求。

主要功能

  1. 01采用直白易懂的解释
  2. 02保留准确的技术细节
  3. 03选择合适的回答形式
  4. 04单次风格请求不延续
  5. 05将文档等格式交由相关技能处理

适用场景

  1. 01用通俗语言解释技术概念
  2. 02回应单次 ELI5 请求
  3. 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