Back to Details

k2f-worksheet

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

K2F Worksheet — AI-Native Aesthetic Design

K2F 练习单 — AI 原生美学设计

Purpose

目的

Teach agents to blueprint a worksheet before layout: a single learner-facing task surface with scannable instructions, well-scoped items, and intentional response space—without essay dumps, duplicate prompts, or items that cannot be answered from what the sheet provides.
教授 Agent 在布局前对练习单进行蓝图规划：打造一个面向学习者的单一任务页面，其中包含易于扫读的说明、范围明确的题目和经过精心设计的作答空间——避免长篇大论、重复提示，或出现无法仅凭练习单所提供信息作答的题目。

Built on K2F

基于 K2F 构建

This skill produces worksheets as 
.K2F
packages. Follow the k2f skill for authoring: unpack or init a workspace, edit the semantic tree, run pack/verify, then export. K2F keeps agents on meaning (sections, items, response types)—not pixel coordinates—while the engine compiles layout, typography, and theme.
Before you build, install the core skill: 
npx skills add suzheng/k2f --skill k2f
.
此 skill 会将练习单生成为 
.K2F
包。创作时请遵循 k2f skill：解包或初始化工作区，编辑语义树，运行 pack/verify，然后导出。K2F 让 Agent 专注于内容含义（分区、题目、作答类型），而非像素坐标；引擎则负责编译布局、排版和主题。
开始构建前，请安装核心 skill：
npx skills add suzheng/k2f --skill k2f
。

When to Use

使用场景

  • Educators need practice, rehearsal, or application aligned to a lesson, unit, or standard.
  • The user wants structured blanks, organizers, short constructed responses, or checklists—not a full lesson plan (k2f-lesson-plan) or course overview (k2f-syllabus).
  • Analyst-style gap worksheets: turn messy inputs into categorized, answerable question blocks (inspired by gap-analysis patterns)—still learner- or facilitator-completable on paper.
  • 教育工作者需要设计与课程、单元或标准对齐的练习、预演或应用活动。
  • 用户需要结构化填空、图形整理表、简短建构式回答或清单，而不是完整教案（k2f-lesson-plan）或课程概览（k2f-syllabus）。
  • 分析师风格的缺口练习单：受 gap-analysis 模式启发，将杂乱输入转换为按类别划分且可以作答的问题块——同时仍须保证学习者或引导者能够在纸面上完成。

Workflow

工作流

Step 1. Generate the content_and_design.md

第 1 步：生成 content_and_design.md

One blueprint for what appears on the sheet and how it should scan when printed. Register shared facts once; reference them from every item so the k2f skill can map sections without silent drift.
Sub-steps
  1. Route & clarify — Infer subject, grade band, duration, and worksheet type (drill, scaffolded practice, lab/data, reflection, organizer, gap-closure). Ask at most two high-leverage questions (e.g., target standard, with/without answer key); default item count and difficulty from context.
  2. Learning frame — Title, optional standard or skill gist (≤10 words), and what success looks like in one sentence. State prerequisites or materials the sheet assumes (textbook page, prior lesson, calculator)—not repeated per item.
  3. Information architecture — Layer top to bottom:
    • Orientation (brief): purpose and how to use the sheet; no teaching lecture.
    • Optional anchor (one block max): stimulus—passage excerpt, diagram description, data table, scenario—only if items depend on it.
    • Sections: grouped by sub-skill or cognitive step; each section has a short heading and 3–12 items unless the user specifies otherwise.
    • Response contract: per item, declare response type (blank line, checkbox, table cell, short paragraph box, label-on-diagram) and approximate space needed.
    • Answer key (if requested): separate outline keyed by item ID; do not interleave solutions with student items on the same page role.
  4. Item design — One measurable prompt per item; split compound questions. Order easy → hard within a section unless spiral review demands otherwise. For gap-style sheets, group by category; omit empty categories. Each gap row: short source snippet (or “not stated”), one specific question, blank answer field. Prioritize scope, core skill, and blocking ambiguities before nice-to-haves.
  5. Shared registry — Numbers, names, vocabulary, dataset values, and scenario facts live once under 
    Shared content
    ; items reference stable keys so edits cannot fork.
  6. Design intent — For the engine, not coordinates:
    • Tone: calm, classroom-credible; friendly for younger grades without clip-art clutter.
    • Hierarchy: title and learning frame strongest; section heads scannable; item numbers or letters consistent.
    • Density: instructions tight; generous workspace where handwriting or drawing is expected; avoid paragraph walls.
    • Consistency: parallel wording across items; same label scheme for sections and response types.
    • Palette: print-safe B&W; at most one accent for section headers or the learning frame.
Rules & constraints
  • Sheet must stand alone — Every item answerable from orientation + anchor + shared registry; no “discuss with teacher” placeholders without a written product.
  • Golden thread — Learning frame → sections → items → response spaces; cut items that do not practice the stated skill.
  • Original prompts — Source material may inform scope; never copy publisher problem sets or copyrighted stimuli verbatim.
  • Honest scope — If time or page budget is tight, reduce items or narrow the frame; do not shrink response space to illegibility.
  • Facilitator vs learner — Teacher notes or scoring rubrics belong in the blueprint as separate artifacts, not mixed into student-facing item text.
Common failure modes
  • Items test recall of unstated context → add anchor block or shared registry entry.
  • One question bundles multiple skills → split items and reorder.
  • Student sheet includes answer key or lengthy teaching → move to separate outline role.
  • Every section repeats the same instructions → lift to orientation once.
  • Gap categories with no real gaps → skip the section entirely.
  • Vague prompts (“Explain more”) → rewrite to name evidence, length, or format expected.
  • Mismatched difficulty in one section → rebalance or regroup.
Quality checklist
  • Learning frame and every item align; cut orphans.
  • Sections omitted when empty; item IDs stable for answer key.
  • Shared registry lists all cross-item facts with keys.
  • Each item has a declared response type and adequate space.
  • Reading level fits grade; stimuli length justified.
  • Design intent states tone, hierarchy, density, consistency, palette.
  • No verbatim third-party item banks; gap questions specific and answerable.
用一份蓝图定义练习单上展示的内容及其打印后的扫读效果。共享事实只注册一次；所有题目均引用这些事实，使 k2f skill 能够映射各部分，而不会在无提示的情况下发生内容漂移。
子步骤
  1. 分流与澄清——推断学科、年级段、时长和练习单类型（操练、分层支架练习、实验/数据、反思、整理表、缺口补全）。最多提出两个最关键的问题，例如目标标准、是否包含答案键；题目数量和难度默认根据上下文确定。
  2. 学习框架——标题、可选的标准或技能要点（≤10 个词），以及用一句话说明成功标准。列出练习单所假定的前提条件或所需材料（教材页码、此前课程、计算器）——不要在每道题中重复。
  3. 信息架构——自上而下分层：
    • 导入说明（简短）：目的及练习单使用方法；不要进行长篇教学讲解。
    • 可选锚点（最多一个区块）：引导材料——文章摘录、图示描述、数据表或情境——仅在题目依赖该内容时设置。
    • 分区：按子技能或认知步骤分组；除非用户另有说明，每个分区设置简短标题和 3–12 道题。
    • 作答约定：为每道题声明作答类型（空白横线、复选框、表格单元格、简短段落框、图上标注）以及所需的大致空间。
    • 答案键（如用户要求）：另列提纲并按题目 ID 索引；不要在同一页面中穿插答案与学生题目。
  4. 题目设计——每道题只设置一个可衡量的提示；拆分复合问题。除非螺旋式复习另有要求，否则在各分区内按由易到难排序。对于缺口式练习单，按类别分组；省略空类别。每个缺口行包含：简短的来源摘录（或“未说明”）、一个具体问题和空白答案栏。优先处理范围、核心技能和阻碍性歧义，之后再处理可选改进项。
  5. 共享注册表——数字、名称、词汇、数据集值和情境事实仅在 Shared content 下保存一次；题目引用稳定键，确保修改时不会产生分叉。
  6. 设计意图——面向引擎，而非坐标：
    • 基调：沉稳、具有课堂可信度；对低年级友好，但不添加杂乱的剪贴画。
    • 层级：标题和学习框架最突出；分区标题易于扫读；题号或字母保持一致。
    • 密度：说明紧凑；在需要手写或绘图的位置留出充足空间；避免大段文字堆砌。
    • 一致性：各题措辞保持平行；分区和作答类型使用相同的标注体系。
    • 配色：采用适合安全打印的黑白方案；分区标题或学习框架最多使用一种强调色。
规则与约束
  • 练习单必须独立成立——每道题都能仅凭导入说明、锚点内容和共享注册表作答；不得设置没有书面产出要求的“与教师讨论”之类占位项。
  • 黄金主线——学习框架 → 分区 → 题目 → 作答空间；删除不练习既定技能的题目。
  • 原创提示——源材料可用于确定范围；绝不逐字复制出版商题库或受版权保护的素材。
  • 如实控制范围——若时间或页数预算有限，应减少题目或收窄学习框架；不要将作答空间压缩至难以辨认。
  • 区分引导者与学习者——教师备注或评分量表应作为独立产物置于蓝图设计中，不得混入面向学生的题干。
常见失败模式
  • 题目考查的是未说明背景的回忆 → 增加锚点区块或共享注册表条目。
  • 一道题包含多项技能 → 拆分题目并重新排序。
  • 学生练习单包含答案键或冗长教学 → 移至单独的提纲中。
  • 每个分区都重复相同说明 → 统一上移至导入说明。
  • 缺口分类中不存在真实缺口 → 完全省略该分区。
  • 提示含糊（如“进一步说明”）→ 重写为明确所需证据、长度或格式。
  • 同一分区内的难度不一致 → 重新平衡或重新分组。
质量检查清单
  • 学习框架与每道题保持一致；删除孤立题目。
  • 空分区已省略；题目 ID 可稳定对应答案键。
  • 共享注册表通过键列出所有跨题事实。
  • 每道题都声明了作答类型，并有充足的作答空间。
  • 阅读难度符合年级要求；材料长度合理。
  • 设计意图涵盖基调、层级、密度、一致性和配色。
  • 不逐字使用第三方题库；缺口问题具体且可以作答。

Step 2. Use the content_and_design.md and k2f skill to generate a K2F file and export to an appropriate file format.

第 2 步：使用 content_and_design.md 和 k2f skill 生成 K2F 文件，并导出为适当的文件格式。

Follow k2f to instantiate the worksheet from the blueprint, apply roles from design intent, verify, and export print-ready PDF or other deliverables.
遵循 k2f，根据蓝图实例化练习单，应用设计意图中的各个角色，执行验证，并导出可打印的 PDF 或其他交付物。