SuperAPI AI 工具集

k2f-worksheet

办公与效率

查看项目

更新于 10-15 18:09

技能介绍

用途

k2f-worksheet 用于教会智能体在排版之前先规划一份练习单:一个面向学习者的任务界面,包含可快速浏览的说明、范围明确的题目以及有意留出的作答空间,避免大段文章堆砌、重复提示,或出现无法从练习单所提供信息中作答的题目。

它适用于教育者需要与课程、单元或标准对齐的练习、演练或应用场景;用户想要结构化的填空、组织器、简短建构性回答或清单,而不是完整教案(k2f-lesson-plan)或课程概览(k2f-syllabus)。也支持分析式的差距练习单:把杂乱输入转化为分类明确、可作答的问题块,仍可在纸上由学习者或引导者完成。

基于 K2F

该技能以 .K2F 包的形式产出练习单。编写时需遵循 k2f 技能:解包或初始化工作区、编辑语义树、运行 pack/verify,然后导出。K2F 让智能体专注于含义(章节、题目、作答类型),而不是像素坐标;布局、排版和主题由引擎编译完成。

使用前请先安装核心技能:

npx skills add suzheng/k2f --skill k2f

工作流程

第 1 步:生成 content_and_design.md

为练习单上出现的内容以及打印时的浏览方式生成一份蓝图。共享事实只登记一次,每道题引用它们,以便 k2f 技能映射章节时不会出现无声偏移。

子步骤:

  • 路由与澄清:推断学科、年级段、时长和练习单类型(操练、支架式练习、实验/数据、反思、组织器、差距补全)。最多提出两个高价值问题(例如目标标准、是否附答案);根据上下文默认题目数量和难度。
  • 学习框架:标题、可选的标准或技能要点(不超过 10 个词),以及用一句话说明成功的样子。说明练习单预设的前置知识或材料(课本页码、先前课程、计算器),不要逐题重复。
  • 信息架构:自上而下分层:
    • 定向(简短):目的和如何使用本单;不要教学式讲授。
    • 可选锚点(最多一个块):刺激材料——段落摘录、图表描述、数据表、情境——仅在题目依赖它时提供。
    • 章节:按子技能或认知步骤分组;每节有简短标题和 3–12 道题,除非用户另有指定。
    • 作答契约:每道题声明作答类型(空白行、复选框、表格单元格、短段落框、在图上标注)和大致所需空间。
    • 答案(如要求):单独的大纲式答案,按题目 ID 索引;不要把解答与学生题目混在同一页面角色中。
  • 题目设计:每道题一个可测量的提示;拆分复合问题。除非需要螺旋复习,否则在章节内按易到难排序。对于差距式练习单,按类别分组;省略空类别。每个差距行:简短来源片段(或“未说明”)、一个具体问题、空白答案字段。优先考虑范围、核心技能和阻塞性歧义,再考虑锦上添花的内容。
  • 共享登记表:数字、名称、词汇、数据集值和情境事实只放在“共享内容”下一次;题目引用稳定键,这样编辑不会分叉。
  • 设计意图(面向引擎,而非坐标):
    • 语气:平静、课堂可信;对低年级友好,但不堆砌剪贴画。
    • 层级:标题和学习框架最强;章节标题可快速浏览;题目编号或字母一致。
    • 密度:说明紧凑;在手写或绘图处留出充足工作空间;避免段落墙。
    • 一致性:题目措辞平行;章节和作答类型使用相同标签方案。
    • 配色:打印安全的黑白;最多一个强调色用于章节标题或学习框架。

规则与约束:

  • 练习单必须独立成立——每道题都能从定向 + 锚点 + 共享登记表中作答;没有书面产出的“与老师讨论”占位符不允许出现。
  • 金线——学习框架 → 章节 → 题目 → 作答空间;删掉不练习所述技能的题目。
  • 原创提示——素材可以影响范围;绝不逐字复制出版商题库或受版权保护的刺激材料。
  • 诚实范围——如果时间或页面预算紧张,减少题目或收窄框架;不要把作答空间缩小到无法辨认。
  • 引导者与学习者——教师备注或评分量规应作为单独工件放在蓝图中,不要混入面向学生的题目文本。

常见失败模式:

  • 题目考查未说明的上下文记忆 → 添加锚点块或共享登记表条目。
  • 一个问题捆绑多个技能 → 拆分题目并重新排序。
  • 学生练习单包含答案或冗长教学 → 移到单独的大纲角色。
  • 每个章节重复相同说明 → 提升到定向一次。
  • 没有真实差距的差距类别 → 完全跳过该章节。
  • 模糊提示(“再解释一下”)→ 改写为指明证据、长度或期望格式。
  • 同一章节难度不匹配 → 重新平衡或重新分组。

质量检查清单:

  • 学习框架和每道题对齐;删掉孤立题。
  • 空章节省略;题目 ID 对答案稳定。
  • 共享登记表列出所有跨题事实及其键。
  • 每道题声明作答类型并有足够空间。
  • 阅读水平符合年级;刺激材料长度合理。
  • 设计意图说明语气、层级、密度、一致性、配色。
  • 没有逐字第三方题库;差距问题具体且可作答。

第 2 步:使用 content_and_design.md 和 k2f 技能生成 K2F 文件并导出为适当文件格式

遵循 k2f 从蓝图实例化练习单,应用设计意图中的角色,验证,并导出可打印 PDF 或其他交付物。

适用场景

  • 教育者需要与课程、单元或标准对齐的练习、演练或应用。
  • 用户想要结构化填空、组织器、简短建构性回答或清单,而不是完整教案或课程概览。
  • 分析式差距练习单:把杂乱输入转化为分类明确、可作答的问题块,仍可在纸上完成。

限制

  • 练习单必须能独立成立,每道题都需能从单页信息作答。
  • 不得逐字复制出版商题库或受版权保护的刺激材料。
  • 页面或时间预算紧张时应减少题目或收窄框架,而不是压缩作答空间。
  • 教师备注或评分量规不得混入学生题目文本。
  • 使用前需先安装核心技能 k2f。