这是一个基于 LLM Wiki 架构重构、全科通用的期末考试极速备考 AI 智能体技能（Agent Skill）V2.0 版本。

只要将本技能导入支持的智能体（如 VS Code 智能体插件、Claude Code、Codex、Cursor、Windsurf、Devin 或网页版 GPTs/Gemini），并提供你想要复习的科目资料，智能体就会化身你的物理防幻觉私人专属备考教练，带你在 1 天内突击通关。

• ⚡ LLM Wiki 目录结构化加载：丢弃了原先庞大且容易撑爆上下文的单个 Markdown 答案文件。升级为按章节/阶段的 Wiki 物理切片（references/wiki/），Agent 会根据复习进度 Lazy Load (惰性加载) 对应章节，Token 消耗直降 90%，长对话不再卡顿。
• 🛠️ 一键无缝冷启动：告别了手动建立题库与 Markdown 文件的繁琐操作。学生完全不需要理会复杂的 JSON 格式，只需提供大纲或真题，Agent 将在后台自动解析大纲、拼装 JSON 并通过脚本完成 Wiki 物理切片的切割与进度初始化。
• 🔌 无 Python 环境自动降级：新版增加了降级执行能力。即使学生电脑里没有安装 Python，Agent 也会无缝切换为“手动写入模式”，利用自身的文件写入功能直接在本地铺设 Wiki 目录，100% 免配置、零摩擦运行。
• 🎯 标准真题库 quiz_bank.json 抽题：测试题由“AI 即兴编造”升级为“标准真题库抽测”，规避了 AI 出无解错题、弱智题的毛病。
• 🏃 测试逃生通道 (Hint & Skip)：针对测试关卡设计了“查看提示”与“2次答错跳过并归档”机制，防止学生因主观题表述差异或卡壳而被死锁在当前阶段。

这是一个结构完备的备考智能体技能包，包含以下核心文件：

• 📂 prompts/：存放提示词。
  • 📄 web_prompt.md：【网页端一键平替提示词】 —— 专为不支持本地写盘的网页版 AI（ChatGPT / DeepSeek 网页端 / 豆包）准备，复制直接用。
• 📂 scripts/：自动化脚本。
  • 🐍 ingest.py：【一键环境初始化脚本】 —— 由 AI 助手在后台自动调用，负责一键切分 Wiki 章节、题库并部署进度表。
• 📂 templates/：备考基准模板文件。
  • 📄 study_plan_template.md：复习计划表模板。
  • 📄 study_progress_template.md：进度追踪与错题打卡表模板。
  • 📄 quiz_bank_template.json：真题抽测 JSON 模板。
• 📄 SKILL.md：【智能体技能核心】 —— 包含备考教练的系统指令、惰性加载协议和物理防幻觉协议（Cursor / VS Code / Claude Code / Windsurf 等工具在运行后会自动读取此文件）。

如果你是个从来没写过代码、甚至没听说过编程的文科/理科学生，推荐你使用以下两种极简方式开启复习：

这是最省心、也是最推荐的方案。你可以把所有的文件摆放、下载以及配置工作全部交由 AI 帮你在后台做完：

1. 新建你的复习文件夹：在你的电脑上新建一个普通的空文件夹，命名为你的学科名字（比如叫 计算机组成原理复习），并用你的 AI 软件（如 Cursor 或终端里的 Claude Code）打开这个文件夹。
2. 一键全自动安装技能 (Prompt 1)：在 AI 聊天对话框中，直接复制发送以下指令给 AI：

   “帮我在当前目录下创建 .claude/skills/ 文件夹，并把 GitHub 仓库 https://github.com/ZeKaiNie/universal-examprep-skill 克隆到 .claude/skills/universal-exam-cram-coach/，完成技能的本地安装。”

   • AI 行为：AI 助手会在后台默默下载并新建隐藏目录，完全不需要你手动拖拽文件。
   • 📌 路径说明：Claude Code 读取技能的位置是 ~/.claude/skills/ 或项目内 .claude/skills/；而 .agents/skills/ 是 Codex / Cursor 的约定，Claude Code 不会扫描该路径。请按你实际使用的工具选择对应目录。
3. 一键初始化并开始复习 (Prompt 2)：安装成功后，直接上传你的复习大纲或重点图片，发送：

   “这是我的【马原】复习大纲，请遵循刚才安装的 universal-exam-cram-coach 技能，在后台解析大纲并自动初始化我的备考 Wiki 空间。”

   • AI 行为：AI 将自动大纲解析、完成 Wiki 物理切片和进度计划生成。你只需要跟着 AI 的节奏答题复习即可！

如果你的 AI 只是普通的网页聊天对话框，无法直接修改你电脑上的本地文件，请使用本方式：

1. 第一步：复制超级提示词：直接打开本仓库下的 prompts/web_prompt.md，一键复制里面所有的超级提示词。
2. 第二步：发送提示词与大纲：把这段提示词发给网页 AI（如 ChatGPT 或 DeepSeek 网页版），接着把你的教材、大纲或重点内容作为附件或文字发送给它。
3. 第三步：开始互动复习：AI 会在聊天中直接吐出计划，并在每次回复底部附带一个“进度打卡面板”，直接根据 AI 的指引互动复习即可。

本技能在各大主流 AI 开发软件中的运行效果如下：

• Q：我的电脑没有安装 Python，或者报错“python 不是内部或外部命令”怎么办？
  • A：完全不用担心！ V2.0 增加了无 Python 环境的自动降级机制。当 Agent 在执行脚本发现你的电脑没有 Python 环境时，它会自动且静默地切换为“手动写盘模式”——由 AI 自己直接在本地创建 Wiki 目录并拼写章节文件。用户不会感受到任何差别，依然能够顺利开始复习。
• Q：为什么测试题总是卡在一道题过不去？
  • A：主观计算题/简答题如果学生答案不够精确，可能会被误判。您可以直接在对话中对 AI 说：“这道题太难了/这道题我想直接跳过”。AI 会将该题自动归档至你的 study_progress.md 错题本中，直接放行，让你在最后一个阶段统一重温。
• Q：我们老师最后一次课只口头划了重点，我手里只有录音/录像，没有大纲文件怎么办？
  • A：完全不用担心，你可以选择以下 3 种“录音速通姿势” 将其喂给备考教练：
    1. 姿势一：AI 客户端中转（最通用）：把录音文件先丢给其他专门的语音转录 AI 客户端（如飞书妙记、通义听悟、剪映、微信语音转文字等）生成整段文本，再将转好的文本发给备考智能体。
    2. 姿势二：音频直传（最省心，适合支持音频的 AI）：如果你使用的 AI 客户端原生支持音频分析（如基于 Google Gemini 体系的 Antigravity 平台，或网页版 Gemini Advanced），你可以直接把录音文件（.mp3/.m4a）拷贝到工作区，对 AI 说：“帮我听一下我工作区里的 focus.mp3，并初始化备考空间”。
    3. 姿势三：手机端实时听写（最直接）：在最后一节课上，直接使用手机录音自带的“语音转文字/实时听写”功能，把老师划重点的话实时转成文本，复习时直接把整段口语化文本发送给 AI。AI 具备极强的模糊纠错能力，能自动过滤废话并精准提取考点。

本项目基于 MIT License 协议开源。欢迎大家提交 Pull Request 贡献更多科目的复习模板或辅助脚本！

祝所有临考冲刺的学生考神附体，高分通关！🎓🔥