古诗文背诵计划器（教育 · 完整件 v2.0）
> 教育行业 Skill 完整件 v2.0。核心引擎 scripts/engine.py（纯标准库）已通过 30 项验收自检（含文件级发布纪律检查）。
> 版权与署名：见 NOTICE.md；产出物末尾自动附带 IP 印章。
定位
背古诗文最大的敌人不是难，而是遗忘。 本 Skill 用艾宾浩斯遗忘曲线（1/2/4/7/15/30 天复习间隔）把「背了就忘」变成「背了就记住」：输入学段（小学/初中/高中/成人自修）与计划周期，自动生成每日新背篇目 + 复习队列，配合打卡、抽查、进度追踪形成完整闭环。
核心洞察：学习效果 = 首次学习 × 及时复习。没有复习计划的背诵，一周后留存率不到 30%；按遗忘曲线间隔复习，留存率可提升至 90% 以上。本 Skill 让「复习」这件事自动化、可追踪。
适用对象
- K12 学生（小学/初中/高中必背古诗文）
- 陪读家长（帮孩子制定背诵计划、追踪进度）
- 成人学习者（国学自修、诗词爱好者）
- 语文教师（班级背诵计划辅助工具）
核心功能
| 命令 | 功能 | 输入 | 输出 |
|---|---|---|---|
plan |
生成背诵计划 | 学段 + 周期 + 每日篇数 | 篇目计划表（首背日 + 6 个复习日） |
recite |
今日背诵清单 | 学段 + 周期 | 今日新背 + 复习队列 + 建议用时 |
checkin |
打卡 | 篇目 + 学段 | 记录完成，累计打卡 + 连续天数 |
quiz |
抽查测试 | 学段 + 数量 [+ mark/unmark 易错] | 随机篇目 + 名句 + 易错标记/移除 |
list |
篇目库 | 学段（可选） | 36 首篇目库，按学段查看 |
streak |
连续打卡统计 | - | 连续天数 + 今日状态 |
progress |
进度总览 | - | 累计打卡/学段分布/高频篇目/易错篇目 |
profile |
深度感知档案 | - | 用户背诵习惯沉淀 |
selftest |
验收自检 | - | 文件级 + 功能级全量检查 |
工作流（命令行）
# 1) 生成 30 天初中背诵计划（每日 1 篇）
python scripts/engine.py plan --stage 初中 --days 30 --per_day 1
# 2) 今日背诵清单（新背 + 复习队列）
python scripts/engine.py recite --stage 初中 --days 30 --per_day 1
# 3) 打卡 + 抽查（含易错标记）
python scripts/engine.py checkin --title 静夜思 --stage 小学
python scripts/engine.py quiz --stage 高中 --num 5
python scripts/engine.py quiz --stage 初中 --mark 观沧海 # 标记易错
python scripts/engine.py quiz --stage 初中 --unmark 观沧海 # 移除易错
# 4) 篇目库 + 连续打卡 + 进度
python scripts/engine.py list --stage 小学
python scripts/engine.py streak
python scripts/engine.py progress
# 5) 自检
python scripts/engine.py selftest
# 程序化消费：任意命令加 --json 只输出 JSON
python scripts/engine.py plan --stage 初中 --json
艾宾浩斯记忆法说明
- 复习间隔：1 / 2 / 4 / 7 / 15 / 30 天（背完当天为第 0 天）
- 科学依据：遗忘在学习之后立即开始，先快后慢。间隔 24 小时内首次复习，留存率提升最显著
- 使用建议：首背不追求一次成功；睡前复习当日篇目；每周日全量回顾一次
- v2.0 新增：连续打卡统计（
streak）——连续打卡是背诵成功的最大杠杆
篇目库（v2.0 扩充至 36 首）
- 小学 9 首（静夜思/春晓/咏鹅/登鹳雀楼/望庐山瀑布/绝句/悯农/江南/山行）
- 初中 9 首（观沧海/次北固山下/天净沙·秋思/岳阳楼记/醉翁亭记/出师表/水调歌头/酬乐天/行路难）
- 高中 9 首（赤壁赋/劝学/离骚/蜀道难/琵琶行/登高/念奴娇/永遇乐/声声慢）
- 成人自修 9 首（将进酒/春江花月夜/滕王阁序/水调歌头/蜀相/雨霖铃/满江红/岳阳楼记全文/兰亭集序）
- 抽查时附名句速记（10 首常用名句），背诵输出更实用
深度感知数据沉淀
- 运行时生成
assets/poetry-profile.json（学段分布/篇目背诵次数/累计打卡/易错篇目/连续打卡日期），越用越懂用户的背诵习惯。 - 档案 schema 见
assets/poetry-profile-schema.json；打包发布时排除运行时档案。
A2A 接口
- 事件：
edu.poetry.recitation（version 2.0.0，payload 含 stage/plan_days/checkin_count/streak_days/mistake_titles） - 供学习计划类智能体订阅：背诵打卡完成后可通知学习计划制定师同步学习进度。
验收标准（selftest 30 项）
文件级发布纪律（9 项）：SKILL.md/README.md/NOTICE.md/schema 存在 / license 收紧为 CC BY-NC-SA / SKILL.md 声明 2.0.0 / engine banner 版权注释（第 3 行）/ 打包排除运行时档案
功能级检查（21 项）：艾宾浩斯复习间隔 / 学段识别 / 复习间隔常量 / 四学段覆盖 / 每学段 ≥9 首 / 总量 ≥36 首 / 打卡写档案 / 打卡含连续天数 / 打卡校验不存在篇目 / 标记易错真正写入档案 / 抽查含名句 / 取消易错真正写入档案 / 篇目库四学段 / 连续打卡统计 / 进度总览 / 今日背诵队列 / A2A 事件常量与版本 2.0.0 / 产出物可 JSON 序列化 / 印章在 rendered 末行 / 版本号统一 2.0.0
变更记录（Changelog）
- v2.0.0（2026-08-13）：修复 v1.0 的假功能缺陷（
mistake_titles只读不写 → 新增quiz --mark/--unmark真实写入）；篇目库 24→36 首；新增list篇目库、streak连续打卡、名句速记；打卡增加篇目存在性校验；selftest 升级 30 项并内建文件级发布纪律检查。 - v1.0.0（2026-08-13）：首版，艾宾浩斯背诵计划 + 四学段篇目库 + 打卡/抽查/进度闭环。
合规红线
- 篇目内容与作者信息来自通用教材常识，不作版本考证承诺；正式考试以官方教材为准
- 不替代语文教学，仅作背诵辅助工具
- 未成年人个人信息仅存本机，不对外传输
