mcpField
K
k2f-worksheet

k2f-worksheet

github.com/suzheng文档处理33.1k 次安装2 周前更新
代码仓库

关于 k2f-worksheet

这项 Skill 指导 Agent 在排版前规划面向学习者的练习单,组织清晰说明、可作答题目和适当的答题空间,并通过 K2F 生成可验证、可导出的练习单。

主要功能

  1. 01设定学习框架与成功标准
  2. 02分组安排范围明确的题目
  3. 03为每题规划作答形式和空间
  4. 04登记共用事实并设置稳定题号
  5. 05单独编写答案提纲

适用场景

  1. 01制作与课程或标准对齐的练习
  2. 02编写整理表或简答练习单
  3. 03将杂乱输入整理为分类差距问题

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/suzheng/k2f --skill k2f-worksheet

安装后在 Claude Code 中输入/k2f-worksheet确认已加载。

详细介绍

K2F Worksheet — AI 原生美学设计

目的

教会 Agent 在排版前为工作表制定蓝图:打造一个面向学习者的任务页面,包含便于浏览的说明、范围明确的题目和经过精心规划的作答空间——避免大段作文、重复提示,或题目无法根据工作表提供的内容作答。

基于 K2F 构建

此技能会将工作表生成为 .K2F 包。编写时请遵循 k2f 技能:解包或初始化工作区,编辑语义树,运行 pack/verify,然后导出。K2F 让 Agent 专注于含义(章节、题目、作答类型),而非像素坐标;引擎会编译布局、排版和主题。

开始构建前,请安装核心技能:npx skills add suzheng/k2f --skill k2f。

适用场景

  • 教育工作者需要与课程、单元或标准相匹配的练习、巩固训练或应用活动。
  • 用户想要结构化填空、组织图、简短的建构式回答或清单,而非完整教案(k2f-lesson-plan)或课程概览(k2f-syllabus)。
  • 分析型差距工作表:将杂乱的输入整理为分类明确、可作答的问题组(灵感来自差距分析模式),仍可由学习者或引导者在纸上完成。

工作流

第 1 步:生成 content_and_design.md

为工作表上呈现的内容以及打印后的浏览方式制定一份蓝图。将共享事实集中登记一次,并在每个题目中引用,以便 k2f 技能映射各章节时不会出现未明示的偏差。

子步骤

  1. 确定类型并澄清需求 — 推断学科、年级范围、时长和工作表类型(训练、支架式练习、实验/数据、反思、组织图、差距填补)。最多提出两个影响较大的问题(例如目标标准、是否需要答案);根据上下文决定默认题目数量和难度。

  2. 学习框架 — 标题、可选的标准或技能概要(≤10 个词),以及一句话说明成功的表现。说明工作表默认学习者已具备的先备知识或材料(课本页码、前置课程、计算器),而非在每道题中重复说明。

  3. 信息架构 — 从上到下分层:

    • 导读(简短):说明目的和使用方法;不讲授课程内容。
    • 可选锚点(最多一个模块):刺激材料,如节选、图示说明、数据表或情境;仅当题目依赖这些材料时提供。
    • 章节:按子技能或认知步骤分组;每个章节有简短标题和 3–12 道题,除非用户另有要求。
    • 作答要求:逐题声明作答类型(填空线、复选框、表格单元格、简答框、在图上标注)及所需空间的大致大小。
    • 答案(如有要求):按题目 ID 编排的独立提纲;不要把解答与学生题目穿插在同一页面角色中。
  4. 题目设计 — 每题只设置一个可衡量的提示;将复合问题拆分。除非需要螺旋复习,否则按由易到难的顺序安排每个章节中的题目。对于差距类工作表,按类别分组;省略空类别。每行差距内容包括:简短来源摘录(或“未说明”)、一个具体问题和空白作答栏。优先处理范围、核心技能和阻碍理解的歧义,再考虑锦上添花的内容。

  5. 共享登记表 — 数字、名称、词汇、数据集值和情境事实统一放在 Shared content 下;题目引用稳定键,避免修改时出现分叉。

  6. 设计意图 — 面向引擎,而非坐标:

    • 语气:平和、符合课堂情境;适合低年级,但避免堆砌剪贴画。
    • 层级:标题和学习框架最醒目;章节标题便于浏览;题目编号或字母保持一致。
    • 密度:说明简洁;需要手写或绘图时提供充足空间;避免大段文字。
    • 一致性:各题措辞平行;章节和作答类型使用相同的标签方案。
    • 配色:适合黑白打印;章节标题或学习框架最多使用一种强调色。

规则与限制

  • 独立完整的练习单 — 每道题都能根据学习导向、锚定信息和共享信息库作答;不要留下“与老师讨论”这类占位内容,除非同时提供书面产出。
  • 贯穿始终的主线 — 学习框架 → 各部分 → 题目 → 作答空间;删除不练习所述技能的题目。
  • 原创题目 — 源材料可用于确定范围;切勿逐字复制出版方的题集或受版权保护的材料。
  • 诚实把握范围 — 如果时间或页数预算紧张,就减少题目或缩小框架;不要缩小作答空间,导致内容难以辨认。
  • 教师与学习者分开 — 教师备注或评分细则应作为单独材料放入蓝图中,不要混入面向学生的题目文本。

常见失败模式

  • 题目考查未说明的背景知识 → 添加锚定信息区块或共享信息库条目。
  • 一个问题包含多项技能 → 拆分题目并重新排序。
  • 学生练习单包含答案或冗长的教学内容 → 移至单独的大纲部分。
  • 每个部分都重复相同说明 → 提取到学习导向中,只写一次。
  • 某一类空缺题目没有实际空缺 → 直接跳过该部分。
  • 提示模糊(“再多解释一些”)→ 改写提示,明确所需证据、篇幅或格式。
  • 同一部分内难度不一致 → 重新平衡或分组。

质量检查清单

  • 学习框架与每道题都一致;删除偏离主题的题目。
  • 空的部分直接省略;题目 ID 保持稳定,以便制作答案键。
  • 共享信息库列出所有跨题事实及其键。
  • 每道题都声明作答类型,并提供充足的作答空间。
  • 阅读难度符合年级;刺激材料的篇幅有合理依据。
  • 设计意图说明语气、层级、密度、一致性和配色。
  • 不逐字复制第三方题库;空缺题目具体且可作答。
第 2 步:使用 content_and_design.md 和 k2f 技能生成 K2F 文件,并导出为合适的文件格式。

遵循 k2f 技能,根据蓝图创建练习单,按设计意图应用角色,完成验证,并导出可直接打印的 PDF 或其他交付文件。

评论

支持 Markdown