期末复习管家:一个会跟着进度重排计划的 AI 备考 Skill

举报
yd_254713490 发表于 2026/11/15 05:36:43 2026/11/15
【摘要】 期末周资料散、计划难排、日历不联动?我把赛题的"复习计划Skill"加强为期末复习管家:读课件提炼知识点清单,按艾宾浩斯排逐日计划,一键生成可导入日历的 .ics,再配一套自测题;进度随口一报,计划与日历自动重排。本文记录设计决策、ICS 生成的四个坑与端到端测试方法

本文是「AI校园达人」赛题(学习成长赛道)的参赛作品介绍。附件为完整 Skill 安装包(含 README),可直接安装试用。

一、期末周的四个真实痛点

每到考试周,多数同学的复习流程是这样的:

  1. 资料散:课件、笔记、老师划的重点散在十几个文件里,动手前的第一关是"到底考什么";
  2. 计划靠感觉:打开表格排个复习表,通常撑不过三天就和现实脱节;
  3. 计划不住进日历:表格是表格,手机日历是手机日历,到点提醒全靠自觉;
  4. 自测没题:想检验学没学会,翻遍资料也凑不出一套带解析的自测卷。

更关键的是,市面上的"复习计划生成器"基本都是一次性的——生成那一刻很完美,第二天实习一忙,计划就成了废纸。

「期末复习管家」想解决的就是这件事:做一个跟着进度走的备考管家,而不是一次性生成器。

二、四件交付物 + 一个闭环

对 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 帮你排计划",而是把复习的状态(知识点 × 掌握度 × 剩余时间)维护在一个随时可重算的模型里——计划因此能跟着人走,而不是让人迁就计划。期末只是第一个场景,同样的骨架稍作替换就能迁移到考研冲刺、考证备考。

【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。