yoli-mi / good-learning-skill

# Good Learning
一个用于 AI agent 的学习与备考 skill：根据考纲、教材、真题和可用时间建立知识清单、备考计划与每日课程，再依据真实作答整理错题并调整后续安排
## 能做什么
- 分别制作知识清单和备考计划，保留知识点编号、验收标准及来源
- 按零基础或复习模式生成自成体系的每日课程，包括例题、变式、混合练习与逐步答案
- 根据用户的实际作答制作错题本；演示错误会标为模拟，不计入真实掌握状态
- 为当日复盘绘制 SVG 思维导图，可选生成 PNG 预览
- 通过 XeLaTeX 或 LuaLaTeX 编译课程、清单、计划和错题本 PDF；科目目录存放知识清单和备考计划 PDF，每日课程按日期独立成夹；各文件夹顶层只放最终 PDF，Markdown、`.tex` 和其他源文件放在对应的 `源文件` 子目录
## 输出目录
 [code] 
后续课程按真实学习进度逐日建立，用户提交作答或错题后更新对应日期的记录，并调整尚未完成的学习任务
## 安装
以codex为示例：把仓库克隆或复制为 Codex skills 目录下的 `good-learning` 文件夹，重启 Codex 或重新加载 skills 后即可使用
 [code] 
示例请求：
 [code] 
## 运行环境
- Python 3.10 或更新版本
- PDF：XeLaTeX 或 LuaLaTeX，以及 `ctex`、`amsmath`、`tikz` 等常用 LaTeX 宏包
- 总结图 PNG：Pillow，使用 `pip install -r requirements.txt` 安装
- 总结图 SVG：只需 Python 标准库
- 生成 PNG 时需提供中文字体；脚本可自动查找常见字体，也可用 `--font` 和 `--bold-font` 指定
## 脚本
 [code] 
总结图输入为 JSON，包含 `eyebrow`、`title`、`subtitle`、`status`、`description`、`core_label`、`core_title`、`core_subtitle`、`core_foot`、`workload`、`error_count`、`legend`、`note_legend`、`footer`，以及 4—6 个 `branches`；每个分支填写 `side`、`category`、`title`、`rule`、`detail`，如有错题再填写 `error.number`、`error.label`、`error.mistake`、`error.fix`；无错题时填写 `check` 与 `check_fix`
 [code] 
具体工作流程见 SKILL.md，设计与资料检索规则见 references
## 内容边界
仓库只包含 skill 指令和生成脚本，不包含教材、历年试卷、用户作答或生成的个人学习文件；使用资料时请核对来源与授权
## 许可证
MIT