<!-- ✎ 教师每日复盘 · v1.0.0 · 开发：Dr.dangII（未来教育探索者） · SkillHub @user_704585ca · 首发 2026-10-06 · 二次分发请注明出处 -->
教师每日复盘
> 开发署名：Dr.dangII（未来教育探索者） · SkillHub @user_704585ca · v1.0.0 · 首发 2026-10-06
概述
帮教师把每天的教学触动，整理成一篇结构化的「每日复盘」，并写入 ima 笔记。
素材通常来自口述（语音转写）或随手记下的一段文字——可能是一篇文章、一节课、一本书、一次对话、一个课堂瞬间。复盘的目的是沉淀教学思考，而不是写流水账。它的内核只有一句话：从一件具体的小事出发，联想到自己的课堂，最后提炼一个认知增量。
三段式模板（每篇固定，不可省略）
🔍 触发点：（今天触动你的那件事 / 那句话 / 那篇文章，保留细节与原话）
🏫 联想课堂/学生：（由触发点联想到自己的课堂、学生或教学）
💡 一个收获：（一句话提炼今天真正学到的东西）
判断三段是否到位：
- 触发点要具体——有时间、有场景、有原文细节，不能是抽象概括
- 联想要落到自己的课堂——不是复述触发点，而是它让你想到了自己教学的哪一点
- 收获要是认知增量——不是抒情感叹，而是观念上真正被改写的那一处
格式规范
标题：一级标题，格式为 # 【每日复盘】DAYn MM/DD（星期X）
- 例：
# 【每日复盘】DAY71 10/05（星期一）
编号 DAYn：复盘的累计天数，与真实日期一一对应、逐日连续（相邻两个真实日期，对应相邻两个编号）。因此：
- 写当天：取笔记中最近一篇的编号 + 1
- 补写往期：用「最近已知编号 − 日期差」反推该日期应有的编号，不要一律续接最新号
- 用户若尚无编号体系：从其首篇复盘当天记为 DAY1，之后逐日递增
篇末：固定署名 + 一句金句（从当天原话中提炼，不要另起炉灶）
复盘者:<用户署名>
<当天金句>
使用前提（ima 凭证）
本技能要写 ima 笔记，需要调用 ima OpenAPI。首次使用前请自备凭证：
- 在 ima 开放平台取得
clientid与apikey - 以环境变量方式注入：IMA_OPENAPI_CLIENTID / IMA_OPENAPI_APIKEY
- 确认要写入的复盘笔记存在；没有则先新建一本「每日复盘」
凭证只在本机使用，不会随技能上传。
首次使用：先确认三件事
第一次为某位教师服务时，先确认并记住（建议存入长期记忆，之后不再重复询问）：
- 复盘笔记：写进哪本笔记？——用户已有则取得其位置/ID；没有则新建一本「每日复盘」
- 署名：篇末「复盘者」写什么？——默认署名「Dr.dangII（未来教育探索者）」，即本技能开发者；使用者若想署自己的名字，在此一并确认，之后每次沿用
- 编号起点：是否已有历史复盘？若有，首篇编号是多少、对应哪一天？
工作流
步骤 1：确定日期与编号
确认要写的是哪一天（当天，还是补写往期），据此算出 DAYn 与星期。
步骤 2：整理素材（最重要的一步）
把用户的口述/文字整理成三段式。原则：
- 保留原话细节，最小整理、不要缩水——用户的表达本身有价值，只做分段和小标题，不替用户"精简"或"升华"
- 只修正明显的病句和标点；疑似语音误识的字词，保留原表达并向用户标注询问，不要擅自改写（例：把"心灵"擅自改成"清零"，可能恰恰改错了原意）
- 不堆砌、不加"正确的废话"——用户往往反感 AI 味的信息堆砌
- 素材归属拿不准时按内容判断：事实/原文 → 触发点；联想到自己的教学 → 联想；结论 → 收获
步骤 3：写入笔记
- 写当天：追加到笔记末尾
- 补写往期（该日期早于笔记现有最末篇）：需按时间顺序插入到正确位置——先读取笔记的块结构，定位「后一天那篇的标题块」，把新内容插到它之前，保证时间顺序不乱
具体接口、参数与请求体写法见 references/api-operations.md。
步骤 4：验证（必做）
任何写入后，重新导出笔记正文，确认目标内容确实存在、位置正确。接口返回成功 ≠ 真的写入成功——历史上出现过返回成功但内容丢失的情况。
完整示例
示例 1｜写今天的复盘
> 用户口述：「今天看到一篇推文，讲'白纸是学不会任何东西的'……晚上读书会大家读同一本书，看到的东西完全不一样……」
>
> 输出（写入笔记末尾）：
>
> > # 【每日复盘】DAY70 10/04（星期日）
>
> 🔍 **触发点：** 出发点是一篇推文《为什么有人学一条经验胜过别人学一万条》……
> 🏫 **联想课堂/学生：** 这让我联想到今晚的读书会……
> 💡 **一个收获：** 白纸学不会任何东西。在保持空杯心态的同时，我们其实也是在带着已有的知识和经验进行学习。
>
> 复盘者:<署名>
>
> <从原话提炼的金句>
>
示例 2｜补写往期
> 用户：「帮我补写 10 月 4 日的复盘。」
>
> 处理：笔记最近一篇是 DAY71（10/05）→ 10/04 比它早一天 → 编号 DAY70 → 定位 DAY71 标题块 → 把 DAY70 整篇插入到 DAY71 之前 → 导出验证顺序为 DAY70 → DAY71。
避坑清单
| 坑 | 后果 | 正确做法 |
|---|---|---|
| 用 EDIT 改长文本块 | 该块被清空丢失 | 长内容一律用追加（APPEND）插入，EDIT 仅用于短块或标题 |
| 只信接口返回值 | 内容静默丢失 | 每次写入后都导出正文二次验证 |
| 一次性写入过长内容 | 可能静默失败 | 单次追加控制在一篇（不合并多篇） |
| 替用户"精简/升华" | 丢失原意与人文温度 | 保留原话，最小整理 |
| 擅改疑似语音误识的字 | 改错原意 | 保留原表达并标注询问 |
| 补写往期时续接最新编号 | 编号与日期错位 | 按真实日期反推编号，插入到正确位置 |
关联资源
references/api-operations.md—— ima 笔记写入/验证接口的参数与调用方法（执行步骤 3、4 时读取）
