diff --git a/AGENTS.md b/AGENTS.md index 0d0d10d..e1556ac 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -54,6 +54,7 @@ AGENTS.md # 本文档 | [deployer](skills/deployer/README.md) | 用 Git 里的 Compose 或 Argo CD 清单部署服务 | | [discussion-notes](skills/discussion-notes/README.md) | 边讨论边维护 Markdown 笔记 | | [draw-prototype-flow](skills/draw-prototype-flow/README.md) | 把产品想法画成可编辑的 Draw.io 低保真原型和用户动线 | +| [eli5](skills/eli5/README.md) | 用大图少字的单页 HTML 把话题讲给完全没背景的人听 | | [manage-release](skills/manage-release/README.md) | 给已准备好的 commit 发版本:更新说明、tag、可选 Forge Release | | [memory-distill](skills/memory-distill/README.md) | 任务结束后把可复用结论写入通用记忆和项目记忆 | | [orc](skills/orc/README.md) | 把开发、发版、DEB / Docker 意图编排成阶段,按档位分发给对应 skill | diff --git a/README.md b/README.md index 505cec9..058b880 100644 --- a/README.md +++ b/README.md @@ -129,6 +129,7 @@ AGENTS.md # 详细规范与架构说明 | [deployer](skills/deployer/README.md) | 用 Git 里的 Compose 或 Argo CD 清单部署服务 | | [discussion-notes](skills/discussion-notes/README.md) | 边讨论边维护 Markdown 笔记 | | [draw-prototype-flow](skills/draw-prototype-flow/README.md) | 把产品想法画成可编辑的 Draw.io 低保真原型和用户动线 | +| [eli5](skills/eli5/README.md) | 用大图少字的单页 HTML 把话题讲给完全没背景的人听 | | [manage-release](skills/manage-release/README.md) | 给已准备好的 commit 发版本:更新说明、tag、可选 Forge Release | | [memory-distill](skills/memory-distill/README.md) | 任务结束后把可复用结论写入通用记忆和项目记忆 | | [orc](skills/orc/README.md) | 把开发、发版、DEB / Docker 意图编排成阶段,按档位分发给对应 skill | diff --git a/skills/eli5/README.md b/skills/eli5/README.md new file mode 100644 index 0000000..93199ca --- /dev/null +++ b/skills/eli5/README.md @@ -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,不依赖外网资源。 +- 画面上图大于字;没背景的人能看出「这东西怎么走」。 +- 聊天没有再贴一遍长文解释。 diff --git a/skills/eli5/SKILL.md b/skills/eli5/SKILL.md new file mode 100644 index 0000000..5fa135d --- /dev/null +++ b/skills/eli5/SKILL.md @@ -0,0 +1,52 @@ +--- +name: eli5 +description: >- + 用大图少字的单页 HTML 把话题讲给完全没背景的人听。Use when the user types + /eli5 , 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 `、`eli5`、像五岁小孩一样解释、用小学生能懂的方式讲、画图解释 +- 用户要一份一眼能看懂的图解,而不是长文 + +## 不适用 + +- 精确规格、边界条件、安全审计、修代码 +- 高保真 UI 或可编辑原型 → `draw-prototype-flow` +- 边讨论边写笔记 → `discussion-notes` + +--- + +## 步骤 + +1. **取话题**。用户没给就问一次。 +2. **读者设定**:零背景,不是幼儿口吻。去掉默认假设,不要装小孩说话。 +3. **写一份自包含 HTML**(无外部 CSS / JS / 字体 / 图片 URL): + - 一页看完 + - 结构用大图讲(inline SVG;可少量 emoji) + - 文字极短:标题、箭头旁短语、一句总收束 + - 至少把核心机制拆成 3 个可见步骤或块 +4. **落盘**。用户指定路径就用;否则写到当前项目根(没有项目就用 cwd)`eli5-.html`。Claude Code 若支持 artifact,可同时打开,**仍要写文件**。 +5. **聊天里只给路径和一句总收束**,不要把正文再讲一遍。 + +## 注意事项 + +- 不为了好懂而编造机制。不确定就标「简化」,不要装精确。 +- 不 git commit。 +- 语言跟用户请求走;没点名时用简体中文。 + +## 验证 + +- 用浏览器或 `file://` 打开是单页,图明显大于字。 +- 没背景的人能从画面看出「这东西怎么走」。 +- 仓库或 cwd 里有那份 HTML;聊天没有墙一样的解释。