Exam Solution Skill

试卷详解 .skill

---

“题目看懂了，答案为什么还是只会写一个结果？”

——考试周的另一个难题

---

中文 | English

---

中文

还在把往年卷、作业题、课件和零散笔记摊满桌面，然后对着“答案：B”发呆？exam-solution-skill 的目标不是替你堆一份结果，而是把题目、用到的知识点、公式来源、代入过程和最终答案整理成一份能复习、能回查、也能继续修改的 LaTeX PDF。

它尤其适合考试周：给它一份试卷，再给它课程 PPT/PPTX 或知识点 PDF，它会先核对题目，再按课件中的定义、符号与解法组织答案；如果某一步不在课件里，会明确标为“补充推导”，而不会假装那是老师讲过的内容。

核心能力

你提供什么	skill 会做什么	你得到什么
试卷 + 课件 PPT/PPTX 或知识点 PDF	提取每个考点的公式、定义、示例解法与页码/页号，建立知识点到题目的对应关系。	按课堂方法写出的详细答案，每题可回查课件页码。
考点 PPT/PDF + 往年题	识别题目背后的解法模板，而非只替换数字。	覆盖指定考点、带难度和标准答案的类似题。
某一道看不懂的题	回溯到课件中的原始公式或步骤，说明每个数值如何取得和代入。	可跟着复算的逐步解释。

**这不是普通的“题库出题器”。**它的核心流程是：先读课件方法 → 再解原题 → 再按同一方法生成新题。课件/PPT 是“解法依据”，试卷是“具体数据与问法”。

安装

将以下内容交给支持 skills 的 Codex 或兼容 agent，按 INSTALL.md 完成安装和环境检查：

Fetch and follow instructions from:
https://raw.githubusercontent.com/Glazzze/exam-solution-latex/main/INSTALL.md

也可以直接克隆仓库：

git clone git@github.com:Glazzze/exam-solution-latex.git \
  ~/.codex/skills/exam-solution-skill

仓库 URL 目前仍为 exam-solution-latex；skill 的实际调用名已升级为 $exam-solution-skill。若你在 GitHub 设置中重命名仓库，请同步替换以上 URL。

快速开始

1. 确保本地可以运行 xelatex：

   xelatex --version

2. 上传题目源（PDF、图片、Markdown，或直接粘贴题目）。

3. 直接描述需求：

   使用 $exam-solution-skill 解答这份试卷，保留题目，写出详细解答过程和标准答案，并生成 LaTeX PDF。
   

4. 若有课件 PPT/PPTX 或知识点 PDF，一并上传并说明它是解题依据：

   使用 $exam-solution-skill 解答这份试卷，并以我上传的课程 PPT/知识点 PDF 为解题依据。
   每道非简单题写出知识点主题、课件页码或页号、公式来源和逐步代入过程。
   

默认输入输出

• 默认输入：试卷/作业 PDF、图片、Markdown 或粘贴题目；可选课程 PPT/PPTX 或知识点 PDF。
• 默认交付：.tex 源文件和编译后的 .pdf。
• 默认目录：源文件同级 Solution - <source-stem>/。
• 默认语言：中文为主，重要技术术语按需保留英文。
• 默认结构：题目 -> 知识点依据（可选） -> 解答过程 -> 标准答案 -> 答案速查。

它适合做什么

• 往年试卷、作业题和习题册的详细参考答案
• 依据课程课件/讲义生成的“课堂方法版”解答
• 概率、机器学习、算法、逻辑推理、数学计算题的逐步代入说明
• 从考点与原题生成基础、中等或提高难度的类似题
• 对已有答案进行漏题、计算、页码引用与 LaTeX 编译审阅

常用场景

完整试卷详解

使用 $exam-solution-skill 解答 `2021 人工智能 B卷.pdf`。
保留全部题目与小问，给出详细推导、标准答案和答案速查；生成 LaTeX 源文件和 PDF。

按 PPT/课件方法解题

使用 $exam-solution-skill 解答试卷，并以 `人工智能课件.pptx` 或 `人工智能知识点.pdf` 为主要依据。
每道非简单题写“知识点依据：主题（课件第 x 页/张）”，优先使用课件中的公式、符号和步骤；
课件未覆盖的内容标为“补充推导”。

生成专项类题

使用 $exam-solution-skill 根据课程 PPT/知识点 PDF 和两份往年题，
围绕“朴素贝叶斯、条件独立性、归结推理”生成 12 道中等难度题。
每题包含考点、方法依据页码、详细解答和标准答案，单独生成练习 PDF。

解释某一步如何代入

使用 $exam-solution-skill 解释第 3 题的梯度公式。
从原始定义开始，说明每个数值来自题目哪一项、为什么可以化简、如何逐步代入。

与 PPT/PDF 阅读工具的关系

• PPT/PPTX 或 PDF 提取、OCR、页面渲染负责把题目和课件读清楚；无法可靠读取的 PPTX 建议先导出为 PDF。
• exam-solution-skill 负责题目核对、知识点映射、解题、相似题生成、LaTeX 编写、PDF 编译与最终质量检查。
• 简单说：前者保证“读对”，本 skill 保证“解完整、写清楚、可回查”。

仓库结构

• SKILL.md：skill 的权威触发条件、工作流、边界与交付标准
• INSTALL.md：安装、更新和环境检查入口
• README.md：面向使用者的双语介绍、场景与提示词示例
• assets/：README 展示资源
• references/：PPT/PDF 知识点依据规则与类似题生成规则
• agents/openai.yaml：Codex UI 元数据

隐私与边界

• 用户的试卷、课件、知识点 PDF 和个人信息只作为运行时材料，不会被自动提交到仓库。
• 关键信息模糊时会请求确认，不会补造题目数据或伪造课件页码。
• 知识点 PDF 是解法依据；试卷本身才决定题目问法和具体数据。

---

English

exam-solution-skill turns exam papers, homework, and practice sets into review-ready LaTeX answer booklets. It preserves original questions, explains each reasoning step, provides concise standard answers, and compiles a final PDF instead of stopping at chat text.

When course slides or knowledge-point PDFs are supplied, the skill maps concepts, formulas, prescribed methods, and checked page references before solving. This makes the answer booklet follow the course's notation and solution style rather than merely producing a generic solution.

Installation

Ask a compatible agent to follow the installation guide:

Fetch and follow instructions from:
https://raw.githubusercontent.com/Glazzze/exam-solution-latex/main/INSTALL.md

Or clone the repository locally:

git clone git@github.com:Glazzze/exam-solution-latex.git \
  ~/.codex/skills/exam-solution-skill

Quick Start

1. Upload an exam PDF, images, Markdown questions, or pasted text.
2. Optionally upload a lecture/knowledge PDF for method grounding.
3. Ask naturally, for example:

Use $exam-solution-skill to solve this exam. Keep every original question, provide detailed reasoning and standard answers, and generate a LaTeX PDF.

For course-grounded answers:

Use $exam-solution-skill to solve this exam using my knowledge-point PDF. Cite the checked source page and follow its method for every substantial question.

Default Deliverables

• LaTeX source and compiled PDF in Solution - <source-stem>/ beside the source file
• Original questions, optional knowledge citations, detailed solution process, standard answers, and a quick answer index
• Separate, fully solved similar questions when requested

Repository Contents

• SKILL.md: canonical workflow, boundaries, and required outcomes
• INSTALL.md: installation and environment validation
• README.md: bilingual public-facing introduction and examples
• assets/: README assets
• references/: source-grounding and similar-question rules

Privacy Note

User-provided exams, slides, and generated personal answer booklets are runtime inputs and are not automatically committed to this repository.