期末复习管家:一个会跟着进度重排计划的 AI 备考 Skill
本文是「AI校园达人」赛题(学习成长赛道)的参赛作品介绍。附件为完整 Skill 安装包(含 README),可直接安装试用。
一、期末周的四个真实痛点
每到考试周,多数同学的复习流程是这样的:
- 资料散:课件、笔记、老师划的重点散在十几个文件里,动手前的第一关是"到底考什么";
- 计划靠感觉:打开表格排个复习表,通常撑不过三天就和现实脱节;
- 计划不住进日历:表格是表格,手机日历是手机日历,到点提醒全靠自觉;
- 自测没题:想检验学没学会,翻遍资料也凑不出一套带解析的自测卷。
更关键的是,市面上的"复习计划生成器"基本都是一次性的——生成那一刻很完美,第二天实习一忙,计划就成了废纸。
「期末复习管家」想解决的就是这件事:做一个跟着进度走的备考管家,而不是一次性生成器。
二、四件交付物 + 一个闭环
对 Skill 说一句话(课程名、考试日期、材料路径、每天可用时长),它产出四个文件:
| 交付物 | 内容 |
|---|---|
知识点清单.md |
从课件/笔记提炼 20–60 条知识点,标注 ★ 重要度与"会 / 模糊 / 不会"自评 |
复习计划.md |
今天 → 考试日的逐日安排:全量精刷 + 冲刺自测两轮,穿插艾宾浩斯间隔复习(1/2/4/7/15 天) |
复习计划.ics |
同一份计划导入手机/电脑日历:每个复习时段 15 分钟前提醒,考试日为全天事件 |
自测题.md |
按章节出题,★★★ 知识点全覆盖,答案解析统一放文末方便"先做后对" |
真正把它与"生成器"区分开的,是第五件事——进度更新闭环:
用户:第二章刷完了,这周实习忙,晚上只有 1 小时
Skill:① 更新知识点自评
② 以今天为新起点重排剩余计划
③ 重新生成 .ics(日历始终反映最新计划)
④ 明确告知:按新时长覆盖率降到 78%,砍掉了 ★ 级内容
【此处插入截图:四件套产出目录 + 导入日历后的效果,建议本地上传】
三、三个关键设计决策
3.1 用"重要度 × 自评"驱动排程,而不是平均用力
每个知识点带两条元数据:重要度(由材料标题层级、重复频次、老师划重点推断)与自评。排程规则:"会"压缩到基准时间的 1/3 只做确认,"模糊"按基准,“不会”×1.2 并排章内最前。单日超载时的砍级顺序是 ★ → ★★,★★★ 尽量不动,并且 skill 指令里写死一条:砍掉了什么、覆盖率剩多少,必须明说。假装排得下,比承认覆盖不了危险得多。
3.2 计划要住进日历:.ics 而不是一张表格
表格计划最大的问题是"不主动找人"。改成 .ics 后,复习块就是带提醒的日历事件,到点就响。这里有个刻意设计——事件粒度是"时段"而非"知识点":工作日整晚一个事件、周末按 2 小时切段,当日任务清单写进事件描述。若每个知识点一个事件,一个月的计划会生成上百条事件,直接淹没日历。
3.3 确定性的归脚本,易变的归指令
exam-review-planner/
├── SKILL.md 触发条件 + 六步工作流(< 500 行)
├── references/
│ ├── scheduling.md 排程算法:天数分档、负载控制、多课均衡
│ └── quiz-design.md 出题规范:优先级、干扰项设计、答案后置
└── scripts/
└── make_ics.py .ics 生成器(仅 Python 标准库,不到 200 行)
两条经验:其一,description 是 skill 唯一常驻上下文的字段,触发词要写得"主动"一些——中英混排(期末 / 备考 / 复习 / final exam / review plan),把"用户没明说要做计划"的场景也罩住;其二,模型手写 ICS 每次都可能格式出错(转义、折行全是细节),确定性工作沉淀成脚本,一次写对、处处复用。
四、手写 ICS 的四个坑
make_ics.py 不到 200 行,但每个坑都真实踩过:
坑 1:75 字节行长按字节算,不按字符算。 RFC 5545 要求内容行 ≤ 75 字节。中文 UTF-8 每字 3 字节,按字符截断会把多字节字符切成两半,导入即报错。折行还必须保证续行以单个空格开头:
while len(data) > 75:
cut = 75
while cut > 0 and (data[cut] & 0xC0) == 0x80: # 不切断多字节字符
cut -= 1
parts.append(data[:cut].decode("utf-8"))
data = b" " + data[cut:]
坑 2:转义只针对 ASCII 标点。 , ; \ 与换行需要转义;全角的",;"不是特殊字符、不要动——中文输入的真实场景几乎全是全角。
坑 3:Windows 的 CRCRLF。 open() 不带 newline="" 会把 \n 翻译成 \r\n,而我们手动写入的本来就是 \r\n,叠加后变成 \r\r\n:
open(path, "w", encoding="utf-8", newline="")
坑 4:全天事件的 DTEND 是排他边界。 12 月 20 日的考试全天事件,DTEND 要写 12 月 21 日;再配 VALARM 的 -PT15M 提醒与不带时区的浮动本地时间,保证跨设备导入行为一致。
五、测试方法:让子代理假装学生
Skill 类作品最难验证的是"指令写得对不对"。我分了两层:
脚本层:对转义与折行做单元验证,用 chr(44) 这类方式构造特殊字符,避免测试脚本自身被 shell 转义干扰(这个坑让我白跑了一轮测试)。
流程层:派一个子代理只带 SKILL.md 与一条模拟请求(“高数 12.20 期末考,笔记在某路径,平时晚上 2 小时”),完整执行并要求它报告"指令含糊、矛盾之处"。它产出了四件套(26 条知识点 / 34 个复习日 / 43 个日历事件 / 16 道自测题),同时揪出 8 条指令问题,其中三处是数字互相打架的硬伤:
- “冲刺轮保留至少一周” 与 “第 1 轮在 D-7 结束”(照此冲刺轮不足一周);
- 出题数量的 4 个约束在数学上无法同时满足;
- 示例把日期写死成"11-16 周日"——那天实际是周一,模型照抄必错。
8 条全部修复后重新打包。这轮"让 AI 审 AI"的测试,比自己反复通读指令高效得多。
六、使用方式与已知边界
安装:把 exam-review-planner/ 目录放入 ~/.agents/skills/(或项目 .agents/skills/),重启会话即可被自动发现。触发示例:
- 「高数 12.20 期末考,笔记在 ./笔记/,每天晚上 2 小时,帮我做复习计划,最好能进日历,再出点题自测」
- 「这周实习,计划往后顺延一下」
- 「第二章刷完了,更新进度」
已知边界(诚实声明):照片/扫描件材料的识别未充分测试;"时间不足砍知识点"的分支因测试场景时间充裕未触发;知识点重要度是模型推断,重要考试建议人工校对一遍清单再开工。
七、写在最后
这个 Skill 的本质不是"AI 帮你排计划",而是把复习的状态(知识点 × 掌握度 × 剩余时间)维护在一个随时可重算的模型里——计划因此能跟着人走,而不是让人迁就计划。期末只是第一个场景,同样的骨架稍作替换就能迁移到考研冲刺、考证备考。
- 点赞
- 收藏
- 关注作者
评论(0)