mcpField
K
k2f-syllabus

k2f-syllabus

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

关于 k2f-syllabus

供教师和 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-syllabus

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

详细介绍

K2F 教学大纲 — AI 原生美学设计

目的

教会 Agent 在排版之前规划课程教学大纲:涵盖第一天必备信息、便于浏览的分层结构,以及彼此对齐的学习成果、课程安排和成绩评定——避免堆砌政策条文、阅读材料无处归属,或日程安排掩盖评估逻辑。

基于 K2F

此技能将课程教学大纲生成为 .K2F 文档。编写时请遵循 k2f 技能:解压或初始化工作区、编辑语义树、运行 pack/verify,然后导出。K2F 让 Agent 专注于含义(章节、日程行、政策区块),而非像素坐标,同时由引擎编译布局、排版和主题。

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

使用时机

  • 教师需要新编或修订教学大纲(高等教育、专业继续教育或结构化的 K–12 课程概览)。
  • 用户提供了部分输入:课程目录简介、每周主题、教材,或一份需要现代化改版的旧教学大纲。
  • 不适用于补充阅读清单生成器、根据历年试题预测考试,或课时级的每日计划(请使用 k2f-lesson-plan)。

工作流

步骤 1. 生成 content_and_design.md

为教学大纲中应包含的内容以及打印或分享为 PDF 时的呈现方式制定一份蓝图。将课程进度主线和共享信息分别定义一次,并在各处引用,以便 k2f 技能映射到相应章节。

子步骤

  1. 确定方向并澄清信息 — 推断学科、学期长度、上课安排和受众(从本科入门课程到专业人士)。最多提出两个最关键的问题(例如,政策文本是强制要求还是草案、学分数);若未说明,则默认学期长度。

  2. 课程基本信息 — 设置一个基本信息区块:课程名称、课程目录编号、教师联系信息、学期日期、教室/平台、办公时间、先修要求——其他位置不得重复这些信息。

  3. 课程简介 — 简要描述课程,并列出 3–6 项学习成果,动词应适合受众。根据课程描述推断缺失的学习成果,并标注 [inferred]。将每项学习成果关联到一项考核或主要作业。

  4. 课程进度主线 — 按周/单元列出主题、课堂重点、阅读材料和截止日期。将较长的主题列表压缩为 6–12 个单元,并说明分组逻辑。为主题标注应用领域(课程背景,而非泛泛的关键词)。重要截止日期应列在进度主线上,而不应只写在评分说明中。

  5. 考核与评分 — 列出类别、总计为 100% 的权重、简短的表现说明,以及与学习成果的对应关系。只有在迟交规则会影响成绩时,才在此处列出。

  6. 政策与支持 — 简要、中性地说明出勤、学术诚信、便利安排、技术和沟通事项;若用户提供了获批文本,则原文照录。列出材料、工具、安全/实地考察说明和求助资源。

  7. 设计意图 — 面向生成引擎,而非具体坐标:

    • 语气:体现诚恳欢迎;研究生默认具备相关基础知识,入门课程则对术语做一次定义。
    • 层级:先列课程名称/学期;接着列学习成果和课程进度;最后列政策。
    • 信息密度:课程进度表保持简洁;政策使用项目符号;基本信息不重复叙述。
    • 一致性:统一日期格式和单元标签方案;课程进度表的列保持平行一致。
    • 配色:适合打印;用一种强调色标示学习成果或课程进度表标题;日期/权重清晰醒目。

规则与约束

  • 贯穿主线 — 学习成果 → 课程进度 → 作业 → 权重;删除与学习成果无关的单元,除非标注为拓展内容。
  • 如实推断 — 为推断出的字段添加标记;不得编造认证信息或强制政策原文。
  • 严谨计算 — 权重总计为 100%;工作量应符合学分等级。
  • 政策由用户提供 — 强制要求的文本须原文照录;否则,通用草案须标注需由教务处审核。

常见失败模式

  • 先写政策,再说明课程目的 → 按顺序先列基本信息、课程简介、学习成果,再列课程进度。
  • 学习成果过多且含糊 → 合并为可评估的技能。
  • 阅读材料只放在附录中 → 将阅读材料关联到课程进度表的相应行。
  • 评分类别没有对应的进度安排 → 重命名类别或添加相应行。
  • 联系信息重复 → 仅保留在基本信息区块。
  • 术语或工作量与受众不匹配 → 重新调整动词和阅读材料。

质量检查清单

  • 基本信息区块完整;联系信息没有重复。
  • 3–6 项学习成果与考核/课程进度相对应;[inferred] 标记齐全。
  • 覆盖整个学期的课程进度主线;重要日期清晰可见;若经过压缩,则包含 6–12 个单元。
  • 权重总计为 100%,且与课程进度中的作业相匹配。
  • 政策简洁;材料和支持资源均已列出。
  • 设计意图涵盖语气、层级、信息密度、一致性和配色。
步骤 2. 使用 content_and_design.md 和 k2f 技能生成 K2F 文件,并导出为合适的文件格式。

按照 k2f 技能,根据蓝图生成课程大纲,应用设计意图中的角色设定,完成验证,并导出可分享的课程大纲(通常为 PDF)。

评论

支持 Markdown