Teaching Notes Writing 是一个便携式写作技能，既可以独立使用，也会在 openpress-create-pages 处理面向学习者的教学内容（讲义、练习纸、学习指南、教程章节）时被加载。触发条件与冲突解决规则由 openpress-create-pages 负责。
用途
该技能面向的是仍在建立心智模型的学习者。它提供建议性的内容骨架、讲解策略、示例、练习想法与答案编排指引，但不强制使用某一套僵化的章节模板。
主要能力
- 从学习者可能已有的心智模型出发组织内容。
- 在引入正式规则之前，先比较相近的概念。
- 逐步展示操作流程，并让状态变化可见。
- 把理由、警示与解读放在正文段落中，而不是让图表承载过多信息。
- 建议与章节内容相匹配的练习形式。
- 把答案放在学习者有机会尝试之后。
- 判断何时应把结构、关系或状态变化转成图示，实际图示语义交由 openpress-diagram-drawing 负责。
职责边界
- openpress-create-pages 负责公开内容规范以及基于页面产物的 H1/H2/H3/H4 结构。
- openpress-diagram-drawing 负责图示语义。
- openpress-create-pages 负责页面视觉风格与组件实现。
- openpress 负责 CLI、校验/导出/渲染命令，以及源文件与生成产物的边界。
- 本技能只负责面向学习者的讲解建议与练习设计模式。
建议骨架
以下可作为起始骨架，而非必须遵循的模板：
- 从学习者遇到的具体问题或困惑切入。
- 比较相近的概念、状态或表示方式。
- 逐步展示操作或思路。
- 在有帮助时加入一个小型检查、追踪或练习任务。
- 把完整答案放在学习者尝试之后。
- 如果概念依赖空间结构、归属关系、箭头、状态转换或前后对比关系，则将视觉语义交给 openpress-diagram-drawing。
学习者边界
渲染后的教学页面应当面向学习者说话，而不是面向教师或智能体。不要包含仅给教师看的提醒、制作说明、内部理由或起始技能评论。把内部规则保留在技能、设计文档或源文件引用中。在正文、图表、表格与代码之间保持术语与变量名一致。
何时阅读参考资料
- 当需要比较类写作、讲解顺序、练习题型与答案位置时，阅读 references/teaching-patterns.md。
- 当教学涉及代码、伪代码、数据结构、指针图、内存状态或程序追踪时，阅读 references/programming.md。
限制
当前资料未提供该技能的收费、价格、支持平台、具体效果数据或详细使用步骤等信息，暂未提供。