spaceyuan Exam Paper Skill
What I do
- 从 Markdown 课件中抽取知识点并生成考卷
- 固定输出两份内容一致的试卷
- 生成
纯试卷和试卷 + 参考答案两个 Markdown 文件 - 按固定题型、题量、分值生成总分 100 分的考卷
When to use me
当用户给出 Markdown 课件路径，并要求按课件内容出题、同时保存到指定目录时使用。
适用于需要批量生成课堂测验、阶段测试、期末复习卷、培训考核卷的场景。
Invocation format
推荐输入格式：
exam-paper @<课件路径> <保存路径>
也支持显式指定知识点领域覆盖策略：
exam-paper @<课件路径> <保存路径> --coverage balancedexam-paper @<课件路径> <保存路径> --coverage "网络基础:2,路由协议:1,交换技术:1"exam-paper @<课件路径> <保存路径> --paper-set Aexam-paper @<课件路径> <保存路径> --paper-set A+Bexam-paper @<课件路径> <保存路径> --count 3exam-paper @<课件路径> <保存路径> --paper-set A+B --count 3<课件路径>必须是 Markdown 课件文件路径<保存路径>必须是当前工作目录下的目录名或相对目录路径保存路径不存在时必须自动创建
--coverage为可选参数，默认值为balanced--paper-set为可选参数，默认值为A--count为可选参数，默认值为1，且必须是正整数
Input contract
- 只接受 Markdown 课件作为出题依据
- 必须先读取课件内容，再生成题目
- 题目范围只能来自课件原文，不得引入课外知识
- 所有题目和参考答案必须可从课件 Markdown 原文直接找到内容依据
- 若课件内容不足以覆盖某类题型，应优先从高频知识点、定义、流程、规则、术语中抽取
Output contract
当 --paper-set A 且 --count 1 时，必须在 <保存路径> 下输出两份 Markdown 文件：
纯试卷.md试卷-参考答案.md
当 --paper-set A+B 且 --count 1 时，必须在 <保存路径> 下输出四份 Markdown 文件：
A卷-纯试卷.mdA卷-参考答案.mdB卷-纯试卷.mdB卷-参考答案.md
当 --count > 1 时，必须按套数编号输出：
--paper-set A --count 3输出A1卷、A2卷、A3卷--paper-set A+B --count 3输出A1/B1、A2/B2、A3/B3
命名格式固定为：
A1卷-纯试卷.mdA1卷-参考答案.mdB1卷-纯试卷.mdB1卷-参考答案.md- 其余套数按相同规则递增命名
两份文件必须：
- 题目顺序一致
- 题号一致
- 题目内容一致
纯试卷.md仅包含题目正文，不包含参考答案试卷-参考答案.md必须同时包含题目与对应参考答案，且按题号逐题对应试卷-参考答案.md禁止只输出答案汇总、答案目录、答案列表或文末集中答案区
若生成 A+B 两套卷，则 A 卷和 B 卷都必须分别满足以上规则。
Exam composition
总分固定 100 分，题型固定如下：
填空题
- 10 题
- 每题 1 个填空项
- 每题 2 分
- 合计 20 分
单项题
- 10 题
- 每题 3 分
- 合计 30 分
问答题
- 5 题
- 题目形式必须是名词问答
- 每题 6 分
- 合计 30 分
简答题
- 5 题
- 题目形式必须是内容问答
- 每题 4 分
- 合计 20 分
Question generation rules
- 题目必须覆盖课件的核心概念、关键术语、流程、规则、注意事项
- 题目难度应由浅到深，避免 30 题完全同质化
- 填空题优先考察定义、术语、关键数字、步骤名称、条件限定
- 单项题优先考察辨析、判断、唯一正确选项
- 名词问答题优先考察概念解释、术语定义、对象说明
- 内容简答题优先考察方法、流程、原理、原因、总结
- 不得出现课件中没有依据的知识点
- 不得为了凑题数重复出题
Coverage rules
--coverage 用于控制整张试卷对课件知识点领域的覆盖倾向，不改变固定题型、题量与总分。
默认规则：
- 未传
--coverage时，按balanced处理 balanced表示按课件识别出的主要知识点领域尽量均衡覆盖
自定义规则：
--coverage "网络基础:2,路由协议:1,交换技术:1"- 其中领域名表示课件中的知识点领域
- 数值表示相对权重，不是百分比
- 权重越高，该领域在整张试卷中的题目覆盖倾向越高
匹配规则：
- 领域名必须能在课件 Markdown 结构中找到明确对应的标题、章节或知识点区域
- 优先按 Markdown 标题匹配知识点领域
- 若存在同名歧义，应优先选择最贴近课件主结构的那一项
- 若找不到对应领域名，不得猜测映射，必须报错并提示用户修正
--coverage
质量规则：
--coverage是覆盖倾向，不是死板配额- 不得为了满足权重而重复出题
- 不得为了满足权重而编造课件中不存在的内容
- 如果某领域内容不足，可适当减少该领域题量，并将剩余题量分配给其他有效领域
- 即使使用
--coverage，所有题目和答案仍必须以课件原文为依据
Paper set rules
--paper-set 用于控制生成一套试卷还是两套试卷。
默认规则：
- 未传
--paper-set时，按A处理 A表示只生成 A 卷A+B表示同时生成 A 卷和 B 卷
B 卷规则：
- B 卷作为补考卷
- B 卷总分固定 100 分
- B 卷题型、题量、分值结构必须与 A 卷完全一致
- B 卷的题目和参考答案也必须完全来自课件 Markdown 原文
- B 卷必须与 A 卷保持相近的知识点覆盖范围与整体难度
- A 卷和 B 卷的考题内容不能相同
- A 卷与 B 卷之间不得出现完全相同的题目正文
- A 卷与 B 卷之间不得出现仅替换题号但题干实质相同的题目
- 可以考查相同知识点，但题干表达、切入角度、问法、选项、填空点必须不同
题型差异化规则：
- 填空题：A 卷和 B 卷的填空句子不能相同
- 单项题：A 卷和 B 卷的题干不能相同，选项组合也不能相同
- 问答题：允许围绕同一知识点采用不同方式提问，但题目问法不能相同
- 简答题：允许围绕同一知识点采用不同方式提问，但题目要求与作答对象不能相同
多套试卷差异化规则：
- 所有 A 卷之间的考题内容不能相同
- 所有 B 卷之间的考题内容不能相同
- 任意 A 卷与任意 B 卷之间的考题内容也不能相同
- 不得出现仅替换题号、仅轻微改写措辞、但题干实质相同的题目
- 可以覆盖相同知识点，但题干表达、提问角度、选项组合、填空点、作答要求必须不同
同知识点不同问法规则：
- 对于问答题和简答题，允许围绕同一知识点采用不同问法命题
- 只要题干表达、提问角度、作答要求不同，即可视为不同题目
- 若仅做极小措辞替换，但题意、结构、答案要点基本一致，仍视为重复题
与 coverage 的关系：
--coverage同时作用于 A 卷和 B 卷- 若为
balanced，两套卷都应尽量均衡覆盖主要知识点领域 - 若为命名权重模式，两套卷都应遵守同一覆盖策略
边界规则：
- 若课件内容不足以支撑两套差异化试卷，不得强行凑题
- 遇到内容不足时，必须明确报错并告知无法稳定生成 B 卷
Count rules
--count 用于控制生成多少套试卷。
默认规则：
- 未传
--count时，按1处理 --count必须为正整数
组合语义：
--paper-set A --count 3表示生成A1、A2、A3--paper-set A+B --count 3表示生成A1/B1、A2/B2、A3/B3
数量边界：
- 若课件内容不足以支撑
count对应数量的差异化试卷，不得强行凑题 - 必须明确报错，并告知课件内容不足以稳定生成所需套数
Answer rules
- 填空题：给出唯一正确答案，必要时给出同义表述
- 单项题：标明正确选项
- 名词问答：给出简明定义，且定义内容必须能在课件原文中找到依据
- 简答题：给出要点式参考答案，所有要点必须能在课件原文中找到依据
Answer file required format
试卷-参考答案.md 必须按题目逐题展开，禁止省略题目正文。
每一道题都必须严格使用以下结构：
### <题号>. <题目正文>
参考答案：<对应答案>
评分要点：
- <要点1>
- <要点2>
适用规则：
- 填空题和单项题也必须保留完整题目正文
- 问答题和简答题必须保留完整题目正文与答案要点
- 不允许先输出一整份纯试卷，再单独附一个答案汇总区替代逐题答案
- 不允许只写“答案见上文”或“同纯试卷”
File writing rules
- 先检查
<保存路径>是否存在 - 若不存在，自动创建目录
- 若目标输出文件已存在，必须自动覆盖同名旧文件，不再额外询问用户
- 文件内容必须是标准 Markdown
- 输出完成后，明确告诉用户全部生成文件的完整路径
Validation rules
写入文件前必须自检：
纯试卷.md是否只包含题目、不包含答案试卷-参考答案.md是否包含与纯试卷完全一致的全部题目正文试卷-参考答案.md是否每道题后都紧跟对应参考答案试卷-参考答案.md是否存在仅答案汇总而缺少题目正文的情况- 若生成 B 卷，B 卷是否与 A 卷保持相同题型结构、相近难度、相近覆盖范围
- 若生成 B 卷，A 卷和 B 卷是否不存在完全相同题目或实质相同题目
- 若生成 B 卷，各题型是否满足 A/B 卷差异化规则
- 若
--count > 1，所有 A 卷之间是否不存在完全相同题目或实质相同题目 - 若
--count > 1，所有 B 卷之间是否不存在完全相同题目或实质相同题目 - 若
--count > 1，所有 Ai 与所有 Bj 之间是否不存在完全相同题目或实质相同题目
若任一检查不通过：
- 不得保留错误结果
- 必须按正确格式重写
试卷-参考答案.md - 若问题出在 B 卷与 A 卷重复，必须重写 B 卷对应题目
- 若问题出在多套试卷之间重复，必须重写对应套数的重复题目
- 直到答案版同时包含题目与答案、且逐题对应后才算完成
- 直到 A 卷与 B 卷所有题目都不相同后才算完成
Recommended document structure
纯试卷与答案版都应包含：
- 试卷标题
- 适用范围或课件来源
- 总分与题型说明
- 题目正文
答案版额外包含：
- 每题的题目后紧跟参考答案
- 评分要点
- 不允许将答案集中放在文末而不对应题目
- 每道题必须独立成块，格式为“题目正文 + 参考答案 + 评分要点”
Final response format
输出完成时只需简洁列出结果路径：
- 当
--paper-set A时：- 纯试卷：
<保存路径>/纯试卷.md - 参考答案：
<保存路径>/试卷-参考答案.md
- 纯试卷：
- 当
--paper-set A+B时：- A 卷纯试卷：
<保存路径>/A卷-纯试卷.md - A 卷参考答案：
<保存路径>/A卷-参考答案.md - B 卷纯试卷：
<保存路径>/B卷-纯试卷.md - B 卷参考答案：
<保存路径>/B卷-参考答案.md
- A 卷纯试卷：
- 当
--count > 1时：- 按
A1/A2/...或A1/B1/A2/B2/...的完整文件路径逐项列出
- 按