| name | xiaozhi-teach-lesson-log |
| display_name | 课后记录助手 |
| version | 1.0.0 |
| author | 小智伴学 |
| category | 独立教师 |
| tags | ["课后记录","课堂观察","学习轨迹","教学复盘","独立教师"] |
| description | 帮助独立教师把"课后记忆"升级为"结构化教学档案"。 当老师说"课后总结"、"记录本节课"、 "学员这节课学得怎么样"、"这节课复盘"、 "学员学习轨迹"、"课后记什么"时，建议激活此SKILL。 核心工作流：课后 5 分钟内即时记录 → 5 维度结构化（学了什么/掌握度/反应/进步/调整） → 学员学习轨迹更新 → 课时消耗登记 → 与 xiaozhi-teach-solo-dashboard / student-analyzer / parent-communication 建立数据接口。 该版本基于 5 分钟即时记录原则， 让独立教师的"教学资产"持续累积。
|
| compatibility | OpenClaw / ClawHub |
| depends_on | xiaozhi-teach-solo-dashboard, xiaozhi-teach-student-analyzer, xiaozhi-teach-lesson-planner |
| id | openclaw:xiaozhi-teach-lesson-log |
| min_platform_version | 2.0 |
| max_round_limit | 15 |
课后记录助手 SKILL
一句话定位： 每节课都是一笔教学资产——记下来的，才是积累；不记的，就是流过。
⚠️ 技术实现边界声明
关于"课后即时记录"原则： 本 SKILL 强基于"课后 5 分钟内补录"原则；超过 30 分钟未补录，记忆准确度显著下降，本 SKILL 会标注"事后回忆，准确度有限"。
关于"学员姓名"边界： 所有课后记录一律使用化名（化名 A、化名"小米"等）；不出现真实姓名、家庭信息、家长身份。
关于"课时消耗自动扣减"机制： 课时消耗写入 solo-dashboard 时使用预扣模式，老师在 24 小时内可调整；超过 24 小时自动确认。
一、核心使命
独立教师课后记录常见的三个误区：
误区① 凭记忆：下课就忘，下周上课时
不知道上次讲了什么、学生什么状态。
误区② 流水账：只写"今天讲了 X 章节"，
没有掌握度评估、没有学生反应、
没有下节课衔接点。
误区③ 不写：觉得"我心里有数就行"，
累积下来学员成长轨迹全无，
续费沟通和阶段报告全凭印象。
本 SKILL 要解决的是：
- 让每节课都被结构化记录：5 维度即学到什么/掌握度/反应/进步/调整
- 让学习轨迹可见：累积成学员成长档案
- 让教学决策有依据：复盘+调整+衔接
- 让独立教师的资产沉淀：形成可查询的教学数据库
二、触发时机
| 触发场景 | 示例语句 |
|---|
| 课后总结 | "课后总结一下" / "今天这节课记录一下" |
| 记录本节课 | "记一下这节课" |
| 学员学得怎么样 | "[化名] 今天学得怎么样" |
| 复盘 | "这节课复盘" / "这节课上得怎么样" |
| 学习轨迹 | "看一下 [化名] 的学习轨迹" |
| 课时扣减 | "扣 [化名] 一课时" |
| 下节课衔接 | "[化名] 下节课应该讲什么" |
| 学员进步 | "看一下 [化名] 的进步" |
三、核心流程
┌──────────────────────────┐
│ ① 课后 5 分钟内触发 │
│ 学员/课题/课时 │
└────────────┬─────────────┘
↓
┌──────────────────────────┐
│ ② 5 维度结构化记录 │
│ 学/掌握/反应/进步/调整 │
└────────────┬─────────────┘
↓
┌──────────────────────────┐
│ ③ 学习轨迹更新 │
│ → solo-dashboard │
└────────────┬─────────────┘
↓
┌──────────────────────────┐
│ ④ 课时消耗登记 │
│ 预扣 24h 老师可调 │
└────────────┬─────────────┘
↓
┌──────────────────────────┐
│ ⑤ 学情更新 │
│ → student-analyzer │
└────────────┬─────────────┘
↓
┌──────────────────────────┐
│ ⑥ 下节课衔接建议 │
│ → lesson-planner │
└────────────┬─────────────┘
↓
┌──────────────────────────┐
│ ⑦ 课后家长简报（可选） │
│ → parent-communication │
└──────────────────────────┘
四、5 维度结构化记录
4.1 5 维度框架
📎 完整 5 维度框架图见 references/lesson-log-template.md 第一节（学了什么/掌握度/反应/进步/调整的逐项观察要点）
4.2 课后记录模板
📎 完整填写模板见 references/lesson-log-template.md 第二节（含 masteryStatus 五档勾选：已掌握/基本理解/仍需巩固/需要重讲/证据不足）
五、5 分钟即时记录原则
5.1 时间窗口
窗口 1（理想）：课后 0-5 分钟
· 学生刚走，趁记忆清晰
· 完成核心 5 维度记录
窗口 2（可接受）：课后 5-30 分钟
· 关键信息不丢
· 5 分钟内补完
窗口 3（事后回忆）：课后 30 分钟-24 小时
· 标注"事后回忆，准确度有限"
· 重点补核心：学了什么 + 掌握度
窗口 4（过期）：课后 > 24 小时
· 强烈不建议
· 教学价值大幅下降
5.2 即时记录速记法
学生离开前 1 分钟（5 句话速记）：
① 今天学了 [课题]
② [化名] 掌握了 [X]，没掌握 [Y]
③ 反应：□专注 □一般 □易分心
④ 下次讲 [X]
⑤ 需要给家长说：[X / 暂不需要]
课后再花 3-5 分钟补全 5 维度。
5.3 速记 vs 完整记录
速记版（课后 1 分钟内）：
· 5 句话
· 课题 + 掌握度 + 反应 + 衔接 + 家长沟通
完整版（课后 5-10 分钟）：
· 5 维度结构化
· 含错题/弱项/调整方向
六、学习轨迹更新
6.1 单课时轨迹点
每次课后记录 = 学员学习轨迹的一个点
轨迹包含：
· 课时编号
· 日期
· 课题
· 掌握度
· 进步方向
· 调整方向
6.2 学员学习轨迹视图
📎 完整轨迹视图模板见 references/lesson-log-template.md 第四节（课时概览/知识图谱演进/习惯养成/抗挫能力/关键转折点）
6.3 写回 solo-dashboard
学习轨迹数据：
· 单课时记录（课题/掌握度/反应/进步/调整）
· 累积轨迹（知识图谱/习惯/抗挫/转折点）
· 课时消耗（预扣）
→ solo-dashboard 显示
→ 学员档案持续累积
七、课时消耗登记
7.1 预扣机制
每节课后自动预扣 1 课时
· 24 小时内老师可调整（如补课未上、迟到等）
· 超过 24 小时自动确认
· 续费节点预警基于实际消耗
⚠️ 课时包管理：
· 课时包到期前 7 天预警
· 课时包到期前 3 天再次预警
· 到期当天自动提醒续费
7.2 特殊场景
学生请假：
· 不扣课时（自动或手动调整）
· 标记请假原因
老师取消：
· 不扣课时
· 自动补排课
补课：
· 按实际课时扣
· 标注"补课"
试讲/试听：
· 不扣学员课时
· 标注"试听"用于转化判断
7.3 课时异常登记
■ 学生迟到
· 迟到 10 分钟内：不补扣，正常扣
· 迟到 10-30 分钟：与家长沟通
· 迟到 > 30 分钟：本次按半课时扣或重新约
■ 学生早退
· 同上
■ 老师迟到
· 自动补 5-10 分钟
· 必要时按学员时间补足
■ 网络/设备故障
· 5 分钟内：不算
· 5-15 分钟：补 5 分钟
· > 15 分钟：本次重排
八、下节课衔接建议
8.1 衔接点生成
基于本次课后记录，AI 自动生成下节课衔接建议：
· 复习未掌握知识点
· 继续未完成的进度
· 强化新增弱项
· 引入新内容（如进度允许）
8.2 衔接建议模板
📎 完整衔接建议模板见 references/lesson-log-template.md 第六节（必做/选做/节奏建议/衔接素材）
8.3 写回 lesson-planner
· 衔接素材（错题/思维导图/未掌握点）
· 节奏建议
· 重点关注行为
→ lesson-planner 在下次教案中纳入
九、课后家长简报
9.1 简报触发条件
■ 必发
· 学生有显著进步
· 学生有显著退步
· 学生有明显情绪/行为问题
· 阶段性节点（课时包 50%/70%/90%）
■ 选发
· 每周固定简报（如周日晚上）
· 月度总结
· 重大考试前后
9.2 简报模板
📎 完整简报模板与分场景话术见 references/lesson-log-template.md 第七节（简报模板 + 进步/退步/情绪/节点四类话术）
9.3 写回 parent-communication
· 简报内容
· 简报类型（进步/退步/情绪/节点）
· 发送时间建议
→ parent-communication 准备话术
→ 老师确认后发送
十、与上游/下游 SKILL 的协作
10.1 协作流图
┌────────────────────────┐
│ xiaozhi-teach- │
│ lesson-planner │
│ （教案/衔接素材） │
└───────────┬────────────┘
│
↓
┌────────────────────────┐
│ 课堂 │
└───────────┬────────────┘
│
↓
┌────────────────────────┐
│ xiaozhi-teach- │
│ lesson-log │
│ （本 SKILL） │
└───────────┬────────────┘
│
┌─────────────────┼─────────────────┐
↓ ↓ ↓
solo-dashboard student-analyzer parent-communication
（课时/轨迹） （学情更新） （家长简报）
10.2 接口
读：
workspace.lessonSchedule[].lessonGoal
→ 上游课节目标，作衔接素材参考
workspace.studentCards[].primaryWeaknesses / goals
→ 学情基线对比（原 soloDashboard.studentBaseline，
基线即学员卡片的既有弱项与目标）
写：
workspace.lessonLogs[].completedContent
→ 5 维度记录之「学了什么」
workspace.lessonLogs[].masteryStatus
→ 5 维度记录之「掌握度」（五档取值之一）
workspace.lessonLogs[].evidence
→ 掌握度/进步的证据条目
workspace.lessonLogs[].nextLessonFocus
→ 下节课衔接点
workspace.lessonLogs[].parentSummary
→ 家长简报事实来源
workspace.lessonLogs[].consumeLessonUnits
+ workspace.coursePackageLedger[].usedUnits / remainingUnits
→ 课时消耗登记（预扣写入课时账本）
派生 / 非存储项（不落 schema，读取时实时计算）：
掌握度变化 masteryDelta
（派生视图，非存储字段：由 workspace.lessonLogs[].masteryStatus
按课时先后比较得出，不单独存储）
学习轨迹点 trailPoint
（派生视图，非存储字段：由 workspace.lessonLogs[]
与 workspace.progressEvidence[] 按时间聚合而成）
→ solo-dashboard 读取上述字段渲染课时/轨迹
→ student-analyzer 读取 lessonLogs 更新学情
→ parent-communication 读取 parentSummary 准备话术
十一、字段级高敏信息防护
✅ 课后记录中可使用化名（化名 A/小米/小张）
❌ 禁止：出现真实姓名
✅ 写回数据：聚合观察（"这节课注意力集中 35 分钟"）
❌ 不写回：在公开数据中暴露学员真实身份
✅ 家长简报：基于具体行为
❌ 禁止：贴标签、负面评价
十二、行为准则
| ✅ 应该做 | ❌ 不能做 |
|---|
| 课后 5 分钟内补录 | 拖到下次课才记 |
| 5 维度结构化记录 | 写"今天讲了 X 章节"流水账 |
| 学习轨迹持续累积 | 学员成长轨迹全无 |
| 课时消耗预扣 24h 可调 | 课时不透明 |
| 衔接建议基于实际记录 | 下节课凭印象讲 |
| 家长简报基于具体行为 | 简报贴标签/负面评价 |
| 写回数据用化名 | 公开记录暴露真实姓名 |
十三、与其他 SKILL 的协同清单
课后记录助手
<── xiaozhi-teach-lesson-planner（教案/衔接素材）
<── xiaozhi-teach-solo-dashboard（学员基线）
──→ xiaozhi-teach-solo-dashboard（课时/轨迹）
──→ xiaozhi-teach-student-analyzer（学情更新）
──→ xiaozhi-teach-parent-communication（家长简报）
──→ xiaozhi-teach-renewal-report（阶段报告素材）
禁止行为：
- 禁止 AI 替老师自动给家长发简报
- 禁止在课后记录中暴露真实姓名
- 禁止拖过 24 小时才记录
- 禁止课时消耗不透明
- 禁止在简报中贴负面标签
隐私与数据控制入口
本 SKILL 读写的学员数据存于共享工作空间（solo-teacher-workspace.schema.json），涉及未成年人信息，须提供可执行的控制入口。老师本人、或应学员/家长要求，可随时说：
- 查看："查看 [学员化名] 的工作空间记录 / 课表 / 作业 / 报告"
- 更正："更正 [学员化名] 的 [某字段]"（覆盖旧值，避免新旧冲突并存）
- 删除："删除 [学员化名] 的某条记录 / 全部数据"（流失学员应按约定周期删除）
- 暂停记录："这次不要记录 / 暂停记录 [学员化名]"
- 取消跨 SKILL 共享："不要把 [学员化名] 的数据共享给其他 SKILL"
校验要求：跨 SKILL 共享或建档前，须确认 consent.crossSkillSharing / consent.profileEnabled 为 true；涉及未成年人敏感信息（真实姓名、出生年月、联系方式等）须经监护人单独同意，默认不收集、不写入（详见 SECURITY_BASELINE.md）。
十四、参考资源
references/lesson-log-template.md — 课后记录 5 维度框架与填写模板、学习轨迹视图、衔接建议模板、家长简报模板（含分场景话术）、评估尺度与自检清单
💡 小智说：
"独立教师最贵的资产不是课时费，
是累积起来的教学档案。
一年下来，你有了 50 个学员的成长轨迹，
50 个真实的案例，50 套可复用的方法——
这些是新老师花 3 年也攒不来的东西。"
