openpress-diagram-drawing

open-press 图示绘制

此技能负责图示语义，而非视觉风格。它决定图示应展示什么，以及图形内部应包含哪些文字。

核心规则

绘制关系，而非解释。

图形主体只能包含具有空间意义的信息：对象标签、指针名称、字段名称、坐标轴、图例、简短的状态标签、节点值、NULL 和操作顺序标签。

将原因、警告、边缘情况、教学说明和解读放在周围的正文或图注中。

职责

• 选择某个概念需要图示、表格、代码块还是正文说明。
• 定义节点、连接、箭头、状态、标签以及前后关系。
• 保持图形文字简洁，并与位置或方向相关联。
• 避免在图示中加入答案、制作说明或类似图注的句子。

边界

• openpress 负责选择验证／渲染命令，以及划分源文件与生成文件。
• openpress-create-pages 负责页面周围的说明、图注措辞、页面视觉风格、排版、CSS 和组件实现。
• openpress-create-slide 负责幻灯片视觉风格、幻灯片布局、可复用的 UI 基元，以及围绕幻灯片图示展开的整套演示文稿叙事。
• openpress-create-pages 负责基于页面的教学材料中面向学习者的练习流程。

工作流

1. 确定图示的用途：比较、流程状态、关系快照、前后对比、操作顺序、遍历轨迹或数据表示。
2. 选择呈现形式：
   • 图示用于展示连接、归属、方向和状态变化；
   • 表格用于密集比较或包含许多轨迹行的内容；
   • 代码块用于展示精确语法。
3. 先绘制语义，再确定风格。
4. 检查图示是否无需在图形内部添加解释性句子也能看懂。

何时查阅参考资料

• 阅读 references/diagram-patterns.md，了解链表、循环链表、双向链表、栈、队列、多项式、稀疏结构和树的绘制模式。