最新消息:

Fireworks Open ELI5:让 Codex、Claude Code 把复杂系统讲成可交互的“技术故事”

佳软 yeeach 23浏览 0评论

前几天 Claude Code 的工程师 Thariq Shihipar(@trq212) 在 X 上分享:团队里不少人最近常用一个自制技能:输入 /eli5 <想了解的内容>,让模型把答案渲染成一个独立的 HTML 产物,规则很简单——用大图、少文字,把复杂系统讲给一个完全没有背景知识的人听。比起一堆函数名和逐文件走读式的技术解释,一张能展示节点关系、调用路径的图,理解一个陌生代码库或权衡决策要快得多,因此这个帖子很快传播开。

这里 ELI5 是 “Explain Like I’m 5 ” 的缩写,可以参考以前《r/explainlikeimfive,当我是5岁小孩一样给我解释XYZ,用通俗易懂的术语解释万物》。

这个技能被整理成一个正式的 Agent Skill,收进了 anthropic/claude-plugins-community 的 eli5

这个版本的ELI5 其实就是一堆Prompt,SKILL.md 只有 300 多字节,规则假设很简单:读者零背景,产出一个自包含的 HTML 文件,图多字少。没有规定证据来源、没有版本化的数据结构、也没有导出格式。

但如果我想要的不只是”一张说明性的图”,而是每一条结论背后可以点开看证据、可以重放请求路径、还要能导出给不看 HTML 的人呢?

基于此核心需求,烟花社区的烟花老师开源了 Fireworks Open ELI5。

Fireworks Open ELI5:https://github.com/yizhiyanhua-ai/fireworks-open-eli5

 

Fireworks Open ELI5 核心思路是把”讲人话”和”讲证据”这两件事绑在一起做,核心工作流程是:

1. Agent根据用户的问题、目标读者和可用证据,生成一份版本化的 JSON 故事规格(story spec);

2. 一个确定性的渲染器把这份规格编译成一个自包含的 HTML 文件,不联网、不依赖远程字体或资源,可以离线打开;

3. 校验脚本可以反向核对——把渲染结果与规格逐字节比对,确保没有偷偷改动。

 

与官方社区 eli5 插件相比,Fireworks Open ELI5明确提出了几个和”图多字少”式极简风格不同的设计取舍:

  • 真相阶梯:把类比、真实技术机制、注意事项这三层分开呈现,不会让一个简化比喻冒充完整解释。
  • 结论级证据:每个场景可以标注来源状态、原文片段、支持范围,以及一个真实 URL 或明确写出”无法定位来源”。
  • 四种故事语法:概念解释、仓库模块走读、工程权衡、故障复盘,各自有专门的摘要视图和结构校验规则。
  • 失败视角:影响、症状、降级路径、追问和答案揭示被当作解释的一部分,而不是事后补充的附录。
  • 本地导出:PDF、当前场景 PNG、全场景 PPTX、兼容 Pages 的 DOCX,以及可选的原生 .pages 转换——且明确说明原生 Pages 文件不是靠把 DOCX 改后缀伪装出来的。

 

Anthropic 官方社区 eli5 插件 与 Fireworks Open ELI5 对比

 

下一次给别人讲解复杂系统、复杂概念时候,不妨试试 Fireworks Open ELI5 或 Anthropic 官方社区 eli5。

 

发表我的评论
取消评论
表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址