SuperAPI AI 工具集

didactic-notes

设计与创作

查看项目

更新于 10-16 05:05

技能介绍

用途:didactic-notes 是 dbosk/claude-skills 下的技能,用于在教育材料中记录教学法设计决策,类比文学化编程对代码设计决策的记录。核心原则是不仅记录教什么,还记录为什么这样教,借助 LaTeX didactic 宏包的 \ltnote{...} 命令实现。

主要能力与范围:\ltnote 记录的是材料本身的写法与理由(选了哪个例子、呈现顺序、变化/不变模式、某道题想揭示什么),而非所教主题的内容。判断标准:若注解释的是写作选择,则为 \ltnote;若陈述所描述对象如何运作或为何那样构建,则属正文。当文档主题就是教学法时,教学分析属正文,\ltnote 仅留给论文自身的构造决策。

使用方式:宏包设置 \usepackage[marginparmargin=outer]{didactic},可用选项如 marginparmargin=outer、inner=20mm、outer=60mm、notheorems。\ltnote 可记录学习目标(配合 restatable 环境与助记标签,用 \cref{} 或星号命令引用)、教学策略、变异理论模式、关键方面、评估意图等。引用教学研究时在注内使用 \parencite,因为 \ltnote 展开为 \marginpar,verbose 样式下 \autocite/\textcite 会产生页脚注并导致致命的 Float(s) lost;实质引用应放正文。注内语言需与文档一致,英文术语可用 \foreignlanguage。

适用场景:教育讲义、beamer/article 双构建幻灯片与独立笔记、文学化教程、Mentipy 课堂提问设计等。

限制与注意:学习目标命令不能放在 itemize 等列表环境内。幻灯片构建默认隐藏注。\textbytext* 在 frame 内不可用,应改用模式切分。仅幻灯片 frame 内的引用/脚注会触发致命 Float(s) lost,可用 \mode<presentation>{...} 包裹整个 frame,或用 \only<presentation>{\autocite{...}} 过滤。双构建时正文必须从一开始就写成连贯散文,不能事后补写。其余细节暂未提供。