quanke-qimo-jijiu
Health Uyari
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Gecti
- Code scan — Scanned 10 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
全科期末急救(ReviewCraft)— 把课件、教材、录音、往年题变成能直接打印的复习资料:知识点汇总、章节练习、模拟卷+答案。适用于任何 AI Agent,不绑定客户端。
全科期末急救 · ReviewCraft
全科复习资料生成器:把课件、教材、录音、往年题,变成一套能直接打印的复习资料——知识点汇总、章节练习、3–5 套模拟卷 + 答案。
English name: ReviewCraft
ReviewCraft 是一套给 AI Agent 用的工作流包(Skill),不绑定任何客户端:对话式 Agent、CLI Agent、IDE 里的助手、本地模型都可以,只要它能读文件、能跑命令。它不是一个独立程序,而是「流程 + 模板 + 校验脚本」:你先给它课程材料,它先提取真实考试情报,再产出 LaTeX 排版的复习资料。
它解决什么问题
大多数“AI 帮我出套卷子”的结果是:题型不对、没有留白、答案和题目混在一起、案例要学生自己翻书。ReviewCraft 把这些问题前置成规则:
先提取考试情报,再动笔
题型分值、范围与排除章节、命题依据(教材 / PPT / 两者 / 往年题)、重点、术语差异。没有情报就先问,不猜。大题必须留答题空间
简答 3–4cm、论述 9–12cm、案例每小问 3–4cm,写进规则并由脚本检查;没有留白的卷子直接判失败。案例题自包含
500–900 字,学生不需要教材或原始案例 PDF;案例框与问题不分页。按课程类型换打法
工科看步骤分与单位,文科看论证与文本证据,思政看官方表述与踩点,商科看法学看涵摄、医学看鉴别诊断。图和答案不能缺
知识点汇总默认配 6–15 幅 TikZ 图(机制图、分类树、时间线、曲线、损益图),不等用户开口;答案册每题选择题给“正确项 + 三个干扰项为什么错”,画图题必须给标准答案图;草稿区和画图答题区都是空白,不放方格纸。
输出什么
默认 2 + 2N 个核心文件,再加 0–3 个附件(N = 模拟卷数量,默认 5;共 12–15 个):
| 文件 | 内容 |
|---|---|
01_知识点汇总.pdf |
按章考点、对比表、易错点、考前速览;默认配 6–15 幅 TikZ 图 |
02_章节练习.pdf |
分章练习,答案随题附后 |
03_模拟卷A.pdf + 04_模拟卷A_答案.pdf |
第一组章节(基础) |
05_模拟卷B.pdf + 06_模拟卷B_答案.pdf |
核心章节 |
07_模拟卷C.pdf + 08_模拟卷C_答案.pdf |
综合/跨章 |
09_模拟卷D.pdf + 10_模拟卷D_答案.pdf |
提高卷(默认包含) |
11_模拟卷E.pdf + 12_模拟卷E_答案.pdf |
挑战卷(默认包含) |
13_考前速查卡.pdf |
一页纸:公式、易错点、答题模板(可选) |
14_复习计划.pdf |
从考试日期倒排的每日计划:每天三块、间隔重复、限时卷、红黄绿优先级(可选) |
15_错题本.pdf |
复盘累积的错题清单(可选) |
NN_课本OCR_考点章节/ |
扫描版教材的文字版(可选) |
_tex源文件/ |
全部 .tex,可自行改题重编译 |
答案文件逐问给评分点,不是整段范文。每道选择题都有逐项详解(正确项 + 三个干扰项为什么错);每道画图题都有标准答案图。
难度阶梯
默认就出 5 套,后两套是 D 提高 / E 挑战;时间紧可以只要 A–C。难度不是靠删条件或模糊题干,而是在信息完整的前提下把思考加深:
| 维度 | A/B/C 基础 | D 提高 | E 挑战 |
|---|---|---|---|
| 知识跨度 | 单点 | 2–3 个概念联动 | 跨章整合 |
| 推理步数 | 1–2 步 | 3–4 步 | 多步 + 需说明决策规则 |
| 设问动词 | 说明/分析 | 比较/应用 | 评价/决策/预测 |
| 干扰强度 | 无 | 相似概念干扰(仍可解) | 两个框架都通,需论证取舍 |
| 易错点 | 无 | 1 个经典误区 | 2–3 个边界条件 |
先分清三类题:
| 类型 | 特征 |
|---|---|
| 基础题 | 单一概念、一步到位 |
| 难题 | 多概念联动、多步推理、跨章整合 |
| 易错题 | 信息完整,但含常见误区或边界条件 |
硬规则:题干必须自足(条件、数据、约束齐全),不删条件、不制造矛盾、不模糊设问;D/E 仍严格限定在考试范围内。易错 ≠ 超纲 ≠ 缺条件。
套卷编号说明
A/B/C/D/E 只是套卷编号,不是难度等级:
| 编号 | 文件名 | 定位 |
|---|---|---|
| A | 03/04 | 卷一:前半章节(基础) |
| B | 05/06 | 卷二:核心章节 |
| C | 07/08 | 卷三:后半 + 综合 |
| D | 09/10 | 卷四:提高(可选) |
| E | 11/12 | 卷五:挑战(可选) |
默认出 A–E 五套;时间紧可以只要 A–C(三套)。
核心设计
0. 先问清楚,再动笔
题型分值、考试范围、命题依据(教材/PPT/往年题)、薄弱章节、剩余时间、套数与答案详略——缺一项就问,不猜。没回答的项按默认生成并在首页标注。
1. 命题依据是变量
不同课不一样:有的以教材为准,有的以 PPT 为准,有的看往年题。Skill 会记录 textbook / PPT / both / past papers,术语主次跟着走:
- 教材为准 → 教材说法为主,课件说法括号备注
- PPT 为准 → 反之
- 两者/混合 → 用题干里的说法,附术语对照
2. 情报分级
| 手上有什么 | 能推出什么 |
|---|---|
| 完整录音/转录 | 题型、范围、排除、重点、术语 |
| 教学大纲 | 章节、权重、有时有题型 |
| 近 3–5 年真题 | 题型、风格、重复考点 |
| 只有课件 | 考点、术语、重点标记 |
| 只有教材 | 章节结构,题型未知 |
| 什么都没有 | 只问两个问题:题型、范围 |
3. 课程类型不同,卷子不同
| 类型 | 评分逻辑 | 致命错误 |
|---|---|---|
| 工科 | 步骤分:公式→代入→结果→单位 | 只写结果、单位错、图无标注 |
| 文科 | 观点 + 论据 + 结构 + 表达 | 罗列不论证、无文本证据 |
| 思政 | 踩点给分,关键词必须官方表述 | 口语化、自由发挥、引用错 |
| 商科 | 框架 + 案例事实 + 建议 | 只背理论不结合案例 |
| 法学 | 结论 → 依据 → 涵摄 | 结论无依据、援引失效法条 |
| 医学 | 诊断 → 依据 → 鉴别 → 处理 | 漏鉴别诊断 |
详细打法见 skills/latex-review-materials/references/course-types.md。
4. 大题不只有案例
试卷的“大题”按学科选形态,不是一律论述:
| 大题类型 | 适用 | 评分重点 |
|---|---|---|
| 计算题 | 投资学、金融、会计、工程 | 公式 30% / 代入 30% / 结果 30% / 单位 10% |
| 证明 / 推导 | 数学、理论、算法 | 思路 40% / 关键步骤 40% / 结论 20% |
| 画图 / 设计 | 电子、机械、土木、网络 | 拓扑 40% / 参数标注 30% / 规范 30% |
| 编程题 | 计算机、数据科学 | 正确性 50%(含边界)/ 复杂度 20% / 结构 20% / 清晰 10% |
| 案例分析 | 管理、法学、医学 | 框架 40% / 事实 30% / 结论 30% |
| 材料分析 / 论述 | 人文、思政 | 观点 / 依据 / 结构 / 表达 |
编程题会写清输入输出样例、数据范围、是否允许伪代码;计算题会写清公式表、单位、假设与舍入规则。
5. 复盘模式(上传卷子 → 补弱)
做过的卷子也能用。上传答卷(照片/PDF/文本)+ 标准答案,它会:
- 逐题判对错,标错因(概念不清 / 方法不会 / 计算失误 / 审题偏差 / 步骤缺失 / 时间不够 / 空白)
- 映射到知识点,算掌握度(红 / 黄 / 绿)
- 出「补弱卷」:每个红点 2 道变式 + 1 道综合,换情境、不抄原题
- 产出复盘报告 + 补弱卷 + 答案
不传卷子也行,直接说“我第 5 章不会”,它按单点补弱出阶梯题。
6. 输出格式可选:PDF / DOCX / 离线交互复习网站(HTML)
- PDF(默认):LaTeX 排版,最适合打印和整卷限时模考。
- DOCX:走 Markdown + pandoc,标注“best effort”(tcolorbox 变引用块,公式转 Word 公式)。Pandoc 没装会提示安装命令,装不上就回退 PDF。
- HTML 离线交互复习网站(Markdown 驱动,可与 PDF 组合交付):基于
references/build_unit.py与references/templates/study-site/,只需在unit/下写标准 Markdown(#自动分栏、##自动星级卡片、:::qa单题切换答案、```mermaid流程图),一键编译成可本地离线打开的复习网站,自带:- 侧栏章节导航 + 平行板块分栏 + 复习进度条(
localStorage持久化) ★★★★★~★★星级考点筛选条 + 记忆强化排版(彩色序号、箭头列表、加粗荧光高亮、暖金斜体)- 🧠 默写模式:一键模糊全部加粗关键词,单击某处单独显示/重新遮盖
- 单题独立切换答案与采分点 + 一键全部展开/收起
- 平行
📄 原始课件栏(PDF 懒加载内嵌预览 + Word 原件下载)与非吸顶移动端友好布局 - 完整语法与构建规范见
skills/latex-review-materials/references/web-site-builder.md。
- 侧栏章节导航 + 平行板块分栏 + 复习进度条(
7. 复习计划与速查卡
给出考试日期、每天可用小时、目标分和 2–4 个薄弱点,生成倒计时每日计划(复习计划.pdf + .md + .plan.json):
- 自动算剩余天数,考前一天只复盘,最后一个学习日固定整卷限时;
- 按「考试权重 × 掌握度」分优先级(红 1.6 / 黄 1.2 / 绿 0.7);
- 每天三块:上午主攻、下午练习、晚上间隔复习;留 15% 时间缓冲;
- 知识点在 D+1 / D+3 / D+7 回顾;排不下的低频点只进速查,不硬塞主块;
- 支持 14/10/7/5/3/2/1 天骨架,1 天自动切成「急救单」;
- 改日期或权重后重跑脚本即可重排。
另外考前一周出 1 页速查卡(公式、易错点、答题模板、Top 10 错题)。
8. 质量闸门
- 计算题用 Python/sympy 复算,答案标“已验算”
- 编程题跑样例 + 边界,标“已跑样例”
- 图清单:知识点汇总默认 6–15 幅图,逐幅检查文字与图一致
- 答案册:15 道选择题逐项详解;画图题有标准答案图
- 卷面:草稿区/画图区空白,无方格、无坐标纸
- 跨卷去重:题干相似度 >0.85 报警
- 难度分布:easy/medium/hard 目标 40/40/20
- 5 套卷分 3 批生成,
progress.md断点续跑
9. 资料形态可选
- 省墨讲义(默认):单栏、5 号字、1.5cm 边距、细线框、无填色,打印最省纸
- 彩框版:彩色重点框,适合屏幕阅读
- 双栏速查:9pt 双栏,适合考前 1–2 天
- 题目册 + 答案册:两本独立文档,方便反复自测
模板在 references/templates/ink-saving.tex,说明在 references/layout-presets.md。
图模板在 references/templates/figures.tex(时间线/分类树/曲线/损益图/空白答题区)。
快捷指令(单选 / 自由组合 / 全套生成)
仓库在 commands/ 下内置了 7 个模块化指令文件,既可单独生成某一类资料,也可自由组合任意几类,或一键生成全套(支持直接放进支持自定义命令的 Agent 目录,或直接把指令路径/名称告诉 Agent):
| 指令 | 文件 | 作用 | 使用示例 |
|---|---|---|---|
/review-all |
commands/review-all.md |
全套一键生成(知识点 + 练习 + 模拟卷与答案 + 速查卡 + 复习计划 + 离线复习网站) | /review-all F:\课程\战略管理 2026-12-05 |
/review-pick |
commands/review-pick.md |
自由组合任意几类(notes / exercises / exams / site / card / plan / fix) |
/review-pick F:\课程\战略管理 notes,site,exams |
/review-notes |
commands/review-notes.md |
单独生成知识点汇总 PDF(可选 --with-card 附一页速查卡) |
/review-notes F:\课程\战略管理 --with-card |
/review-exams |
commands/review-exams.md |
单独生成章节练习 + 模拟卷 A–C/A–E 与独立答案册 PDF | /review-exams F:\课程\战略管理 A-C |
/review-site |
commands/review-site.md |
单独生成离线交互复习网站 HTML(平行分栏、星级筛选、Mermaid、单题切换、默写模式、原课件) | /review-site F:\课程\战略管理 |
/review-plan |
commands/review-plan.md |
单独生成倒计时每日复习计划(可选 --with-card 附速查卡) |
/review-plan 2026-12-05 4h 第五章 |
/review-fix |
commands/review-fix.md |
单独执行错题复盘 + 补弱卷与答案 + 错题本 | /review-fix F:\课程\模拟卷A_已作答.pdf |
怎么用
不需要安装任何客户端,也没有运行时依赖。三选一:
方式一:直接交给对话里的 Agent
把 skills/latex-review-materials/ 文件夹(或其中的 SKILL.md + references/)拖进对话,或者让 Agent 读取这个目录,然后说:
按这个 skill 帮我做「战略管理」的复习资料,材料在 F:\课程\战略管理\
方式二:放进 Agent 的 skills / 规则目录
如果你的 Agent 支持自定义 skill、rules 或 instructions 目录,把 latex-review-materials/ 整个复制进去即可。目录名保持 latex-review-materials,与 SKILL.md 的 name 字段一致;具体路径取决于你用的 Agent,不是固定的。
方式三:CLI Agent
把仓库路径直接告诉它:
读 C:\path\to\reviewcraft\skills\latex-review-materials\SKILL.md,
按里面的流程帮我做复习资料。
说明:这个仓库只包含
SKILL.md、Markdown 参考文档和一个 Python 校验脚本,没有二进制、没有服务端、没有账号体系,所以任何 Agent 都能直接用。
使用
直接给材料 + 一句需求:
F:\课程\战略管理\ 先看课件和考点录音,按考试题型出三套模拟卷,
最后一题用文件夹里的案例,大题下面留写答案的空白。
Agent 不会直接开写:先发一张 6 项的 intake 卡(题型分值、范围、命题依据、薄弱章节、剩余时间、套数与答案详略),确认后再生成;没回答的项标“默认”,之后可以改。
生成后建议流程:
- 用
references/quality_check.py过一遍所有.tex xelatex编译两遍- 检查每份 PDF 的页数与留白
- 把 PDF 和
_tex源文件一起交付
依赖
| 依赖 | 用途 | 必需 |
|---|---|---|
| TeX Live(xelatex + ctex/fandol) | 编译 PDF | 是 |
| Python 3.9+ | 质量检查脚本 | 是 |
| PaddleOCR + onnxruntime-gpu | 扫描版教材 OCR | 可选 |
| ffmpeg / whisper | 录音转写 | 可选 |
OCR 参考速度:200 dpi 下 GPU(RTX 4070)约 1.5 秒/页,CPU 约 30 秒/页。
目录结构
reviewcraft/
├── README.md
├── LICENSE
├── .gitignore
├── commands/ # 模块化快捷指令(单选 / 自由组合 / 全套生成)
│ ├── review-all.md # /review-all 全套一键生成(PDF套件 + HTML网站)
│ ├── review-pick.md # /review-pick 自由组合任意几类模块
│ ├── review-notes.md # /review-notes 单独生成知识点汇总(+可选速查卡)
│ ├── review-exams.md # /review-exams 单独生成模拟卷与章节练习
│ ├── review-site.md # /review-site 单独生成离线交互复习网站
│ ├── review-plan.md # /review-plan 单独生成倒计时复习计划
│ └── review-fix.md # /review-fix 错题复盘与定向补弱卷
└── skills/
├── latex-review-materials/
│ ├── SKILL.md
│ └── references/
│ ├── course-types.md # 分课程类型打法
│ ├── exam-blueprint.md # 试卷模板 + 留白表 + 交付清单
│ ├── review-mode.md # 复盘补弱:诊断表/报告/补弱卷模板
│ ├── study-plan.md # 倒计时计划:算法 / 天数骨架 / 重排规则
│ ├── make_plan.py # 生成 复习计划.md/.tex/.plan.json
│ ├── output-formats.md # PDF / DOCX / HTML 交互复习网站流程
│ ├── web-site-builder.md # HTML 交互复习网站构建与 Markdown 规范
│ ├── build_unit.py # Markdown -> HTML 静态复习页编译器
│ ├── exam_lint.py # 跨卷去重 / 难度分布检查
│ ├── latex-format-rules.md # LaTeX preamble 与排版规则
│ ├── quality_check.py # 编译前自动检查
│ └── templates/
│ ├── plan.example.json # 计划输入模板
│ ├── ink-saving.tex # 省墨讲义模板
│ ├── figures.tex # TikZ 图模板
│ └── study-site/ # 离线交互复习网站静态模板
└── course-review-template/ # 独立的离线复习网站生成 Skill(Markdown 驱动)
├── SKILL.md
├── scripts/
│ └── build_unit.py # Markdown -> HTML 编译器(支持单文件/整目录)
└── assets/
└── study-site/ # 完整离线网站模板(含本地 vendor/mermaid.min.js、默写模式等)
质量检查覆盖什么
quality_check.py 会检查:
enumerate是否配对- tcolorbox 标题里是否有嵌套
[或英文逗号(会触发 pgfkeys 报错) - 试卷是否留了答题空间(
\vspace少于 3 处判失败) - 试卷里是否混入了“参考答案/评分标准”
fancyhdr是否混入中文- 是否使用了 emoji(LaTeX 不支持)
不做什么
- 不替代你的课程材料:没有课件/教材/录音,它只能给通用模板。
- 不保证押中题:它按“考试情报 + 课程重点”组织,不预测具体题目。
- 不生成答案以外的“标准答案”:文科与思政的答案给要点与评分点,不是唯一解。
Star History
License
MIT. 见 LICENSE。
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi