kandong
Verified看懂 AI 的长回答:把一大段文字做成先看全局、再点开细节的 HTML 页面。用于:用户说「看不懂」「太长了」「出 HTML」;你刚写完一段很长的回答(超过约 800 字,或有 3 个以上读者不熟的概念);用户要把看懂页面存进知识库时。
看懂(kandong)
读者要的是看懂,不是更多的字。同一份内容分三层处理,越往下越省读者的脑子:
- 文字层:把字本身改好读。
- 结构层:把字变成一页 HTML,先看全局,再点开细节。
- 讲解层:把理解的过程设计成一条讲解视频(本 skill 只给入口,见第 7 步)。
默认只做第 1、2 层,让读者看懂。知识库笔记(第 6 步)和讲解视频(第 7 步)只在用户要时做。页面负责看懂,笔记负责存下来。
步骤
1. 定材料
找到要处理的原文:用户粘贴的文字、指定的文件,或者你上一条回复。写下一句话的读者问题:读者最想从这份材料里知道什么。
完成标准:原文已确定,读者问题只有一句。
2. 拆骨架
把原文里的每一条信息放进下面五格之一:
| 格子 | 放什么 |
|---|---|
| 结论 | 回答读者问题的话,最多 3 句 |
| 待定 | 需要读者拍板或动手的事,每件写成一个问题加选项 |
| 概念 | 读者需要认识的东西。每个概念只取一个名字,原文里的别名记在它下面 |
| 关系 | 概念之间是流程、对比、层级、循环还是时间线,选一种画成全局图 |
| 细节 | 其余信息,按概念归组 |
完成标准:原文里的每个事实、条件、数字、限定都落进了某一格;没有哪一格里出现原文没有的事实。
3. 改文字
按 references/中文写作规则.md 改写五格里的每一句。逐条过规则,不挑着用。
完成标准:每条规则都检查过;凡是为了保住精度而没改短的句子,记下来,交付时说明。
4. 出页面
复制 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,把页面复制成同名 .html 放在旁边。
完成标准:两个文件都在 kb_dir 里,笔记里有指向页面的链接。回复用户笔记路径。
7. 讲解层(用户要视频时)
用户说「做成视频」「讲解视频」时,用第 2 步的骨架写一份分镜稿:每个概念配一个比喻,每个比喻配一个画面。交给用户手上的视频工具(如 HyperFrames、Remotion)去渲染。分镜稿格式见 references/讲解视频分镜.md。
样例
examples/乾卦六爻/:一段 AI 写的长解释(原文.md)→ 页面(page.html)→ 笔记(note.md)。动笔前先看一遍,照它的拆法和文字水准做。它用的是模板的默认样式,你的页面样式按第 4 步现做。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |