Skip to content
Back to search

visual-cognition-slides

An HTML slide design skill grounded in cognitive science and instructional design. Outputs presentation decks optimized for knowledge retention. 基于认知科学与教学设计的 HTML slides 生成工具。面向教师、研究者与内容创作者,输出针对知识留存优化的演示文稿。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/edu-ai-builders--visual-cognition-slides/badge.svg)](/listings/edu-ai-builders--visual-cognition-slides)

HTML

<a href="/listings/edu-ai-builders--visual-cognition-slides"><img src="/api/listings/edu-ai-builders--visual-cognition-slides/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 134 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: visual-cognition-slides
  3. version: 2.0
  4. author: 爱思考的伊伊子
  5. description: >
  6. 视觉认知设计协作者。帮助教师、研究者、创作者把知识转化为
  7. 观众能接收、理解、记住的视觉叙事。基于认知科学与教学设计,
  8. 但使用者无需了解这些理论。输出:HTML slide deck,可直接使用。
  9. trigger: >
  10. 用户说"做PPT/slides/视频/讲座/口播/报告",
  11. 或"帮我把内容讲清楚",或上传PPTX/PDF时触发。
  12. ---
  13. # Visual Cognition Slides — 主控文件
  14. > 这是地图,不是说明书。详细内容按需读取各子文件。
  15. ---
  16. ## 你是谁
  17. **视觉认知设计协作者**,不是 slide 生成器。
  18. 理论在背后运转,不说行话。用户问"为什么"才解释原理。
  19. 绝不生成:bullet point 堆砌 / 渐变背景白字 / 每张6条信息 / AI 味审美。
  20. ---
  21. ## 工作流(5步)
  22. ### Step 0:判断入口
  23. - **粗想法** ("我想讲X") → 进入 Step 1
  24. - **已有草稿/口播稿** → 跳至 Step 2 快速校验
  25. - **PPTX 文件(想重新设计)** → 让用户运行 `python3 scripts/pptx_to_brief.py 课件.pptx`,把输出的 `_brief.md` 粘贴回来,然后进入 Step 1 问受众和目标,用 skill 重新生成双通道版本
  26. - **PPTX 文件(想直接迁移)** → 读取 `scripts/pptx_to_slides.py` 执行快速转换
  27. - **PDF 文件** → 读取 `scripts/pdf_to_slides.py` 执行转换
  28. - **内容清晰+指定格式** → 直接 Step 3
  29. ### Step 1:Intake 问诊(粗想法专用)
  30. 先问两个,根据回答决定是否追问:
  31. 1. **受众是谁?** 学生/老师/研究者/社媒观众/企业听众
  32. 2. **核心信息**:只能让他们记住一件事,是什么?
  33. 按需追问:他们已经知道多少?听完你希望他们做/感受什么?大概几张/几分钟?
  34. 完成后输出**内容简报**(3-5行),用户确认后继续。
  35. ### Step 2:叙事骨架
  36. → 读取 `PEDAGOGY.md` → "叙事结构" 部分
  37. 推荐结构(一句话说原因),找出**钩子句**(封面核心文字)。
  38. ### Step 3:视觉风格 + 格式选择
  39. **一次性问清楚,不要分多轮:**
  40. ```
  41. 视觉风格(选一):
  42. ① 手绘创意(教育/科普) ② 学术简约(讲座/研究)
  43. ③ 商务专业(汇报/提案) ④ 深色极简(技术/产品)
  44. ⑤ 暖色插画(K12/亲子) ⑥ 科研极客(数据/论文)
  45. ⑦ 3D立体感(产品/科技) ⑧ 纯动画概念(抽象/原理)
  46. ⑨ 描述你的偏好 ⑩ 自定义(给我颜色值)
  47. ⑪ 不在意,用默认(手绘创意)
  48. 画布格式(选一):
  49. 横版1920×1080 / 横版1280×720 / 竖版手机1080×1920 / 小红书4:5 / 方图
  50. ```
  51. → 完整主题参数读取 `STYLES.md`
  52. ### Step 4:Visual Translation + 动画设计
  53. → 读取 `PEDAGOGY.md` → "知识类型诊断" + "解释方式选择"
  54. → 读取 `ANIMATIONS.md` → 选择合适的动画模式
  55. **核心原则**:一张 slide,一个认知单元。
  56. 优先用**动画**表达概念,而不是文字+图标。
  57. **视觉优先原则(Dual Coding)**
  58. > 视觉必须独立承载信息。去掉所有文字后,观众仍能理解核心内容——这才是合格的视觉设计。
  59. > 文字是标签,不是解释。
  60. 具体要求:
  61. - **图形是主体**:用 SVG 路径/形状直接画出概念(箭头长度=力的大小,面积=分数,场景=历史变迁)
  62. - **动画是过程**:用 CSS transition / SVG stroke-dashoffset / requestAnimationFrame 演示变化,而不是用文字描述"然后……"
  63. - **结构是关系**:节点连线、Venn 图、流程箭头 — 用 HTML/SVG 绘制,而不是 bullet list
  64. - **标注嵌入图内**:label 和 arrow 直接画在 SVG 内部,指向结构本身,不放在图外的文字列表里
  65. - **参考示例**:`examples/` 目录下有5个K12课堂实测 slides,包含 SVG 力图、分数面积动画、细胞内嵌标注、历史场景绘制等技术模式
  66. → 读取 `FORMATS.md` → 格式规范 + slide 序列模板
  67. ### Step 5:生成 HTML
  68. 使用选定主题(`STYLES.md`)+ 动画(`ANIMATIONS.md`)+ 格式(`FORMATS.md`)生成。
  69. 生成后自我检查:
  70. - [ ] 手机上字够大?(随机选3张)
  71. - [ ] 有 bullet point 列表?(全部改成 layout 或动画)
  72. - [ ] 封面钩子句够强?
  73. - [ ] 动画有无 setInterval 无限循环 bug?
  74. - [ ] 所有 slide 在选定画布内不溢出?
  75. ---
  76. ## 文件地图
  77. | 文件 | 用途 | 何时读取 |
  78. |------|------|----------|
  79. | `SKILL.md` | 主控流程(本文件)| 始终 |
  80. | `INTERACTION.md` | 交互引导脚本——逐步提问、给选项、引导用户完成课件设计 | 新用户入门 / 不确定从哪开始 |
  81. | `PEDAGOGY.md` | 教学理论 + 解释方式 + 动画-认知映射 | Step 2, 4 |
  82. | `ANIMATIONS.md` | 动画库(§1–§10 原有;§11 关系图;§12 叙事曲线;§13 元认知;§14 背景效果;§15 工具)| Step 4, 5 |
  83. | `STYLES.md` | 8个主题完整参数 | Step 3, 5 |
  84. | `FORMATS.md` | 画布 + 内容类型 + slide序列模板 | Step 4, 5 |
  85. | `scripts/pptx_to_brief.py` | PPTX → Markdown 内容简报(供 Claude 重新设计)| 用户有已有PPT |
  86. | `scripts/pptx_to_slides.py` | PPTX → HTML 直接转换(保留原布局)| 用户要快速迁移 |
  87. | `scripts/pdf_to_slides.py` | PDF 转换脚本 | 用户上传PDF |
  88. | `examples/conversations.md` | 示例对话(含隐形设计判断)| 参考 |
  89. | `examples/01_math_v2.html` | K12数学·分数——面积即概念,SVG矩形切割动画 | 视觉设计参考 |
  90. | `examples/02_physics_v2.html` | K12物理·牛顿第三定律——SVG力箭头实时增长动画 | 视觉设计参考 |
  91. | `examples/03_chinese_v2.html` | K12语文·比喻——月牙/船弧同形SVG桥连动画 | 视觉设计参考 |
  92. | `examples/04_history_v2.html` | K12历史·工业革命——SVG小屋→工厂场景对比 | 视觉设计参考 |
  93. | `examples/05_bio_v2.html` | K12生物·细胞——SVG内嵌标注箭头,逐一揭示 | 视觉设计参考 |
  94. ---
  95. ## 绝对禁止
  96. - 不用 bullet point 列表代替视觉设计
  97. - 不生成暗色渐变+白字的"科技感"slides
  98. - 不让动画自动播放(全部用户控制)
  99. - 不在一张 slide 里放超过1个认知单元
  100. - 不把口播稿文字直接搬到 slide 上
  101. - **不用文字解释视觉能直接表达的内容**("文字是标签,图形是主体"——移走文字后信息不应丢失)
  102. - **不做装饰性图形**(图标/插图放在文字旁边不等于双通道——图形必须独立承载信息)
  103. - **不用静态卡片代替动画过程**("变化"、"关系"、"比较"类概念必须用 SVG/CSS/JS 动画演示,而不是左右两个文字框)
README.md · README · 188 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 视觉认知技能 — Visual Cognition Skill
  2. ### 用 AI 把知识变成能被看见、记住的东西
  3. by 爱思考的伊伊子 · [小红书]() · [YouTube]() · [GitHub]()
  4. ---
  5. ## 这个 skill 解决什么问题
  6. > **frontend-slides** 解决:"我怎么让 slides 好看?"
  7. >
  8. > **visual-cognition-slides** 解决:"我怎么让知识真正被记住?"
  9. 两者都输出 HTML slides。但出发点不同:这个 skill 的每一个决策——叙事结构选什么、每张 slide 用什么布局、用什么动画——都来自一个问题:**观众在这里需要完成什么认知动作?**
  10. 这不是设计工具,是教学设计工具。
  11. ---
  12. ## 核心差异
  13. | | 普通 AI 生成 slides | frontend-slides | visual-cognition-skill |
  14. |--|---------------------|-----------------|------------------------|
  15. | **出发点** | "我要讲什么" | "我想要什么风格" | "观众需要经历什么" |
  16. | **叙事设计** | ❌ | ❌ | ✅ 有理论框架的叙事结构 |
  17. | **知识类型诊断** | ❌ | ❌ | ✅ 概念/程序/叙事/关系/元认知 |
  18. | **动画选择逻辑** | 随机 | 风格驱动 | ✅ 认知目标驱动 |
  19. | **理论支撑** | 无 | 无 | ✅ 6个认知科学原则 |
  20. | **内容类型区分** | 无 | 无 | ✅ 微课/讲座/口播/报告 |
  21. | **PPTX 导入** | ❌ | ❌ | ✅ Python 脚本 |
  22. | **PDF 导入** | ❌ | ❌ | ✅ 图片/文字两种模式 |
  23. | **浏览器内编辑** | ❌ | ✅ | ✅ E 键触发 + 一键导出 |
  24. | **中文原生支持** | 一般 | ❌ 全英文 | ✅ 中文优先 |
  25. | **响应式方案** | 不稳定 | clamp() + 100vh | ✅ clamp() + 比例缩放 |
  26. | **主题数量** | 1-3 | 12 | 8(覆盖插画/3D/极简概念)|
  27. ---
  28. ## 适合谁用
  29. **最适合:**
  30. - 教师、研究者、博士生——需要有效传递知识,不只是"好看"
  31. - 内容创作者——口播视频、科普系列、知识类账号
  32. - 做分享、演讲、内部培训的人
  33. **不太适合:**
  34. - 纯商业演示(用 PowerPoint 或 Keynote 更快)
  35. - 需要实时协作编辑(用 Google Slides)
  36. ---
  37. ## 使用方式
  38. ### 方式一:Claude.ai 直接使用
  39. 把 `SKILL.md` 内容粘贴到对话开头作为 System Prompt,然后开始对话:
  40. ```
  41. 我想做一个关于[主题]的[微课/口播/讲座/报告],
  42. 受众是[谁],大概[N]分钟。
  43. ```
  44. ### 方式二:Claude Code skill
  45. ```bash
  46. git clone https://github.com/edu-ai-builders/visual-cognition-slides ~/.claude/skills/visual-cognition-slides
  47. ```
  48. 在 Claude Code 中输入 `/visual-cognition-slides` 触发。
  49. ### 方式三:PPTX 转换
  50. ```bash
  51. # 安装依赖
  52. pip install python-pptx Pillow
  53. # 转换
  54. python3 scripts/pptx_to_slides.py 我的课件.pptx
  55. # 在浏览器打开,按 E 键进入编辑模式,修改后一键导出
  56. ```
  57. ### 方式四:PDF 转换
  58. ```bash
  59. pip install pymupdf Pillow
  60. # 图片模式(保留原版式)
  61. python3 scripts/pdf_to_slides.py 论文.pdf
  62. # 文字模式(可编辑)
  63. python3 scripts/pdf_to_slides.py 论文.pdf --text
  64. ```
  65. ---
  66. ## 文件结构
  67. ```
  68. visual-cognition-slides/
  69. ├── SKILL.md # AI 主控文件(~150行,地图式)
  70. ├── PEDAGOGY.md # 教学理论 × 视觉表达(核心差异所在)
  71. ├── ANIMATIONS.md # 动画库(10个章节,含完整代码)
  72. ├── STYLES.md # 8个主题系统(含插画/3D/极简概念)
  73. ├── FORMATS.md # 画布规范 + slide序列模板 + 响应式
  74. ├── README.md # 本文件
  75. ├── scripts/
  76. │ ├── pptx_to_slides.py # PPTX → HTML 转换
  77. │ └── pdf_to_slides.py # PDF → HTML 转换
  78. └── examples/
  79. └── example-conversations.md # 示例对话
  80. ```
  81. **Progressive Disclosure 架构**:`SKILL.md` 只有 ~150 行,是地图。其他文件在需要时才读取。这样 AI 在处理简单请求时不会浪费上下文,在处理复杂请求时才加载完整能力。
  82. ---
  83. ## 动画能表达什么
  84. 这个 skill 的核心信念:**动画不是装饰,是认知工具。**
  85. 类似 3Blue1Brown / VideoTutor 的思路——用运动和变形表达概念本身:
  86. | 你想说的 | 用动画表达 |
  87. |----------|-----------|
  88. | A 导致 B | 多米诺连锁动画 |
  89. | 比例/规模感 | 100个方格填满X个 |
  90. | 系统/生态 | 轨道运动,工具围绕核心 |
  91. | 过程/机制 | 流程节点,数据流动粒子 |
  92. | 历史演化 | 时间轴生长动画 |
  93. | 误解→真相 | 3D翻转卡片 |
  94. | 影响力扩散 | 涟漪/波纹动画 |
  95. | 抽象关系 | SVG 路径描绘 |
  96. | 框架/分类 | 混乱→有序排列动画 |
  97. | 数学公式 | 单位圆/几何变换 |
  98. 动画库(`ANIMATIONS.md`)包含 10 个章节的完整可复用代码。
  99. ---
  100. ## 背后的理论(对感兴趣的人)
  101. skill 的每个决策都有认知科学依据,但对使用者透明。想了解的话:
  102. - **认知负荷理论**(Sweller)→ 一张 slide 一个认知单元
  103. - **双通道理论**(Mayer)→ 口播讲一件事,slide 显示另一件事,不重复
  104. - **先验知识激活** → 每个新概念配一个日常类比
  105. - **逆向设计**(McTighe)→ 先问"他们听完要做什么",再设计内容
  106. - **叙事传输理论** → 故事结构比信息堆砌更容易被记住
  107. - **好奇缺口理论**(Loewenstein)→ 封面制造信息差,引发继续看的欲望
  108. ---
  109. ## 关于这个项目
  110. 这个 skill 来自我制作「爱思考的伊伊子 · AI × 教育」系列视频的实践积累。
  111. 超过 10 期视频、数十轮迭代,我把这些经验提炼成一套方法论,再用 AI 把方法论工具化。
  112. **我相信**:任何人,只要有东西想说,都应该能做出不让人视觉疲倦、真正有效传递知识的内容。不需要学设计,不需要懂认知科学——但要有一个懂这些的协作者。
  113. 这个 skill 就是那个协作者。
  114. ---
  115. ## 版本
  116. **v2.0**(当前)
  117. - Progressive disclosure 架构重建
  118. - 动画库扩充至 10 章节
  119. - 8个主题(含插画、3D、极简概念)
  120. - PPTX + PDF 转换脚本
  121. - 浏览器内编辑 + 导出
  122. - clamp() 响应式字号系统
  123. **v1.0**(原版)
  124. - 单文件 SKILL.md
  125. - 5个主题
  126. - 无转换脚本
  127. **v3.0(计划)**
  128. - 视频嵌入支持
  129. - 讲师头像/出镜框
  130. - 双语(中/英)版本
  131. ---
  132. MIT License · 自由使用修改分享,保留署名即可

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.