关于 huashu-slides
huashu-slides 是用于创建演示文稿的工作流技能,面向需要从内容整理到 PPTX 完稿的用户。它支持可编辑 HTML 和整页 AI 视觉两种制作路径,并通过不同协作模式设置审核节点。
主要功能
- 01内容整理为逐页大纲
- 02提供三种协作模式
- 03支持可编辑 HTML 制作路径
- 04支持整页 AI 视觉制作路径
- 05涵盖设计、组装与润色
适用场景
- 01将原始材料整理成幻灯片大纲
- 02制作后续可编辑文字的 PPTX
- 03制作以 AI 生成图像为主的演示稿
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ alchaincyf/ huashu-skills --skill huashu-slides安装后在 Claude Code 中输入/huashu-slides确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/.DS_Storereferences/design-movements.mddesign-principles.mdprompt-templates.mdproven-styles-gallery.mdproven-styles-snoopy.mdscripts/create_slides.py详细介绍
AI 演示文稿工作流
创建专业演示文稿:内容 → 设计 → 构建 → 组装 → 润色。
步骤 0:选择工作流设置
每次开始演示文稿任务时,都要向用户询问两个选项:
0-A. 协作模式
| 模式 | 说明 | 检查点 |
|---|---|---|
| 全自动 | 尽量减少互动。仅确认主题,然后交付最终 PPTX。 | 1 个检查点 |
| 引导式(推荐) | 确认大纲、选择设计,并在组装前预览。 | 3 个检查点 |
| 协作式 | 审阅每张幻灯片、批准每幅插图,全程掌控。 | 每张幻灯片 |
如果用户没有指定,默认采用引导式模式。
0-B. 组装方式
| 方式 | 工作原理 | 适用场景 |
|---|---|---|
| 可编辑 HTML(路径 A) | HTML 幻灯片 + 按需 AI 插图 → html2pptx → 可编辑 PPTX | 需要稍后编辑文本、精确布局、企业演示文稿 |
| 全 AI 视觉稿(路径 B) | 每张幻灯片都生成为完整的 AI 图像 → create_slides.py → 图像 PPTX | 追求最大视觉冲击力、艺术类演示文稿、快速草稿 |
权衡:
| 路径 A:可编辑 HTML | 路径 B:全 AI 视觉稿 | |
|---|---|---|
| 文本 | 可在 PPT 中编辑 | 嵌入图像(不可编辑) |
| 视觉质量 | 搭配插图时效果良好 | 出色——设计统一 |
| 布局控制 | 像素级精确 | 由 AI 解读 |
| 文件大小 | 较小(约 5-25MB) | 较大(约 30-80MB) |
| 中文文本 | 完美(字体渲染) | 通常良好(AI 偶尔可能渲染错误) |
| 速度 | 更快(创建 HTML) | 更慢(每张幻灯片都要生成图像) |
如果用户没有指定,默认采用路径 A(可编辑 HTML)。
步骤 1:内容结构化
将原始材料整理为逐页大纲。
每张幻灯片需定义:
- 标题——完整的断言句(而非主题词)
- 要点——最多 3-4 条
- 视觉类型——插图 / 图表 / 示意图 / 图标 / 引言
- **路径 A:**是否需要插图?——是/否。如果需要,用一行描述。
- **路径 B:**视觉场景描述——用一段话描述完整的幻灯片视觉效果(布局 + 图像 + 氛围)。
断言-证据规则:
| 不佳的标题 | 优秀的标题 |
|---|---|
| 第三季度销售 | 第三季度销售额增长 23%,新用户是主要驱动力 |
| 方法论 | 我们通过双盲实验验证了这一结论 |
语言规则:幻灯片内容一律使用中文,仅保留必要的英文术语(人名、品牌名、技术专有名词)。 Section label(如 INSIGHT、TAKEAWAY)可用英文作为设计元素。
✅ 检查点 1(引导式 + 协作式)
以表格形式呈现大纲:
路径 A:
| # | Title (assertion) | Key Points | Visual Type | Illustration? |
|---|-------------------|------------|-------------|---------------|
| 1 | Cover: ... | — | Decorative | Yes: ... |
| 2 | ... | 1. ... 2. ... | Chart | No |
| 3 | ... | 1. ... 2. ... | Illustration | Yes: ... |
路径 B:
| # | Title (assertion) | Key Points | Visual Scene Description |
|---|-------------------|------------|--------------------------|
| 1 | Cover: ... | — | Dark gradient bg, large title centered, abstract network nodes |
| 2 | ... | 1. ... 2. ... | Split layout: text left, bar chart right, clean white bg |
| 3 | ... | 1. ... 2. ... | Full illustration: person at crossroads with floating clocks |
询问用户:
- 批准或调整幻灯片数量
- 路径 A:批准或调整哪些幻灯片配有插图
- 路径 B:批准或调整视觉场景描述
- 是否有要添加或删除的内容
步骤 2:设计系统
提供 3 个设计系统选项供用户选择。 每个选项都应是一套完整的视觉语言,而不只是调色板。
重要:设计系统不只是颜色。 它定义视觉理念、字体比例、构图规则和情感意图。这正是“乏味的 PPT”与“杂志品质的演示文稿”之间的区别。
🗣️ 风格讨论(可选,用户希望进一步探索时进行)
如果用户提出类似以下需求:
- “我想要 XX 风格”(田中一光、瑞士国际主义、包豪斯、蒙德里安……)
- “我不确定想要什么风格”
- “能给我看看不同风格的例子吗?”
然后查阅设计运动参考资料:
references/design-movements.md — 设计运动与风格参考库
该文件将经典设计运动(新粗野主义、瑞士风格、包豪斯等)映射到适用于 AI 的风格预设。请用它来:
- 将用户的审美表达转化为可执行的提示词
- 建立共同的词汇体系(“这个方向偏田中一光”与“那个偏构成主义”)
- 设计全新自定义风格时作为参考
讨论完设计运动后,继续推荐下方的 3 个具体预设。
设计系统预设
⚠️ 重要发现:插画 / 漫画类风格的 AI 生成效果远胜于“专业极简”类风格。 漫画 / 插画风格具有清晰的视觉语言(线条、角色、色块),AI 可以充分发挥;极简风格(暗色底色 + 发光文字 + 大量留白)缺乏视觉元素,生成结果会显得“空”且“平”。 Pick 3 that match the topic/mood. Use the topic recommendation table below, then present each with its full description.
按主题自动推荐(优先从此表选):
| 主题类型 | 第一推荐 | 第二推荐 | 第三推荐 |
|---|---|---|---|
| 品牌/产品介绍 | Snoopy温暖漫画 | Neo-Pop新波普 | 浮世绘/敦煌(东方品牌) |
| 教育/培训 | Neo-Brutalism | 学習漫画 | Snoopy温暖漫画 |
| 技术分享 | xkcd白板 | Neo-Brutalism | Ligne Claire |
| 数据报告 | Pentagram编辑 | Fathom数据 | Ligne Claire |
| 年轻受众 | Neo-Pop | 像素画 | 孔版印刷 |
| 创意/艺术 | 达达拼贴 | 孔版印刷 | The Oatmeal |
| 国风/东方 | 敦煌壁画 | 浮世绘 | Takram思辨 |
| 正式商务 | Pentagram编辑 | Müller-Brockmann网格 | Build极简 |
| 产品发布/keynote | 苏联构成主义 | Neo-Pop | Pentagram编辑 |
| 内部分享 | Neo-Brutalism | The Oatmeal | xkcd白板 |
| 行业分析/咨询 | Fathom数据 | Pentagram编辑 | Müller-Brockmann网格 |
| 培训课件/教材 | Takram思辨 | 温暖叙事 | 学習漫画 |
| 投资/融资路演 | Build极简 | Pentagram编辑 | 苏联构成主义 |
完整 18 种风格详细参考: references/proven-styles-gallery.md
风格样例图片: assets/style-samples/ 目录
第一梯队(强烈推荐,效果极好):
1. Warm Comic Strip — Snoopy温暖漫画风
- 理念:Peanuts漫画的温暖与哲理感——简单的角色说着深刻的话,日常场景中蕴含人生智慧
- 视觉世界:圆头小孩、小狗、小鸟组成一个温暖的小世界。背景极简(草地、天空、狗屋、树)。色调像泛黄的报纸漫画
- 参考:“像 Peanuts 漫画——温暖、富有哲理、迷人”
- 风格指南:
references/proven-styles-snoopy.md - ⚠️ 关键经验: 不要在 prompt 中过度约束视觉细节(颜色比例、构图位置、角色姿势),否则会严重降低多样性。只描述情绪和内容,让 AI 自由发挥
2. Manga Educational — 学習漫画风
- 理念:日本教育漫画(学習漫画)——由角色通过反应和戏剧性情节引导你理解概念
- 色彩:明亮温暖的配色,白色背景搭配局部彩色面板,用网点灰突出强调区域
- 比例:60% 插画 / 30% 文本(在对话气泡中)/ 10% 特效
- 字体排版:醒目的粗体漫画风标题,正文放在对话/思考气泡中,拟声词作为装饰元素。字号对比为 3:1
- 构图:动态漫画分格布局(每张幻灯片 3–5 格),通过角色反应突出重点,用速度线营造活力,采用戏剧化视角
- 视觉语言:富有表现力的动漫风格角色、反应表情(惊讶、困惑、恍然大悟!)、漫画特效(汗滴、闪光、速度线)、粗细各异的分格边框
- 参考:“像一页《漫画统计学指南》——角色带你理解概念,并表现出惊喜和喜悦”
3. Ligne Claire Comics — 清线漫画风
- 理念:Hergé 的《丁丁历险记》传统——通过克制的视觉表达,最大限度地清晰呈现信息
- 色彩:白色/奶油色(#FFFDF7)背景,黑色(#000000)轮廓线,平涂高饱和色彩(3–5 种纯色,不使用渐变)
- 比例:70% 简洁背景 / 20% 插画 / 10% 文本
- 字体排版:标题带有手写字感,正文使用简洁的无衬线字体。关键引语放在对话气泡中。标题与正文比例为 2.5:1
- 构图:分格布局(每张幻灯片 2–4 格),按从左到右的顺序阅读,分格之间留出清晰的间距
- 视觉语言:线条粗细一致,使用无阴影、无排线的平涂色彩,不使用渐变;细节精准,但没有视觉噪音
- 参考:“像一页解释概念的《丁丁历险记》——每格都推动理解,没有任何装饰性元素”
4. Neo-Pop Magazine — 新波普杂志风
- 理念:青年媒体/街头服饰品牌美学,大胆而活泼
- 色彩:奶油色(#FFF8E7)背景、黑色(#000000)文字,搭配亮粉色(#FF1493)+ 青色(#00CED1)+ 黄色(#FFD700)的色块
- 比例:50% 背景 / 25% 色块 / 25% 内容
- 字体排版:标题占幻灯片面积的 40–50%(让字体本身成为视觉元素),文本块加粗黑边框,字号是正文的 10 倍
- 构图:模块化色块营造“可控的混乱”,采用不对称堆叠布局和粗边框
- 视觉语言:8 位像素风图标、剪贴照片、对话气泡、大胆的图形表面
- 参考:“像 Supreme 造型手册融合 HYPEBEAST 文章——将字体视为图形艺术”
第二梯队(推荐,特定场景效果好): 5. 白板草图 — xkcd 白板手绘风
- 理念:xkcd 遇上教授的白板——极致简约,让人专注于想法本身
- 色彩:白色(#FFFFFF)背景、黑色(#000000)墨迹,强调时使用一种点缀色(红色 #FF4444 或蓝色 #4488FF)
- 比例:85% 留白 / 10% 草图 / 5% 点缀色高亮
- 字体:所有内容都带有手绘或手写质感,基线粗糙不齐,到处都有箭头和注释。关键数字可以很大(60 pt+)
- 构图:自由布局的白板风格,用手绘箭头连接概念,搭配图表和简笔小人,随性而生动
- 视觉语言:简笔小人、手绘图表和曲线图、摇摆线条、注释箭头、圈出的关键词、公式式布局
- 参考:「像 xkcd 的《What If?》解说——用简单的图画让复杂的想法豁然开朗」
6. 苏联构成主义
- 理念:革命宣传海报——以几何图形和有限色彩展现力量
- 色彩:革命红(#CC0000)40% + 黑色(#1A1A1A)25% + 奶油白(#F5E6D3)30%
- 字体:所有文字旋转 15-30 度,不要使用任何水平线,粗体窄体
- 构图:从左下到右上的对角楔形构图,几何图形从小到大延展(形成视觉高潮)
- 视觉语言:不要使用渐变,采用纯色平涂和锐利边缘,限制为三种颜色,营造宣传海报的气势
- 参考:「像 1920 年代 Rodchenko 的海报——力量、紧迫感和几何精度」
7. 温暖叙事风
- 理念:友好的故事讲述,像 TED 演讲视觉素材或 Airbnb 融资演示文稿
- 色彩:温暖奶油色(#FDF6EC)背景、深炭灰色(#3D3D3D)文字、珊瑚色(#E17055)点缀
- 比例:60% 温暖背景 / 25% 内容 / 15% 插画
- 字体:标题粗体而温暖,字号与正文之比为 3:1。使用短句,而不是项目符号
- 构图:插画占幻灯片的 40-50%,文字环绕视觉元素排布,使用圆角形状
- 视觉语言:采用温暖色调的扁平矢量插画,以人物为中心的图像,具有叙事流动感
- 参考:「像 Mailchimp 或 Notion 的品牌演示文稿——亲切而有人情味」
**更多风格(第二、三梯队)**详见 references/proven-styles-gallery.md,包括:The Oatmeal 信息图漫画、敦煌壁画、浮世绘、孔版印刷 Risograph、等轴测 Isometric、Bauhaus 包豪斯、工程蓝图 Blueprint、复古广告 Vintage Ad、达达拼贴 Collage、像素画 Pixel Art
第四类:专业 / 编辑设计系统(仅用于 Path A)
⚠️ 以下风格强烈建议使用 Path A(HTML→PPTX)。它们依赖精确排版、数据可视化和网格系统,AI 图片生成无法达到所需精度。口腔行业分析案例已验证 Path A + Pentagram 编辑风格的出色效果。
8. Pentagram 编辑杂志风 — 编辑杂志风(信息建筑派)
- 理念:Pentagram / Michael Bierut——字体即语言,网格即思想。用极度克制的设计让数据和内容自己说话
- 色彩:奶油白(#FFFDF7)背景、近黑色(#1A1A1A)文字、一种点缀色(如橙红色 #D4480B 或品牌色)
- 比例:60% 留白 / 30% 内容 / 10% 点缀
- 字体:粗黑标题(28 pt+)+ 轻盈正文(10-13 pt),英文版块标签作为设计元素(INSIGHT / PART 03)
- 构图:瑞士网格系统、2 px 黑色边框卡片、精确的水平分隔线、内嵌数据可视化
- 视觉语言:极简图标、条形图 / 饼图 / 趋势线、callout 框、tag 标签
- 参考:「像麦肯锡洞察报告与 Monocle 杂志的结合——数据丰富,兼具编辑设计的优雅」
- 执行路径:仅限 Path A(HTML→PPTX)
- 实战验证:口腔行业分析 15 页演示文稿(
_temp/口腔行业分析/slides/)
9. Fathom 数据叙事风 — 数据叙事风(科学期刊派)
- 理念:Fathom Information Design——每一个像素都必须承载信息。兼具科学严谨性与设计优雅感
- 色彩:白色(#FFFFFF)背景、深灰色(#333)文字、海军蓝(#1A365D)主色 + 一种高亮色
- 比例:50% 图表 / 数据 / 30% 文字 / 20% 留白
- 字体:GT America / Graphik 风格的无衬线字体,大号数字(60 pt+)作为视觉锚点,精确标注脚注 / 来源
- 构图:信息密度高但不拥挤,将注释系统嵌入布局,采用小倍数图表阵列和精确时间线
- 视觉语言:散点图、热力图、时间线、带注释的图表,数据标签精确到小数
- 参考:「像《Nature》论文的数据补充材料与 Bloomberg 数据专题的结合」
- 执行路径:仅限 Path A(HTML→PPTX) 10. Müller-Brockmann Grid — 瑞士网格风(纯粹主义派)
- 理念:Josef Müller-Brockmann——客观性即美。数学精确的网格系统让任何混乱的信息变得有序
- 色彩:白色(#FFFFFF)背景、黑色(#000)文字,最多一个强调色
- 比例:70% 结构化网格 / 20% 文字 / 10% 强调色
- 字体:Akzidenz-Grotesk/Helvetica,严格的 8pt 基线网格,绝对左对齐,字重对比(300 vs 700)
- 构图:8 列数学网格,所有元素与网格线对齐,绝不允许使用装饰元素,功能主义至上
- 视觉语言:纯几何图形、黑色线条表格、精确对齐的列表,无图标、无插画
- 参考:「如同原版瑞士风格海报——永恒、理性、毫无装饰」
- 执行路径:仅限 Path A(HTML→PPTX)
11. Build Luxury Minimal — 奢侈极简风(当代品牌派)
- 理念:Build Studio——精致的简单比复杂更难。用大量留白和微妙的字重变化传达高端感
- 色彩:纯白色(#FFFFFF)背景、深灰色(#2D2D2D)文字,极少量使用单一强调色(品牌色)
- 比例:75% 留白 / 15% 文字 / 10% 强调色
- 字体:字重变化极其微妙(200-600),标题尺寸巨大(48pt+)但字重轻,正文小巧精致(12pt),字间距宽松
- 构图:黄金比例构图,元素极少,每页只讲一件事,优先营造呼吸感
- 视觉语言:高端产品图(如果有)、极简图标线条、大面积纯色块、圆角卡片
- 参考:「如同 Apple 主题演讲遇上 Celine 造型手册——自信克制」
- 执行路径:Path A(HTML→PPTX)
12. Takram Speculative — 日式思辨风(东方哲学派)
- 理念:Takram——技术是思考的媒介。用柔和的科技感和概念原型图传达深度思考
- 色彩:暖灰色(#F5F3EF)背景、深灰色(#3D3D3D)文字、鼠尾草绿(#8B9D77)强调色
- 比例:55% 暖色背景 / 25% 示意图 / 20% 文字
- 字体:圆润的无衬线字体,标题不使用粗体而采用大字号(36pt+),正文温暖(14pt),行高宽松(1.8)
- 构图:柔和阴影(blur 20px+)、圆角(16px+),以概念图/流程图为核心视觉,采用卡片式布局
- 视觉语言:概念原型图、柔和渐变、作为艺术的流程图、手绘感图标、自然色调
- 参考:「如同 Takram 项目页面——技术显得深思熟虑,而非咄咄逼人」
- 执行路径:Path A(HTML→PPTX,可借助 AI 生成配图)
更深入的风格细节:参考 design-philosophy skill 的 references/design-styles.md,其中包含 20 种设计哲学的完整提示词 DNA
🎨 自定义角色风格(用户定义)
用户可能想要参考特定的卡通/动漫美学。当用户说「做成 Doraemon 风格」或「像 Studio Ghibli」时,应将其视为风格参考,而不是绘制受版权保护角色的请求。通过提取该风格的视觉 DNA,构建自定义设计系统。
如何将角色参考转换为设计系统:
| 用户说 | 提取这些视觉特征 |
|---|---|
| 「Doraemon 风格」 | 圆润造型、明亮的原色蓝 + 白 + 红、简洁背景、可爱比例、神奇道具亮相 |
| 「Studio Ghibli」 | 水彩质感、自然绿与天空蓝、细致背景搭配简洁角色、温暖与奇幻感 |
| 「Calvin and Hobbes」 | 动感的墨笔笔触、富有表现力的动态线、幻想与现实之间的哲学对比、葱郁的户外场景 |
| 「One Piece 漫画」 | 大胆且富有动感的线条、夸张比例、戏剧性的动作姿势、强烈的能量感、粗线条轮廓 |
| 「Crayon Shin-chan」 | 粗犷的蜡笔风线条、明亮的平涂色彩、喜剧化的比例、变得荒诞的日常场景 |
| 「Adventure Time」 | 几何简洁造型、糖果色调的粉彩色、纤细轮廓线、奇趣超现实背景 |
自定义风格模板:
[User Style]: "[reference name]"
→ Shape language: [round/angular/geometric/organic]
→ Line quality: [thin uniform / thick varied / sketchy / brushwork]
→ Color palette: [specific colors extracted from that aesthetic]
→ Character style: [proportions, expressiveness level]
→ Background treatment: [detailed/minimal/abstract]
→ Emotional tone: [warm/energetic/philosophical/surreal]
字体规则(适用于所有预设)
- 最多使用 2 种字体系列(1 种标题字体 + 1 种正文字体)
- 标题:粗体、有个性——≥36pt(趋势:尺寸更大,作为图形表面使用)
- 正文:清晰、易读——≥18pt
- 中文:系统默认字体(PingFang SC / Microsoft YaHei)
- 核心原则:字体排印是一种设计元素,而不只是信息容器
✅ 检查点 2(引导式 + 协作式)
请用户从提议的 3 种设计系统中选择一种,或描述自己的偏好。展示完整说明,包括理念、视觉语言和参考。
第 3 步:构建幻灯片
第 3-A 步:HTML + 选择性插图(路径 A)
为关键幻灯片生成 AI 插图,然后创建 HTML 幻灯片文件。
哪些幻灯片需要插图? 优先考虑:
- 封面幻灯片 — 始终需要。它奠定视觉基调。
- 关键洞察幻灯片 — 最能从插图中受益的是那些带来「恍然大悟」的幻灯片。
- 结束幻灯片 — 可选,但效果显著。
- 数据密集型幻灯片 — 使用图表/示意图,而不是 AI 艺术图。
生成插图 — 使用 nano-banana-pro skill:
⚠️
nano-banana-pro是一个独立的外部 skill,不会随本仓库分发。如果你的~/.claude/skills/下没有它,请直接使用本仓库自带的等价脚本(同样调用 Gemini 3 Pro Image API,默认采用 16:9,正好适配幻灯片):uv run <本仓库路径>/huashu-wechat-image/scripts/generate_image.py --prompt "..." --filename "..." --resolution 2K
export $(grep GEMINI_API_KEY ~/.claude/.env) && \
uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py \
--prompt "[description]" \
--filename "[timestamp]-slide-[N]-[name].png" \
--resolution 2K
基础风格提示词 — 定义一个风格后缀,并将其添加到每张插图的提示词末尾:
[Base Style]: flat vector illustration, [palette background color] background,
[accent color] highlight elements, clean minimalist aesthetic,
professional presentation style, no text in image
每张幻灯片的提示词 = [具体内容] + [基础风格]
关键规则:
- 始终包含「no text in image」(图像中不要出现文字)——文字将作为可编辑元素添加
- 使用描述性段落,而不是关键词列表
- 明确指定十六进制颜色值
- 使用「flat vector」(扁平矢量)/「flat illustration」(扁平插画)以保持风格一致
在 HTML 幻灯片中嵌入:
<div class="left"></div>
<div class="right"><img src="illustration.png" style="width: 280pt; height: 280pt;"></div>
<body style="background-image: url('illustration.png'); background-size: cover;">
✅ 检查点 3-A(引导模式:预览 2–3 张关键插图;协作模式:预览每一张)
展示生成的插图。询问:是否批准/重新生成/风格是否一致?
第 3-B 步:完整 AI 幻灯片生成(路径 B)
将每张幻灯片都生成为完整的 AI 图像——布局、文字、视觉元素,一次生成。
⚠️ 第一大错误:在提示词中对布局细节和视觉限制设定过多约束。 约束越多 = 创意和多样性越少。提供氛围、参考和内容,而不是指定位置、颜色比例或角色限制,AI 才能发挥最佳效果。
AI 图像提示词黄金法则
短提示词 > 长提示词。 用 3 句话描述氛围和内容,比用 30 行指定每个视觉细节效果更好。具体来说:
| 不要这样做(扼杀多样性) | 应该这样做(激发创意) |
|---|---|
| 指定颜色比例(60%/25%/15%) | 描述氛围(「像周日漫画一样温暖」) |
| 指定布局位置(「标题居中,图片在右侧」) | 参考特定美学风格(「《花生》漫画」) |
| 限制角色(「不要史努比——要原创角色」) | 让 AI 自然诠释风格 |
| 列出必须包含的所有视觉元素 | 描述你希望观众感受到什么 |
| 在每张幻灯片的提示词中重复基础风格 | 只定义一次基础风格,让每张幻灯片的提示词保持简短 |
基础风格提示词——保持简短
定义一次基础风格,并添加到每张幻灯片的提示词末尾。控制在 5 行以内。 基础风格设定氛围;每张幻灯片的提示词则补充内容。
[Base Style]:
VISUAL REFERENCE: [Specific art/design aesthetic in one sentence]
CANVAS: 16:9 aspect ratio, 2048x1152 pixels, high quality rendering.
COLOR SYSTEM: [Describe the mood/feel of colors, not exact ratios]
示例(好——简洁):
VISUAL REFERENCE: Charles Schulz Peanuts comic strip — warm, philosophical, charming.
Characters include round-headed kids, a lovable beagle dog, and a small yellow bird.
CANVAS: 16:9 aspect ratio, 2048x1152 pixels, high quality rendering.
COLOR SYSTEM: Warm cream/newspaper tone background, soft muted pastels, warm ink lines.
反面示例(差——过度指定): 不要在基础风格中加入字体大小、颜色比例、构图百分比、边距规格或视觉权重分布。这些约束会降低多样性,却无法提升质量。
每张幻灯片的提示词结构
每张幻灯片的提示词都应简短且聚焦。不要重复基础风格细节,也不要过度指定视觉布局。
Create a [style] slide about [topic].
[Base Style]
DESIGN INTENT: [1 sentence — what the viewer should FEEL]
TEXT TO RENDER:
- Title: "[exact text]"
- Body: "[exact text]"
[Optional: 1-2 sentences describing mood or scene. Let AI decide composition.]
示例——好与差
差(传统 PPT——乏味):
Design a professional presentation slide.
Professional presentation slide, 16:9 aspect ratio, 2048x1152 pixels.
Dark navy background, light gray text, gold accent.
Slide type: content. Layout: Title at top-left, two columns below.
Title: "看涨期权收益结构"
Body: "行权价: 100元, 权利金: 10元"
Visual: a line chart showing call option payoff
→ 效果:通用 PPT,仿佛出自任何模板
好(杂志级——惊艳):
Create a slide that feels like a Bloomberg terminal data visualization
brought to life as editorial art.
VISUAL REFERENCE: Bloomberg Businessweek data feature meets cinematic lighting.
CANVAS: 16:9, 2048x1152, sharp rendering.
COLOR SYSTEM: Deep black (#0A0A0A) background 75%, white text 15%,
gold (#BF9A4A) accent 10%. The gold represents profit — it should GLOW.
TYPOGRAPHY: The number "110" rendered at 100pt as the dominant visual anchor
(the break-even point IS the story). Supporting text at 14pt, muted gray.
DESIGN INTENT: The viewer should instantly FEEL the asymmetry of options —
limited downside, unlimited upside. The visual must make this visceral,
not just informational.
TEXT TO RENDER:
- Hero metric: "110" (giant, gold, the break-even price)
- Title: "盈亏平衡点" (medium, white, above the number)
- Left data: "行权价 100" "权利金 10" (small, gray, understated)
- Insight: "亏损有底 盈利无限" (accent color, bottom)
VISUAL NARRATIVE: A single golden curve emerges from the left side of the slide,
flat and muted in gray at -10 (the maximum loss), then suddenly bending upward
at the strike price, transitioning from gray to brilliant gold as it rises
into the profit zone. The curve should feel like a ray of light breaking
through darkness. The profitable area above zero glows with warm gold
atmospheric lighting, like sunrise. The chart has NO grid lines, NO axes labels
cluttering the visual — just the pure, dramatic curve and the giant "110"
floating at the inflection point.
→ 效果:一幅讲述故事的编辑式数据可视化
路径 B 提示词的关键规则
提示词质量检查清单(每次生成前核对):
- 视觉参考 — 提示词是否点名了具体的艺术风格或出版物?(不能只写“专业”或“现代”)
- 情绪,而非布局 — 提示词描述的是观众应该感受到什么,而非元素应该放在哪里吗?
- 文本内容 — 要渲染的所有文本是否都列得清晰、准确?
- 足够简短 — 提示词是否简洁?冗长且规格详细的提示词会降低多样性。删掉 AI 可以自行决定的内容。
- 不要过度控制 — 不要规定十六进制颜色比例、字号、构图占比或角色姿势。
技术规则:
- 始终指定分辨率:
2048x1152(2K,16:9),以确保文字清晰 - 逐字包含所有文本 — AI 必须渲染准确的文字
- 中文优先:幻灯片上的文字一律用中文,仅保留必要英文术语
- 中文文本提示:标题尽量简短(≤8 个字符),以获得最佳渲染效果
- 使用描述性段落,而非关键词列表
- 并行生成:同时生成 3-5 张幻灯片以提高速度
- 保持一致性:基础风格会应用于每张幻灯片。它是系统规则,不是建议
生成命令(使用相同工具,但采用整页提示词):
export $(grep GEMINI_API_KEY ~/.claude/.env) && \
uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py \
--prompt "[full slide prompt]" \
--filename "slide-[NN]-[name].png" \
--resolution 2K
没有
nano-banana-pro时,同样可以换用本仓库的huashu-wechat-image/scripts/generate_image.py(见 Step 3-A 的说明)。
生成后的质量检查:
- 文字准确性 — 核对所有中文和英文是否都正确渲染
- 布局 — 元素的位置是否符合描述
- 风格一致性 — 各张幻灯片的颜色和设计语言是否一致
- 如果幻灯片存在文字错误 → 调整提示词后重新生成(简化文本或缩短内容)
✅ 检查点 3-B(引导模式:预览所有幻灯片;协作模式:逐张审批)
向用户展示所有生成的幻灯片图片。询问:
- 文字是否清晰、准确?
- 各张幻灯片的视觉风格是否一致?
- 是否有需要重新生成的幻灯片?
步骤 4:PPTX 组装
4-A:html2pptx 工作流(路径 A)
为每张幻灯片创建 HTML 文件,并使用 html2pptx.js 转换:
const pptxgen = require('pptxgenjs');
const html2pptx = require(process.env.HOME + '/.agents/skills/pptx/scripts/html2pptx.js');
const pptx = new pptxgen();
pptx.layout = 'LAYOUT_16x9';
await html2pptx('slide1.html', pptx);
await html2pptx('slide2.html', pptx);
await pptx.writeFile({ fileName: 'output.pptx' });
HTML 规则(来自 pptx 技能):
- 主体尺寸:
width: 720pt; height: 405pt(16:9) - 所有文本必须放在
<p>、<h1>-<h6>、<ul>、<ol>标签中 - 背景和边框仅可应用于
<div>元素 - 不使用 CSS 渐变 — 使用 Sharp 预先渲染为 PNG
- 仅使用 Web 安全字体(Arial、Helvetica、Georgia 等)
- 图片:
<img src="illustration.png" style="width: Xpt; height: Ypt;">
**已知问题:**文件路径中的中文字符可能导致图片加载失败。必要时,使用符号链接指向仅含 ASCII 字符的路径:
ln -sf "/path/with/中文/" /tmp/ascii-path
4-B:图片组装(路径 B)
使用 create_slides.py 将生成的幻灯片图片组装为 PPTX:
uv run ~/.claude/skills/image-to-slides/scripts/create_slides.py \
slide-01-cover.png slide-02-intro.png slide-03-definition.png ... \
--layout fullscreen \
--bg-color 000000 \
-o output.pptx
路径 B 推荐布局:fullscreen — 图片已包含所有布局、文字和视觉元素,因此应铺满整张幻灯片。
| 布局 | 使用场景 |
|---|---|
fullscreen | AI 生成的整页幻灯片(路径 B 默认) |
title_above | 图片 + 可编辑标题(混合方案) |
title_left | 分栏:文字 + 视觉元素 |
center | 居中图片,并留有边距 |
grid | 每张幻灯片放置多张图片 |
步骤 5:预览与润色
预览
**路径 A:**使用 Playwright 截取 3-4 张关键 HTML 幻灯片:
npx playwright screenshot "file:///path/to/slide.html" preview.png \
--viewport-size=960,540 --wait-for-timeout=1000
**路径 B:**直接展示生成的幻灯片图片(图片本身就是幻灯片)。使用 Read 工具展示 3-4 张关键 PNG。
✅ 检查点 4(所有模式)
**向用户展示预览。**PPTX 文件已就绪 — 询问:
- 是否有需要调整的幻灯片?
- 是否可以在 Keynote/PowerPoint 中打开?
最终润色(在 Keynote/PowerPoint 中)
- 切换效果和动画
- 演讲者备注
- 品牌标志摆放
- 路径 A:最终文本调整(可编辑)
- 路径 B:文本不可编辑 — 如果发现文字错误,请重新生成幻灯片图片
设计快速参考
5/5/5 规则: 每行不超过 5 个词,每张幻灯片不超过 5 个项目符号,连续的文字密集型幻灯片不超过 5 张
认知负荷: 每张幻灯片只讲一个观点。每张约 1 分钟。幻灯片应补充演讲内容,而不是重复演讲内容。
视觉层次: 采用 F/Z 型阅读动线。标题与正文的字号比例约为 3:1。每张幻灯片都应包含视觉元素。
详细参考:
references/proven-styles-gallery.md— 17 种经过测试的视觉风格,并提供分级建议references/proven-styles-snoopy.md— 逐张幻灯片详解的 Snoopy/Peanuts 风格模板references/prompt-templates.md— 内容生成与图像提示词references/design-principles.md— 完整的设计框架、配色方案和排版规范
相关技能
| 技能 | 作用 |
|---|---|
pptx | 高级 PPTX 创建/编辑(html2pptx、模板) |
nano-banana-pro | AI 插画生成(Gemini 3 Pro Image)。外部技能不会随本仓库分发,未安装时可用本仓库的 huashu-wechat-image/scripts/generate_image.py 代替 |
multi-model | 使用外部 AI 起草内容 |
design-philosophy | 20 种设计哲学深度参考(风格 DNA + 场景模板 + 评审标准)。Professional/Editorial 风格的详细提示词和评审指南在此 |
输出
- 与 PowerPoint、Keynote、Google Slides 兼容的
.pptx文件 - 适用于跨平台的 Web 安全字体
- 独立的 AI 插画 PNG 文件(可重复使用)
花叔出品 | AI Native Coder · 独立开发者 公众号「花叔」| 30 万+粉丝 | AI 工具与效率提升 代表作:小猫补光灯(AppStore 付费榜 Top1)·《一本书玩转 DeepSeek》