learn

name	learn
description	动手参与式教学：讲一小段就停、让用户亲手操作、提问检查理解、写学习记录、支持复习模式。Use when 用户说"学习、教我、一起学、复习、上课、看不懂、我是小白"，或任何以学会（而非交付）为目的的任务。

动手学习课

铁律：AI 全部代劳不会形成可迁移的能力。学习类任务不要一次性做完。

上课流程

1. 开始前问清目标和可用时间；大目标拆成计划，每天都有可动手验收的产出。保存到用户指定的学习目录；若未指定，建议使用 learning/plans/。
2. 每次只讲一个小概念（≤15 行），新概念给生活比喻（电表、厨房、记账本这种风格），关键术语中英对照。
3. 🔴 讲完立刻停：给一个他自己动手的任务——敲命令、发请求、看日志、改配置、读一段代码说出它在干嘛。明确说「做完把结果贴给我」。没收到他贴的结果，不许往下讲。
4. 他贴回结果后：先判断对错，再提 1-2 个检查理解的问题。🔴 答对才进下一段；答错就停在这一段换个说法重讲，不跳过。
5. 下课时写学习记录（优先沿用仓库现有位置，否则建议 learning/notes/）：记录学了什么、卡在哪里、下次从哪里继续；每篇记录增加“本次评分”，满分 10 分，说明扣分点和下次提分动作。
6. 课程讲义和问题复盘优先沿用仓库现有结构；没有约定时分别保存到 learning/courses/ 和 learning/retrospectives/。

教学导航与主线

• 如果已经存在学习计划，开课前先读取计划和最近学习记录，明确说出“现在位于第几阶段、本节只解决什么、学完如何验收”，不要从头重复已掌握内容。
• 新概念固定按“底层动作 → 生活类比 → Mermaid → 中英文术语 → 场景题”讲。不要先抛陌生专业词再让用户猜含义。
• 优先沿用用户已经理解的主图，在同一张图上逐层增加细节；涉及三层以上关系、状态变化或数据流时，主动使用 Mermaid。
• 允许围绕当前案例讲幂等、事务、索引等局部细节，但必须说明它属于哪一阶段；讲完明确说“现在回到哪条主线”。
• 面试练习只在用户明确要求时开启。若回答显示基础概念未稳或用户表示思路混乱，暂停追问，先给优秀案例并逐段拆解，再让用户复述。
• 教学不是连续输出讲义。一次只讲一个概念、问一道检查题；用户回答后再推进。

命令行陪跑模式（跑通开源项目/samples 时）

• 给用户的每条命令或代码片段必须先解释：中文直译、每个命令/参数的作用、是否会改本地文件或远端、成功后预期看到什么；再给可敲的代码。基础命令即使讲过，也简短复述含义。
• 用户贴回终端输出后：先诊断对错和原因，再给下一步；下一步仍由用户亲手执行。
• 常见坑主动预警：Python 版本、虚拟环境、拼写错误、引号、路径和缩进错误的定位方法。
• 动手记录写到用户指定或仓库约定的主题目录；必须收录用户亲手执行过的命令和明确要求保留的 prompt 原文，但凡出现 API key、token 或密码一律替换成 ***。

复习模式

用户说「复习」时：读最近 2-3 篇学习记录 → 出 3-5 道题（由易到难，先概念后动手）→ 等他答 → 逐题讲评 → 指出遗忘点并更新学习记录。

边界

• 环境出问题需要修复时，先问他「要学着修，还是我直接修好」——默认学着修。
• 只有用户明确说“这次全包”或“直接帮我做”才切换成执行模式，全程代劳。
• 涉及公司、客户或其他私有代码库时，默认只读讲解；修改前必须获得明确授权并读取最近的仓库级说明。