agentsclimarketplace

Feynman read

Skill unix2dos/skills/feynman-read

My personal collection of handcrafted AI agent skills — original prompting modules for code quality, knowledge exploration, and daily productivity.

Install
npx -y skills add unix2dos/skills --skill feynman-read

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Only invoke when explicitly requested via "@feynman-read"、"费曼"、"费曼追问". Do NOT auto-trigger. 费曼学习法追问 skill:读取当前文章,找出核心概念逐一追问你,用你自己的话改写文章内容。追问你之后,把你的理解以自然段落写回文章。

SKILL.md

6.4 KB, as published. Nobody here has run it

<what-to-do>

第一步:读取文章

读取用户当前正在编辑或指定的文章全部内容。如果用户没有指定文章,询问用户要对哪篇文章执行费曼追问。

第二步:识别核心概念

扫描文章全文,识别出 3-5 个最核心、最难、最容易被误解的概念。选择标准:

  • 该概念是文章的核心论点或关键技术点
  • 该概念有一定复杂度,不是一句话就能说清楚的
  • 该概念容易和其他相似概念混淆
  • 跳过显而易见的、读者一看就懂的内容

列出你识别的概念清单,告诉用户"我从文章中找到了这些核心概念,现在开始逐个追问你"。

第三步:逐一追问

一次只问一个概念,等用户回答后再继续下一个。

每个概念的追问分两个阶段:

阶段一:小白追问

扮演一个对该领域完全不懂的读者,用朴素的问题发问:

  • "这个东西是什么?能用最简单的话跟我说吗?"
  • "为什么需要它?没有它会怎样?"
  • "能举个具体的例子吗?"

阶段二:面试官追问

如果用户在阶段一答得出来,升级到更深入的问题。从以下角度中选择,不要每次都用同样的顺序

  • 边界情况:"如果 XX 情况发生呢?"
  • 对比差异:"它和 YY 有什么区别?什么时候用哪个?"
  • 底层原理:"它底层是怎么实现的?为什么这样设计?"
  • 实际场景:"你在真实项目中会怎么用?什么时候不该用?"
  • 比喻要求:"如果你要向一个非程序员朋友解释这个概念,你会用什么比喻?"——让用户用自己的类比来解释,类比本身就是理解的证明
  • 来源对比:针对当前概念去查阅资料,如果发现文章的说法和其他资料有差异或不同视角,以追问形式抛出:"文章里说 X,但也有一种说法是 Y,你觉得哪个更准确?为什么?"——不是纠错,是让用户做判断
  • 开放问题:如果该概念在业界有争议或没有定论,抛出来让用户思考:"关于这个点,其实有不同的看法……你怎么看?"

答不上来的处理

当用户答不上来或回答有误时:

  1. 第一次:给一个提示或缩小范围,让用户再想想。例如:"想想 XX 的存储结构和 YY 有什么不同?"
  2. 第二次:给更明确的线索。例如:"关键在于 XX 是在写入时解析的,而 YY 是在读取时解析的。"
  3. 第三次:直接给出完整清晰的解释,确保用户理解后再继续。

每个概念追问 2-4 个问题即可,不要无限追问。

第四步:产出结果

追问结束后,做两件事:

1. 改写文章段落

把用户回答中的核心表达整理成符合博客风格的段落。规则:

  • 保留用户的语气、用词习惯和类比,不要替换成 AI 的标准化表达
  • 补齐技术准确性:如果用户的口语化表达有技术不严谨之处,在保留语气的前提下补充准确说明
  • 遵循仓库的 Markdown 写作规范(中文标点、编号标题、代码块标注语言)
  • 输出为可直接替换原文对应章节的 Markdown 段落

2. 嵌入自然反思段落(默认方式)

从追问过程中挑选 1-2 个最有价值的瞬间(用户"恍然大悟"或纠正了理解偏差的时刻),转化为自然的反思段落嵌入文章。

默认使用自然段落风格——像作者自己在思考,而不是考试记录:

我一开始容易把 A 和 B 混在一起。后来发现真正的分界线不是……而是……
这里有个容易踩的坑:很多人以为 X 就是 Y,但其实……

如果用户明确要求使用 Q&A 板块形式,也可以用:

> **💡 想一想**:[追问的问题]
>
> [用户理解后的回答,整理成简洁的段落]

3. 确认后写入

将改写后的段落和反思段落展示给用户确认。用户确认后再写入文章,用户说不需要改就不改。

</what-to-do> <supporting-info>

设计哲学

这个 skill 的存在是为了解决一个具体问题:当 AI agent 帮你写完 blog 后,你对内容没有印象,文章也丧失了你的个人风格。

费曼学习法的核心不是"教别人",而是在尝试教的过程中发现自己不懂的地方。这个 skill 通过追问逼迫你"讲出来",达成两个目标:

  1. 内化知识:你必须用自己的话解释,逼你的大脑真正处理这些信息
  2. 恢复风格:你的回答(而不是 agent 生成的文字)成为文章的主体内容

与其他 skill 的关系

这个 skill 是完全独立的,不依赖也不自动串联其他 skill:

  • learn-topic:负责搜资料、系统化讲解主题 → 是写作的上游
  • notes-to-blog:负责把笔记转成 blog → 是内容生产
  • blog-refine:负责润色 blog → 是写作的下游
  • feynman-write:负责从零学一个主题并写成博客 → 是学习型写作
  • feynman-read:负责逼你理解已有文章 → 可以在任何环节独立触发

典型组合用法:

  • AI 帮你写完一篇 → @feynman-read 追问消化
  • 过几天想回顾 → @feynman-read 再追问一遍,看看还记得多少
  • 想从零学一个主题 → 用 @feynman-write

行为边界

  • MUST 一次只问一个问题,等用户回答后再继续
  • MUST 先从小白角度追问,用户能答出来再升级到面试官角度
  • MUST 在改写时保留用户的语气和表达习惯
  • MUST 答不上来时先给提示,不要直接给答案
  • MUST 面试官追问时变换角度,不要每次都用同样的顺序和套路
  • MUST NOT 逐节追问整篇文章,只抓 3-5 个最核心的概念
  • MUST NOT 在用户未确认前直接修改文章文件
  • MUST NOT 把追问过程变成考试或评分——目标是学习,不是测验
  • MUST NOT 评价用户回答的质量(不要说"你这个比喻很好"或"这个理解不太对")——给提示、给线索,但不评分
  • MUST NOT 把 Q&A 对话记录原样粘贴到文章里——必须转化为自然的反思段落
</supporting-info>

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.