用途
k2f-syllabus 用于在排版之前为课程大纲绘制蓝图。它让 AI 智能体产出的教学大纲具备以下特点:开学首日必需信息齐全、层级可快速浏览、学习成果与课程会面安排及评分相互对齐,而不是政策条文的堆砌、孤立的阅读材料,或一套隐藏了考核逻辑的进度表。
该技能基于 K2F,产出的课程大纲为 .K2F 文档。它遵循 k2f 技能的写作方式:拆解或初始化工作区、编辑语义树、运行 pack/verify,然后导出。K2F 让智能体专注于含义(章节、进度行、政策块),而不必处理像素坐标;布局、字体和主题由引擎编译完成。
在开始构建之前,需先安装核心技能:
npx skills add suzheng/k2f --skill k2f
适用场景
- 教师需要新建或修订一份大纲(高等教育、专业继续教育,或结构化的 K–12 课程概览)。
- 用户只提供部分输入:课程目录描述、每周主题、教材,或一份需要现代化改造的旧大纲。
不适用于:补充阅读清单生成器、根据往年试题预测考试,或课时级每日教案(这些应使用 k2f-lesson-plan)。
工作流
第 1 步:生成 content_and_design.md
为大纲中应当包含的内容以及打印或作为 PDF 分享时的阅读方式生成一份蓝图。其结构应让进度主线和共享事实只命名一次,并在各处引用,以便 k2f 技能将其映射到相应章节。
子步骤:
- 定位与澄清(Route & clarify) — 推断学科、学期长度、上课模式与受众(从入门本科到专业级别)。最多提出两个高价值问题(例如,规定的政策文本还是草稿、学分学时);未指定学期长度时使用默认值。
- 课程身份(Course identity) — 一个身份块:标题、课程代码、教师联系方式、学期日期、教室/平台、答疑时间、先修要求——不在其他地方重复。
- 课程故事(Course story) — 简要描述,加上 3–6 条适合受众的学习成果,动词要与受众匹配。从描述中推断缺失的成果;标记为 [inferred]。将每条成果关联到一项考核或主要作业。
- 进度主线(Schedule spine) — 周/单元行:主题、课堂重点、阅读材料、截止日期。将冗长的主题列表压缩为 6–12 个单元,并说明分组逻辑。为主题标注所属应用领域(课程语境,而非通用关键词)。将高权重截止日期放在主线上,而不只是写在评分说明文字里。
- 考核与评分(Assessment & grading) — 类别、权重总计 100%、简短的评分表现提示、成果对齐。仅在迟交规则会影响成绩时才在此处说明。
- 政策与支持(Policies & support) — 出勤、学术诚信、便利安排、技术、沟通——简洁中性;除非用户提供经批准文本(须逐字使用)。列出材料、工具、安全/实地注意事项以及求助资源。
- 设计意图(Design intent) — 面向引擎,而非坐标:
- 语气:可信的欢迎口吻;研究生假定已具备流利度,入门课术语只定义一次。
- 层级:标题/学期优先;成果与进度其次;政策最后。
- 密度:进度行紧凑;政策用项目符号;不重复身份叙述。
- 一致性:统一的日期格式与单元标签方案;平行的进度表列。
- 配色:适合打印;为成果或进度表表头使用一种强调色;日期/权重清晰可辨。
规则与约束:
- 金线(Golden thread) — 成果 → 进度 → 作业 → 权重;删除不为成果服务的单元,除非标注为拓展内容。
- 诚实推断(Honest inference) — 标记推断字段;绝不编造认证细节或强制性政策引文。
- 算术纪律(Arithmetic discipline) — 权重合计 100%;工作量与学分级别匹配。
- 用户主导政策(User-owned policy) — 强制性措辞逐字使用;否则使用通用草稿并标注需教务审核。
常见失败模式:
- 政策先于目的 → 应先身份、故事、成果,再进度。
- 成果过多且模糊 → 整合为可考核的技能。
- 阅读材料只出现在附录 → 应关联到进度行。
- 评分标签在主线上没有对应作业 → 重命名或添加行。
- 联系方式重复 → 仅在身份块出现一次。
- 术语或工作量与受众不匹配 → 重新校准动词与阅读材料。
质量检查清单:
- 身份块完整;联系方式未重复。
- 3–6 条成果关联到考核/主线;[inferred] 已标记。
- 覆盖全学期的进度主线;重要日期可见;压缩时为 6–12 个单元。
- 权重合计 100% 且与主线作业一致。
- 政策简洁;材料与支持资源已列出。
- 设计意图覆盖语气、层级、密度、一致性、配色。
第 2 步:使用 content_and_design.md 和 k2f 技能生成 K2F 文件并导出为合适的文件格式
按照 k2f 技能,从蓝图实例化大纲,应用设计意图中的角色,进行验证,并导出可分享的大纲(通常为 PDF)。