teaching-card 用于课程、YouTube 视频、工作坊、社区帖子、演示、练习和参考文档中的教学写作。它把教学卡定义为一个紧凑的教学单元：只清晰解释一个具体要点，并可被复用于课程、视频、幻灯片、练习或参考文档中。它不是表单，除非用户明确要求，不应暴露“学习者问题”“解释”“常见错误”“要点”等标题结构。
核心规则是一张卡只教一个点，包含多个点就拆成多张卡。其目标是让一个想法被真正理解，而非罗列信息；做法是删去一切非必要内容，保留学习者理解该点所需的少数片段。讲解要直白但不幼稚化。卡片应帮助学习者理解：发生了什么、为何重要、没有它会出什么问题、该改做什么、以及之后能记住的规则。
推荐讲法顺序：从学习者能认出的真实情境开始，指出冲突、困惑或失败模式，解释背后概念，把工具、模式或规则作为解法引入，展示命令、提示词、图、演示或示例，最后以可操作规则收尾。不要在学习者痛点更具体时先讲抽象定义。
默认卡片形态为一个清晰标题、简短自然解释、具体示例或提示词、命令、代码、图、演示、练习、常见错误或对比，以及一句 Takeaway。每张卡尽量包含或指向一个有价值的教学资产，如提示词、命令、代码样例、图、演示指令、前后对比、清单、截图想法或练习；若没有合适资产，应说明为何卡片仍成立。
输出模式：只要求一张卡时写一张打磨过的卡；要求一节课时先提出卡片栈（课程名、成果、卡片标题列表），再写为可读教学段落而非元数据块；要求审查现有材料时，指出无明确要点的段落、教多个点的段落、缺少示例或资产之处、抽象或说教语言、无助于理解的技术细节，以及应拆分、合并或删除的卡片。
风格直接、实用、反炒作、具体、口语化、有操作价值，尊重聪明学习者；避免背景先行、开头长定义、穷举边缘情况、同一意思反复说三遍、先讲工具后讲问题、试图覆盖所有内容。限制：资料未提供安装方式、平台、收费或价格信息，这些暂未提供。