关于 k2f-exam-paper
这项 Skill 指导 Agent 在排版前规划与教学大纲对齐的考试,统筹考查范围、分值、题目结构和考生界面,并通过 K2F 流程生成可验证、可导出的考试文档。
主要功能
- 01映射大纲范围与分值
- 02设置稳定题号和共用材料
- 03规划考试说明与作答形式
- 04分离考生试卷和评分提纲
- 05提供适合打印的设计指导
适用场景
- 01制作课堂考试或居家考试
- 02借鉴往年试卷结构但不照搬题目
- 03按题号编制评分提纲
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ suzheng/ k2f --skill k2f-exam-paper安装后在 Claude Code 中输入/k2f-exam-paper确认已加载。
详细介绍
K2F 考试试卷 — AI 原生美学设计
目的
教 Agent 在排版前规划考试试卷:确保范围忠于教学大纲、格式特征稳定、分值分配公平,并让学生能在时间压力下读懂题目,而不是制作复习资料、预测题目,或在没有编辑结构的情况下直接粘贴题库。
基于 K2F 构建
此技能会将考试试卷生成为 .K2F 包。按照 k2f 技能进行创作:解包或初始化工作区、编辑语义树、运行 pack/verify,然后导出。K2F 让 Agent 专注于含义(部分、题目、刺激材料、作答要求),而不是像素坐标,同时由引擎编译布局、字体排印和主题。
开始构建前,请安装核心技能:npx skills add suzheng/k2f --skill k2f。
适用场景
- 教师或教学设计师需要一份可交付的考试文档(课堂考试、带回家完成的考试或混合形式)。
- 输入包括教学大纲主题、分值权重、学习成果、批准使用的阅读材料或用于匹配风格的历年试卷;如果用户只想要学习笔记或“考试可能会考什么”,则不适用。
- 与 k2f-worksheet(低风险练习)和 k2f-lesson-plan(教学顺序)不同。
工作流
步骤 1. 生成 content_and_design.md
制作一份将考核内容与美学意图相结合的蓝图。共享事实只登记一次;每道题都引用稳定键,以免刺激材料和编号发生偏移。
子步骤
-
锁定考试要求 — 课程、考核标题、考试时长、总分、开卷/闭卷/带回家完成的规则,以及允许使用的材料。如果有历年试卷,记录格式特征(题目数量、风格组合、事实模式密度、设问方式),以便匹配或有意调整——明确说明采用哪种方式。
-
覆盖范围图 — 将教学大纲主题映射到目标分值(%)。优先采用明确列出的教学大纲权重;否则根据课时和学习成果推断。标明有意降低权重的已教主题,以区别于意外遗漏的主题。
-
信息架构 — 自上而下分层:身份信息;统一说明(时间、材料、学术诚信、标注要求);在风格不同时可加入部分;包含稳定 ID 和分值且分值总和与考试要求一致的题目;当多个子题共用事实时,将刺激材料放在共享内容中;为每个子题规定作答要求(类型 + 作答空间预算);将评分概要单独设置为一个角色(参考答案、关键词、部分得分)——除非用户要求,否则不放在学生页面上。
-
题目设计 — 每个子题只考查一个可评估的学习成果;拆分复合设问。根据覆盖范围图匹配题目风格:记忆、应用、识别问题、政策、定量、多项选择题。每部分内的题目顺序为:热身 → 核心题 → 区分度较高的题,除非有意采用螺旋复习。当来源阅读材料限定了考查范围时,每道题都必须能依据教学大纲和指定材料作答;对
[OUT OF SCOPE]范围外的缺口进行标记,不要自行编造内容。 -
模式忠实度 — 匹配历年试卷时,记录稳定与可变元素(主题侧重、风格组合、事实密度)。保留结构,绝不照搬以前试卷的原文。
-
设计意图 — 语气:正式、中性;不添加无关的指导性内容。层级:首先突出题号和分值;刺激材料按共享标题分组。密度:题干简洁,留足手写空间。一致性:动词和标注方式保持平行一致。配色:适合打印的黑白配色;每部分警示信息最多使用一种强调色。
规则与限制
- 教学大纲是上限 — 除非用户明确扩大范围,否则不要考查未教过的内容。
- 分值必须相加一致 — 各部分分值、题目分值与试卷总分必须一致;在蓝图中展示计算过程。
- 指示说明集中列出 — 除非某部分确有不同要求,否则每题重复出现的“写出解题过程”应只在说明中列出一次。
- 难度诚实合理 — 如果时间或篇幅紧张,就删减题目或缩小考查范围;不要把作答空间压缩到低于题目要求。
- 题目原创 — 参考材料用于确定范围;未经授权,不得逐字照搬出版商或往年试题。
- 角色分开 — 学生试卷、评分大纲和可选封面是设计文档中的不同交付物。
常见失败模式
- 需要未说明的事实 → 扩充共享资料清单,或删除该题。
- 复合问题 → 拆分小题并重新分配分值。
- 学生试卷层中出现评分标准 → 移至评分大纲。
- 分值权重与考查范围图不一致 → 重新平衡或修订考查范围图。
- “讨论”要求含糊 → 补充篇幅、格式和证据方面的要求。
- 格式不匹配(带回家完成与限时考试) → 修正考试设定和说明。
质量检查清单
- 考试设定完整;总分相加无误;材料使用政策明确。
- 考查范围图与每道题目对应;删除无对应题目的主题,或说明其合理性。
- 共享资料清单列出所有跨题事实、数据和材料,并附有索引。
- 每个小题均注明分值、作答类型,并提供充足的作答空间。
- 说明只出现一次;编号稳定,便于评分大纲交叉引用。
- 评分大纲按题目 ID 编排;适用于建构式作答的题目应列出关键词和部分分值标准。
- 设计意图涵盖语气、层级、信息密度、一致性和配色。
- 题目均为原创;标出超出范围的内容缺口。
步骤 2:使用 content_and_design.md 和 k2f 技能生成 K2F 文件,并导出为合适的文件格式。
按照 k2f 技能,根据蓝图生成试卷,依据设计文档区分学生版与教师版角色,完成验证,并导出可直接打印的 PDF 或其他交付物。