# 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，不依赖外网资源。
- 画面上图大于字；没背景的人能看出「这东西怎么走」。
- 聊天没有再贴一遍长文解释。