Skip to content

jeszhou/kandong-skill

kandong

Verified

看懂 AI 的长回答:把一大段文字做成先看全局、再点开细节的 HTML 页面。用于:用户说「看不懂」「太长了」「出 HTML」;你刚写完一段很长的回答(超过约 800 字,或有 3 个以上读者不熟的概念);用户要把看懂页面存进知识库时。

---
name: kandong
description: 看懂 AI 的长回答:把一大段文字做成先看全局、再点开细节的 HTML 页面。用于:用户说「看不懂」「太长了」「出 HTML」;你刚写完一段很长的回答(超过约 800 字,或有 3 个以上读者不熟的概念);用户要把看懂页面存进知识库时。
---

# 看懂(kandong)

读者要的是**看懂**,不是更多的字。同一份内容分三层处理,越往下越省读者的脑子:

1. **文字层**:把字本身改好读。
2. **结构层**:把字变成一页 HTML,先看全局,再点开细节。
3. **讲解层**:把理解的过程设计成一条讲解视频(本 skill 只给入口,见第 7 步)。

默认只做第 1、2 层,让读者看懂。知识库笔记(第 6 步)和讲解视频(第 7 步)只在用户要时做。页面负责看懂,笔记负责存下来。

## 步骤

### 1. 定材料

找到要处理的原文:用户粘贴的文字、指定的文件,或者你上一条回复。写下一句话的**读者问题**:读者最想从这份材料里知道什么。

完成标准:原文已确定,读者问题只有一句。

### 2. 拆骨架

把原文里的每一条信息放进下面五格之一:

| 格子 | 放什么 |
|---|---|
| 结论 | 回答读者问题的话,最多 3 句 |
| 待定 | 需要读者拍板或动手的事,每件写成一个问题加选项 |
| 概念 | 读者需要认识的东西。每个概念**只取一个名字**,原文里的别名记在它下面 |
| 关系 | 概念之间是流程、对比、层级、循环还是时间线,选一种画成全局图 |
| 细节 | 其余信息,按概念归组 |

完成标准:原文里的每个事实、条件、数字、限定都落进了某一格;没有哪一格里出现原文没有的事实。

### 3. 改文字

按 [references/中文写作规则.md](references/中文写作规则.md) 改写五格里的每一句。逐条过规则,不挑着用。

完成标准:每条规则都检查过;凡是为了保住精度而没改短的句子,记下来,交付时说明。

### 4. 出页面

复制 [assets/page-template.html](assets/page-template.html),按模板里的注释填进五格内容。模板只管结构:区块 id、按钮和展开块的交互照原样保留。

**样式每次按内容现做。**先看这份内容的气质(古典、技术、数据、生活……),为它定一套配色、字体和图形手感,整块替换模板里的 `<style>`。全局图的颜色用同一套 CSS 变量,和页面一个调子。

内容排法:

- 结论放在第一屏。
- 待定事项做成可点选的按钮,底部「复制回复」把选择拼成一段话,读者粘贴回来就行。没有待定事项就删掉这一块。
- 全局图用内联 SVG 画,图里的名字和概念表一字不差。
- 细节用可展开的块,默认收起。
- 原文放在页面最底部,默认收起。

页面存到临时文件夹 `${TMPDIR:-/tmp}/kandong/YYYYMMDD-标题.html`,不写进知识库。

完成标准:运行 `python3 <本 skill 目录>/scripts/check_page.py <页面路径>`,输出 `OK`;有无头浏览器就截第一屏看一眼:结论在第一屏,字和底色对比清楚。

### 5. 交付

用浏览器打开页面。回复用户不超过 3 行:页面路径、待定事项有几件,最后加一句「要存进知识库就说一声」。第 3 步记下了保留的长句,就在这 3 行后面逐条列出,每条写明它保住的是哪个条件或数字。

### 6. 存笔记(只在用户要求时做)

用户说「存进知识库」「存一下」「进知识库」时才做这一步。没说就不做,也不追问。

知识库位置读 `~/.config/kandong/config.json` 里的 `kb_dir`。文件不存在时,问用户一次知识库文件夹在哪,写进这个文件;用户不想设,就用当前目录下的 `看懂/`。

在 `kb_dir` 下新建 `YYYYMMDD-标题.md`,格式见 [references/笔记格式.md](references/笔记格式.md),把页面复制成同名 `.html` 放在旁边。

完成标准:两个文件都在 `kb_dir` 里,笔记里有指向页面的链接。回复用户笔记路径。

### 7. 讲解层(用户要视频时)

用户说「做成视频」「讲解视频」时,用第 2 步的骨架写一份分镜稿:每个概念配一个比喻,每个比喻配一个画面。交给用户手上的视频工具(如 HyperFrames、Remotion)去渲染。分镜稿格式见 [references/讲解视频分镜.md](references/讲解视频分镜.md)。

## 样例

[examples/乾卦六爻/](examples/乾卦六爻/):一段 AI 写的长解释(`原文.md`)→ 页面(`page.html`)→ 笔记(`note.md`)。动笔前先看一遍,照它的拆法和文字水准做。它用的是模板的默认样式,你的页面样式按第 4 步现做。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall