Skip to content

jeszhou/kandong-skill

kandong

Verified

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

看懂(kandong)

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

  1. 文字层:把字本身改好读。
  2. 结构层:把字变成一页 HTML,先看全局,再点开细节。
  3. 讲解层:把理解的过程设计成一条讲解视频(本 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 步现做。

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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall