用途:把学习者(用户或刚接触陌生系统的智能体)带过某个主题、代码库或论文,目标是会话结束时真正理解,而不是排一套学习计划。讲解遵循两条标准:费曼技巧要求通俗易懂、术语按需引入、每个想法配一个具体例子;学习科学提供结构,即先大图景后细节、按学习者节奏分段、先示例后抽象、文字配图。
工作流程:先用一轮轻量问答校准范围(材料是什么、理解后要做什么、已掌握什么);再给整体地图,用一段大白话讲清全貌,并列出 3–7 个分段及各自重要性,确认后再展开;随后逐段讲解,每段边界停顿、邀请提问;讲解结束后(不在之前)提 2–4 个针对性问题,判断哪些段落没落地;对薄弱段落换角度重讲,循环到学习者说懂了为止。
辅助脚本:技能内置 scripts/assets 目录,需先确定基目录: SKILL_DIR="<this skill's base directory>" 若没有,可查找: SKILL_DIR=$(find ~/.claude ~/.config ~/.agents -type d -name 'feynman-walkthrough' 2>/dev/null | head -1) 并需 Python 3.10 或更新版本;命令中的 python3 应替换为实际可用解释器。无 Python 时仍可全程对话讲解,但不会保存说明文档。
持久化与复习:说明文档以 Open Knowledge Format (OKF) 包保存,通过 assets/okf.py 管理,frontmatter 固定各来源指纹。后续会话可查状态: python3 "$SKILL_DIR/assets/okf.py" status <subject> FRESH 表示来源未变,可直接复习;STALE 表示来源已变,用 diff 子命令查看改动文件并只更新受影响段落;UNKNOWN 为外部来源,需先确认是否变化。写入前会校验生产者契约,不符合规范的会被拒绝并列出问题。长时记忆方法(提取练习、间隔复习)属可选,仅在学习者明确选择时才提供,可用 assets/spaced_schedule.py 生成复习日期。
适用场景:代码库或技术系统导览、论文/白皮书解读、一般性入门、为转教他人而深入理解。限制:该技能是讲解者标准,不用于事前测验、刻意不给答案或制造摩擦;是否启用记忆训练由学习者决定,不强制;具体收费、平台等信息暂未提供。