quanke-qimo-jijiu

agent
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 10 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

全科期末急救(ReviewCraft)— 把课件、教材、录音、往年题变成能直接打印的复习资料:知识点汇总、章节练习、模拟卷+答案。适用于任何 AI Agent,不绑定客户端。

README.md

全科期末急救 · ReviewCraft

全科复习资料生成器:把课件、教材、录音、往年题,变成一套能直接打印的复习资料——知识点汇总、章节练习、3–5 套模拟卷 + 答案。

English name: ReviewCraft

ReviewCraft 是一套给 AI Agent 用的工作流包(Skill),不绑定任何客户端:对话式 Agent、CLI Agent、IDE 里的助手、本地模型都可以,只要它能读文件、能跑命令。它不是一个独立程序,而是「流程 + 模板 + 校验脚本」:你先给它课程材料,它先提取真实考试情报,再产出 LaTeX 排版的复习资料。


它解决什么问题

大多数“AI 帮我出套卷子”的结果是:题型不对、没有留白、答案和题目混在一起、案例要学生自己翻书。ReviewCraft 把这些问题前置成规则:

  1. 先提取考试情报,再动笔
    题型分值、范围与排除章节、命题依据(教材 / PPT / 两者 / 往年题)、重点、术语差异。没有情报就先问,不猜。

  2. 大题必须留答题空间
    简答 3–4cm、论述 9–12cm、案例每小问 3–4cm,写进规则并由脚本检查;没有留白的卷子直接判失败。

  3. 案例题自包含
    500–900 字,学生不需要教材或原始案例 PDF;案例框与问题不分页。

  4. 按课程类型换打法
    工科看步骤分与单位,文科看论证与文本证据,思政看官方表述与踩点,商科看法学看涵摄、医学看鉴别诊断。

  5. 图和答案不能缺
    知识点汇总默认配 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/文本)+ 标准答案,它会:

  1. 逐题判对错,标错因(概念不清 / 方法不会 / 计算失误 / 审题偏差 / 步骤缺失 / 时间不够 / 空白)
  2. 映射到知识点,算掌握度(红 / 黄 / 绿)
  3. 出「补弱卷」:每个红点 2 道变式 + 1 道综合,换情境、不抄原题
  4. 产出复盘报告 + 补弱卷 + 答案

不传卷子也行,直接说“我第 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 卡(题型分值、范围、命题依据、薄弱章节、剩余时间、套数与答案详略),确认后再生成;没回答的项标“默认”,之后可以改。

生成后建议流程:

  1. 用 references/quality_check.py 过一遍所有 .tex
  2. xelatex 编译两遍
  3. 检查每份 PDF 的页数与留白
  4. 把 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

Star History Chart

License

MIT. 见 LICENSE。

Reviews (0)

No results found