# Feynman Learning

Turn any concept, lesson, slide deck, or source material into a Feynman learning cycle...

- Repository: https://github.com/THU-MAIC/OpenMAIC (42385 stars)
- Category: Documents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add THU-MAIC/OpenMAIC --skill feynman-learning -g -a claude-code -y`
Codex: `npx skills add THU-MAIC/OpenMAIC --skill feynman-learning -g -a codex -y`
Cursor: `npx skills add THU-MAIC/OpenMAIC --skill feynman-learning -g -a cursor -y`
Gemini CLI: `npx skills add THU-MAIC/OpenMAIC --skill feynman-learning -g -a gemini-cli -y`

## Description

Turn any concept, lesson, slide deck, or source material into a Feynman learning cycle in which learners explain first, expose the smallest gap, rebuild the explanation through Socratic prompts, strip jargon, stress-test analogies, and transfer the idea to a new context. Use when the user asks for teach-back, learning by explaining, or a Feynman-style classroom. Do not use when the Feynman technique itself is merely the lesson topic or when study strategy should remain a parallel goal.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 费曼学习法

把任何学科内容重构为一轮完整的费曼学习循环。核心对象不是教材，而是学习者当前的解释。学习者必须经历“先解释、暴露缺口、自己重建、换种说法、迁移应用”，最终留下《费曼学习记录》和下一轮目标。

先加载 `/stage-design`，遵循它的新课堂创建、roster、逐页持久化和音频验收流程。本 Skill 只规定教学法、页面 brief 和互动节奏。

## 适用范围

用于以下请求：

- 用费曼法学习或教授某个具体概念；
- 把课件、教案、视频或材料改造成费曼式学习活动；
- 设计一节以 teach-back、自我解释、追问和迁移为核心的课堂。

不要用于：

- 以“费曼学习法是什么”为知识主线的科普课；
- 只想把学习策略作为概念课的平行目标，此时使用 `/learning-to-learn`；
- 品牌风格复制或 PPT 原样导入，此时使用 `/style-clone` 或 `/pptx-import`。导入材料仍可作为本 Skill 的事实来源。

## 核心原则

1. **学习者先讲，AI 后介入。** 在展示权威定义、教材解释或标准流程之前，先收集学习者自己的解释。没有初始解释，就没有费曼循环。
2. **一次只修最小缺口。** 从解释中找出当前最关键的 1, 2 个断点，不把整本教材一次性砸给学习者。
3. **追问优先于代答。** 先用最少的问题帮助学习者自己补全因果链。只有多次追问仍卡住且用户允许时，才提供必要事实或支架。
4. **理解必须经得住改写和迁移。** 能背术语不等于理解；学习者要能去掉术语、说明类比边界，并在陌生情境中重新解释。
5. **材料只提供事实，不抢占初始解释。** 教师上传的材料用于确定概念边界和校验事实，不作为第一页直接展示的标准答案。

## 页面内容红线

以下词属于规划语言，只能写在对话、brief 或 roster 设计中，不得作为学生可见的标题、标签或栏目：`Teach-back`、`Jargon Challenge`、`Transfer`、`v1/v2/v3`、`概念定界`、`缺口诊断`、`类比破坏测试`、`费曼循环`、`概念变化轨迹`。

学生可见标题要写成可执行动作，例如：

- “先把它讲给一个没学过的人听”；
- “你讲到哪一步卡住了？”；
- “换掉这几个词，再讲一遍”；
- “这个类比会在哪里失效？”；
- “到一个新情境里试试”。

老师和学生代理的口述、追问与讨论放进 narration / actions，不写成“老师说”“小白说”的静态页面正文。

## 先确定三个约束

页面计划前明确：

1. **concept boundary**：本轮只解释哪个可学习的核心概念，明确不覆盖什么；
2. **audience**：学习者要讲给谁听，例如没学过该概念的初中生或外行；
3. **teacher constraints**：学习深度，以及追问失败后是否允许 AI 给出答案。

只有请求不足以确定这些约束时，才用 `ask_user` 补齐。

## 费曼循环与页面映射

循环可以落在 7, 9 页中。不要机械追求页数，但以下证据链不能缺失。第一页应把概念边界和第一次讲解合并成一个 `interactive` 任务，避免在初始解释前泄露标准内容。

### 1. 先讲给外行听（interactive）

- 简短说明本轮概念边界和目标听众，不给标准定义；
- 要求学习者不查资料，用自己的话完成第一次解释；
- 优先提供文本或语音输入。若组件无法保存自由输入，要求学习者先写下或说出自己的版本，并让老师旁白提醒其保留，供后续对照。

### 2. 找到最小卡点（interactive 或 slide）

- 把初始解释拆成必要概念要素；
- 只定位 1, 2 个最关键的跳步、术语替代、错误因果或遗漏；
- 让学习者自己判断“我卡在哪里”，不要只展示 AI 评分。

概念检查表写进 brief，并转成学生能回答的问题，不要渲染“缺口 1”“缺口 2”等内部标签。

### 3. 用问题把因果链补出来（interactive，或以 discussion action 收尾的 slide）

- 每个问题只针对一个已定位缺口；
- 小白代理持续追问“为什么”“如果条件改变会怎样”；
- brief 写明该问题针对什么、出现什么理解证据后停止；
- 未满足 teacher constraints 前不要直接给答案。

### 4. 再讲一遍（interactive）

- 给出少量结构提示，要求学习者生成第二版解释；
- 提示必须指向因果结构，不复述标准答案；
- 保留第一版与第二版的可比较差异，供最终学习记录使用。

The rest: https://github.com/THU-MAIC/OpenMAIC/blob/HEAD/skills/agent-runtime/feynman-learning/SKILL.md