feat: add eli5

Port anthropics/claude-plugins-community eli5 into builtin skills as a single-page HTML picture explainer for readers with no background.
2026-09-04 23:15:03 +08:00
parent 4ce08ec89e
commit 17643bc17b
4 changed files with 107 additions and 0 deletions
@@ -0,0 +1,53 @@
+# eli5
+
+用大图少字的单页 HTML，把一个话题讲给完全没背景的人听。
+
+改编自 [anthropics/claude-plugins-community](https://github.com/anthropics/claude-plugins-community) 的 `eli5`。
+
+## 什么时候使用
+
+- `/eli5 DNS 怎么工作`
+- 「像五岁小孩一样解释 RAG」
+- 「画图讲一下这个项目的登录流程」
+- 想要一份能转发的图解，而不是聊天长文
+
+不适合：核对精确规格、安全审计、修代码。那类工作先用 eli5 抓大图，再换别的 skill 或原文档抠细节。
+
+## 使用前准备
+
+- 给出话题。可以是概念（DNS、RAG），也可以是当前项目里的一块（登录、发版）。
+- 想指定输出路径就说一声；不说则写到项目根目录的 `eli5-<话题>.html`。
+
+## 安装
+
+```bash
+pouch add eli5          # 当前项目
+pouch add eli5 -g       # 全局
+```
+
+## 使用示例
+
+```text
+/eli5 DNS 怎么工作
+```
+
+```text
+像五岁小孩一样解释这个仓库的认证是怎么走的。
+```
+
+```text
+eli5 RAG，输出到 docs/eli5-rag.html
+```
+
+## Agent 会做什么
+
+1. 从你的话里取出话题。
+2. 按「读者完全没背景」来讲，而不是装成对幼儿说话。
+3. 写一页自包含 HTML：大图（inline SVG）、极少文字、至少 3 个可见步骤。
+4. 把文件写到约定路径；聊天里只回路径和一句总收束。
+
+## 如何判断完成
+
+- 能用浏览器直接打开那份 HTML，不依赖外网资源。
+- 画面上图大于字；没背景的人能看出「这东西怎么走」。
+- 聊天没有再贴一遍长文解释。
@@ -0,0 +1,52 @@
+---
+name: eli5
+description: >-
+  用大图少字的单页 HTML 把话题讲给完全没背景的人听。Use when the user types
+  /eli5 <topic>, says eli5, 像五岁小孩一样解释, 用小学生能懂的方式讲, 画图解释,
+  or asks for a dead-simple picture explainer of how something works.
+---
+
+# eli5
+
+把话题讲给**完全没背景**的人听。交付物是一页自包含 HTML：大图、少字，不是聊天长文。
+
+改编自 [anthropics/claude-plugins-community](https://github.com/anthropics/claude-plugins-community) 的 `eli5`（Thariq Shihipar）。原技能用 `$ARGUMENTS`；这里从用户请求里取话题。
+
+---
+
+## 何时使用
+
+- `/eli5 <topic>`、`eli5`、像五岁小孩一样解释、用小学生能懂的方式讲、画图解释
+- 用户要一份一眼能看懂的图解，而不是长文
+
+## 不适用
+
+- 精确规格、边界条件、安全审计、修代码
+- 高保真 UI 或可编辑原型 → `draw-prototype-flow`
+- 边讨论边写笔记 → `discussion-notes`
+
+---
+
+## 步骤
+
+1. **取话题**。用户没给就问一次。
+2. **读者设定**：零背景，不是幼儿口吻。去掉默认假设，不要装小孩说话。
+3. **写一份自包含 HTML**（无外部 CSS / JS / 字体 / 图片 URL）：
+   - 一页看完
+   - 结构用大图讲（inline SVG；可少量 emoji）
+   - 文字极短：标题、箭头旁短语、一句总收束
+   - 至少把核心机制拆成 3 个可见步骤或块
+4. **落盘**。用户指定路径就用；否则写到当前项目根（没有项目就用 cwd）`eli5-<slug>.html`。Claude Code 若支持 artifact，可同时打开，**仍要写文件**。
+5. **聊天里只给路径和一句总收束**，不要把正文再讲一遍。
+
+## 注意事项
+
+- 不为了好懂而编造机制。不确定就标「简化」，不要装精确。
+- 不 git commit。
+- 语言跟用户请求走；没点名时用简体中文。
+
+## 验证
+
+- 用浏览器或 `file://` 打开是单页，图明显大于字。
+- 没背景的人能从画面看出「这东西怎么走」。
+- 仓库或 cwd 里有那份 HTML；聊天没有墙一样的解释。