关于 dual-coding-designer
面向教师的教学技能工具,可将文字讲解转化为配套视觉呈现方案,说明图表类型、布局、标签与注释,帮助设计支持理解且避免无关细节的教学材料。
主要功能
- 01按概念选择合适的视觉形式
- 02规划空间布局与图示元素
- 03设计标签和注释
- 04建议有含义的视觉提示
- 05提供配合讲解的整合建议
适用场景
- 01为口头讲解规划配套图表
- 02根据课堂或讲义限制调整视觉方案
- 03减少教学图表中的冗余元素
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ garethmanning/ education-agent-skills --skill dual-coding-designer安装后在 Claude Code 中输入/dual-coding-designer确认已加载。
详细介绍
双重编码设计器
此技能的作用
将口头解释或概念转化为相辅相成的视觉呈现方案,明确说明最有助于理解的图表类型、空间布局、标注策略和注释方式。这并不是要让内容“更具视觉效果”,也不是为了迎合所谓的“视觉型学习者”(这一概念已被证伪)。而是要利用一项已有充分证据支持的发现:同时通过语言和视觉两种通道处理信息,比单独使用其中一种通道能形成更牢固、更易提取的记忆痕迹。AI 在这方面尤其有价值,因为为概念选择合适的视觉呈现方式,需要理解知识的结构(顺序、层级、因果还是空间关系),以及多媒体学习的原则——大多数教师默认使用装饰性图片或过于复杂的图表,结果增加了认知负荷,而不是减轻负荷。
证据基础
Paivio(1986)的双重编码理论指出,人类认知通过两个不同的通道运作——语言通道(基于语言)和非语言通道(基于图像)——通过这两个通道编码的信息,比仅通过一个通道编码的信息更容易提取。Clark 和 Paivio(1991)将这一理论应用于教育,证明互补的语言和视觉呈现方式能改善学习成果。Mayer(2009)将双重编码转化为十二条多媒体学习原则,其中包括多媒体原则(人们通过文字和图片比单独通过文字学得更好)、邻近原则(文字和图片应同时呈现,而非分开呈现)以及连贯性原则(无关的视觉材料会损害学习)。Mayer 和 Moreno(2003)提出了九种降低多媒体学习认知负荷的具体方法,包括去除诱惑性细节(有趣但无关的图片)、采用空间邻近(将文字放在对应视觉元素附近)以及使用信号提示(利用视觉线索引导注意力)。**关键区别:**双重编码指的是互补的呈现方式——视觉呈现出文字无法高效传达的内容(空间关系、过程、层级)。它并不是要根据学生“偏好的学习风格”来匹配内容;这一概念已被证伪(Pashler 等人,2008)。无论学习者是否有所谓的风格偏好,每个人都能从设计良好的双重编码中受益。
输入规范
教师必须提供:
- **语言内容:**需要配以视觉呈现的解释或概念。例如:“渗透过程:水分子穿过半透膜,从水浓度高的区域移动到水浓度低的区域”/“第一次世界大战的起因可分为长期起因、短期起因和导火索”
- **学科与年级:**学科领域和年级。例如:“九年级生物”/“十一年级历史”
可选(如有,可由上下文引擎注入):
- **视觉限制:**格式限制。例如:“必须能在不到 2 分钟内画在白板上”/“用于印刷版练习单”
- **学生概况:**语言熟练程度、视觉处理需求
- **现有视觉材料:**当前正在使用的视觉材料,以避免重复
提示词
You are an expert in multimedia learning and cognitive psychology, specialising in Paivio's (1986) dual coding theory, Mayer's (2009) multimedia learning principles, and their practical application to classroom instruction. You understand the critical difference between decorative visuals (which add cognitive load) and complementary visuals (which reduce it and strengthen encoding).
Your task is to design a visual representation that complements this verbal content:
**Verbal content:** "{{verbal_content}}"
**Subject and level:** {{subject_and_level}}
The following optional context may or may not be provided. Use whatever is available; ignore any fields marked "not provided."
**Visual constraints:** {{visual_constraints}} — if provided, design within these constraints. If not provided, design a visual that can be drawn on a whiteboard or created in simple presentation software.
**Existing visuals:** {{existing_visuals}} — if provided, design something complementary, not duplicative. If not provided, design the single most effective visual for this content.
**Student profiles:** {{student_profiles}} — if provided, consider language and visual processing needs. If not provided, design for a typical mixed-ability class.
Apply these evidence-based multimedia learning principles:
1. **Multimedia principle (Mayer, 2009):** The visual must ADD information that the verbal content alone does not efficiently convey. If the visual just restates what the text says (e.g., a picture of a book next to text about books), it is decorative and adds extraneous load. Ask: what does the visual show that the words cannot easily describe?
2. **Match the visual type to the knowledge structure:**
- **Sequential process → flowchart or cycle diagram** (shows order and direction)
- **Hierarchical relationship → tree diagram or nested boxes** (shows levels and containment)
- **Causal relationship → arrow diagram with cause-effect labelling** (shows causation, not just correlation)
- **Spatial/physical structure → labelled diagram or cross-section** (shows location and spatial relationships)
- **Comparison → side-by-side or Venn diagram** (shows similarities and differences)
- **Part-whole relationship → exploded diagram or pie chart** (shows proportion and composition)
- **Timeline → horizontal timeline with intervals** (shows chronological sequence and duration)
The wrong diagram type for the knowledge structure actively hinders learning. A hierarchy shown as a timeline, or a process shown as a Venn diagram, creates confusion.
3. **Contiguity principle (Mayer, 2009):** Text labels must be placed directly on or immediately adjacent to the visual elements they describe — NOT in a separate legend or key that forces the learner to split attention between the diagram and the legend. Integrated labels reduce split-attention effect (Sweller, 1994).
4. **Coherence principle (Mayer, 2009):** Remove ALL decorative elements. No clip art. No background images. No decorative borders. No colour used purely for aesthetics. Every visual element must carry information. Seductive details — interesting but irrelevant images — actively harm learning (Harp & Mayer, 1998).
5. **Signalling principle (Mayer, 2009):** Use visual cues (colour, size, arrows, numbering) to direct attention to the most important elements and relationships. Colour should encode meaning (e.g., red for danger/hot, blue for cold, green for growth), not decoration.
6. **NOT learning styles (Pashler et al., 2008):** This visual is for ALL learners, not for "visual learners." Dual coding works because two complementary representations create more retrieval pathways than one, regardless of any supposed style preference. Do not reference learning styles anywhere in the output.
Return your output in this exact format:
## Dual Coding Design: [Topic]
**For:** [Subject and level]
### Recommended Visual Type
[Diagram type and why it matches the knowledge structure]
### Visual Description
[Detailed description of the visual: layout, elements, spatial arrangement, labels, arrows, colour coding. Sufficient detail for a teacher to draw it or create it digitally.]
### Spatial Layout
[ASCII sketch or detailed spatial description showing element placement]
### Annotation Strategy
- **On the visual:** [What text goes directly on the diagram]
- **Verbal (teacher narration):** [What the teacher says while showing the visual — this goes in the verbal channel, not on the diagram]
- **DO NOT include on the visual:** [What should be kept out to avoid redundancy]
### Integration Notes
[How to present the verbal and visual together in the classroom — sequence, timing, whether to build the diagram progressively or show it complete]
### Common Pitfalls to Avoid
[2–3 specific mistakes that would turn this from a learning aid into a cognitive load problem]
**Self-check before returning output:** Verify that (a) the visual adds information the verbal content cannot easily convey, (b) the diagram type matches the knowledge structure, (c) all text is integrated directly onto the visual (no separate legends), (d) there are no decorative elements, (e) colour is used for meaning not aesthetics, and (f) no reference is made to learning styles.
输出示例
场景: 语言内容:“水循环包括水体蒸发、植物蒸腾、凝结形成云、以雨或雪的形式降水,以及水在河流、湖泊和地下水中的汇集。水循环由太阳能和重力驱动。”/学科与年级:“七年级地理”/视觉限制:“必须能在不到 3 分钟内画在白板上”
双重编码设计:水循环
**适用对象:**七年级地理
推荐的视觉类型
带空间背景的循环图——水循环是一个连续过程,包含空间组成部分(地面、大气层、地下),因此视觉内容必须同时展示顺序过程(循环)和各阶段发生的物理位置(空间)。简单的编号流程图会遗漏空间关系。纯空间示意图(景观剖面图)则会遗漏循环特性。此设计将两者结合:用景观剖面图搭配循环箭头展示过程流向。
视觉描述
简化的景观剖面图,占据整块白板的宽度,展示:
- 左侧: 一片水域(海或湖)——画成简单的弧形水面,并加上标签
- 中间: 地表,有一棵树和一座简易小山
- 右侧: 地面向下倾斜,形成一条流回水域的河流
- 上方: 白板顶部中央画一朵云
- 地下(右侧): 用点线表示地下水层
用循环箭头连接各元素,展示过程:
- 从水面向上的箭头 → 云,标注“EVAPORATION”,并注明“太阳能加热水 → 水蒸气上升”
- 从树向上的箭头 → 云,标注“TRANSPIRATION”,并注明“植物叶片释放水分”
- 云本身,标注“CONDENSATION”,并注明“水蒸气冷却 → 形成水滴”
- 从云向下的箭头 → 陆地和水域,标注“PRECIPITATION”,并注明“雨、雪、雨夹雪、冰雹”
- 沿地表的箭头 → 河流 → 流回海洋,标注“SURFACE RUNOFF / COLLECTION”
- 向下进入地下的点线箭头,标注“INFILTRATION / GROUNDWATER FLOW”
颜色编码(有实际含义,而非装饰):
- 蓝色:所有液态水(海洋、河流、地下水、雨水)
- 白色/浅色:水蒸气和云(体现状态变化)
- 黄色:角落处画一个小太阳符号,并用箭头指向蒸发箭头,标注“能量来源”
- 箭头:液态水的流动用蓝色,水蒸气的流动用白色/灰色
空间布局
[SUN]─energy──→
╭─── CLOUD ───╮
╱ condensation ╲
evaporation ↑ ↓ precipitation
transpiration↑ ↓
~~SEA~~ ↑ [TREE] ___mountain___ rain↓ ──RIVER──→ (back to sea)
~~~~~~~ ↑ ↓ ↗
~~~~~~~ ↑ surface runoff →→→→→→→
↓ infiltration
···groundwater flow →→→→→→→→→→→→→
注释策略
- 视觉内容上: 只标注过程——每个箭头使用一个词(蒸发、蒸腾、凝结、降水、径流、渗透),再加上一个 3–5 词的短注释说明机制。文字尽量精简——让空间关系发挥作用。
- 口头讲解(教师旁白): “注意,向上的箭头由太阳能驱动——太阳加热水,水以水蒸气的形式上升。向下的箭头由重力驱动——水以降水的形式落下,并沿坡流动。整个循环由两种力量驱动:太阳把水向上拉,重力把水向下拉。”这段说明应通过口头讲解补充视觉内容。不要写在白板上。
- 视觉内容中不要包含: 长篇解释段落、温度数据、百分比数字、术语定义。这些内容应通过口头讲解或单独的文本资源提供。将它们放在图中会造成冗余和注意力分散。
整合说明
逐步构建视觉图示,不要一次性全部画完。 这对减轻初学者的认知负荷至关重要:
- 首先,只画出景观(海洋、陆地、树木、山脉、河流)。不加标签。提问:“你看到了什么?这幅图里的水可能在哪里?”
- 添加蒸发箭头和标签。讲解:“太阳能加热水面。水分子获得能量,逃逸到空气中,成为水蒸气。”让学生消化这一个步骤。
- 添加蒸腾箭头。提问:“水也会从植物中升起。树木从哪里获取水分?水又是如何进入空气的?”(详尽追问——与技能 6 相衔接。)
- 添加云朵和凝结标签。讲解冷却过程。
- 添加降水箭头。提问:“水为什么会落下来?是什么力量把它拉下来?”(重力——关联已有的科学知识。)
- 添加地表径流和下渗箭头。完成循环。
- 只有完整图示构建完成后,才用手描出整个循环:“跟着水走。它从这里开始……上升……形成云……落下……流回来……循环继续。”
总构建时间: 3 分钟(逐步构建)或 1 分钟(提前画好)。
应避免的常见误区
-
添加装饰性细节,让图示“更好看”。 海里的鱼、天空中的鸟、陆地上的花——这些都是诱人的细节(Harp & Mayer,1998),会占用视觉处理能力,却无助于理解。每个元素都应代表水循环过程中的一个功能部分。如果它不属于循环,就不应出现在板书上。
-
将标签与图示分开。 常见的练习单设计会把图示放在中央,将编号索引/图例放在边缘。这会迫使学生分散注意力——他们必须在追踪空间关系的同时,将编号与定义对应起来。应将所有标签直接放在图示中相关的位置。
-
将其误解为“视觉型学习者”的专属方法。 如果学生或同事说“这对视觉型学习者很有帮助”,请纠正这一误解。双重编码对所有学习者都有益,因为两种互补的表征比单一表征能提供更多提取路径。这与迎合偏好的学习风格无关(Pashler 等,2008)。明确说明这一点有助于消除教育领域最顽固的迷思之一。
已知限制
-
这项技能用于设计视觉表征,无法创建视觉图示。 输出内容是详细的设计说明(图示类型、布局、元素、颜色编码),而非图像文件。教师必须自行创建视觉图示——可以画在白板上、制作在 PowerPoint 中,也可以使用 Canva 或 draw.io 等工具。设计说明足够详细,可以依照执行,但每个人的艺术能力和工具熟练程度不尽相同。
-
有些概念本质上难以通过视觉方式表现。 抽象概念(正义、反讽、概率)和复杂的多变量关系,很难用简单的视觉表征呈现。这项技能会推荐可用的最佳方案,但对于高度抽象的内容,视觉图示相较于口头讲解所能增加的价值可能有限。这并非双重编码失效,而是反映了视觉表征本身的真实局限。
-
双重编码是否有效,取决于整合方式,而不只是是否同时呈现。 仅仅在文本旁边展示图示,并不会自动带来双重编码的益处。教师必须主动整合这两个通道——一边讲解一边指示,边解释边逐步绘制图示,并请学生将视觉元素与口头描述联系起来。设计精良的视觉图示如果没有经过整合式呈现,就只是幻灯片上的一张图片。