agentleFS
HeteroCatHeteroCat/heterocat-skills/.claude/skills/p-PPTmaker/SKILL.md

perfect-PPTmaker

Skill4 starsChanged 8 months agoApache-2.0View on GitHub

AI演示文稿全流程制作:内容结构化→设计选型→AI插画/HTML构建→PPTX导出。17种实战验证的视觉风格(漫画/极简/数据叙事/国风),可编辑HTML与全AI视觉两条路径自由选择。当用户提到"做PPT"、"制作幻灯片"、"演示文稿"、"Keynote"、"slides"、"课件"、"汇报材料"、"路演"时使用。

The file

Files
SKILL.md

AI Presentation Workflow

设计哲学:Context, not control。 理解目标和风格感觉,自主做出设计决策。参考文件是灵感库,不是逐字执行的清单。


Skill 路径

脚本安装路径因用户不同而不同。执行脚本前,先用 Glob 工具搜索 **/perfect-PPTmaker/scripts/,取所在目录作为 SKILL_SCRIPTS_DIR。


启动:三个决策

每次任务开始,确认以下三项。

协作模式

模式适合检查点
Full Auto信任AI交付,只需最终PPTX确认主题即可
Guided(默认)把控方向,不管细节大纲 / 风格选定 / 组装前
Collaborative逐张审阅,全程掌控每张slide

制作路径

Path A:可编辑HTML(默认)Path B:全AI视觉
做法HTML slides + 选择性AI插画 → PPTX每张slide全AI生成图片 → PPTX
优势文字可在PPT中继续编辑,中文渲染完美视觉震撼,风格高度统一
适合商务汇报、需要反复修改的场景艺术感强、发布演讲、快速草稿
注意—中文偶有错误,文字不可后期编辑

个人形象融入

检查 assets/character/ 目录:

  • 有 *-sheet.png → 直接使用
  • 有 original.* 无设定图 → 自动生成设定图
  • 为空 → 询问用户是否需要

生成角色设定图(输出到项目根目录):

# 使用 nano-banana2 技能生成角色设定图
# 注意:--output 参数指定完整的输出文件路径
python3 /Users/jason/Desktop/heterocat-skills/.claude/skills/nano-banana2/scripts/generate_image.py \
  "Character design sheet in [STYLE] style. Keep facial features faithfully. Show 3 expressions: neutral explaining, surprised/eureka, thinking. White background, no text." \
  --image ".claude/skills/perfect-PPTmaker/assets/character/original.jpg" \
  --output "output_slides/character/character-sheet.png"

同一风格只生成一次,后续复用。


Step 1: 内容梳理

将原始材料转为逐张slide大纲。每张定义:

  • 标题:断言句,不是主题词 — 「Q3销售增长23%,新用户是主要驱动力」✓,「Q3销售」✗
  • 要点:最多3-4条
  • 视觉类型:插画 / 图表 / 流程图 / 引言
  • Path A:是否需要AI插画?Yes/No + 一行场景描述
  • Path B:完整视觉场景描述(布局+内容+情绪)

Checkpoint(Guided/Collaborative): 表格展示大纲,用户确认后进入Step 2。


Step 2: 风格选择

核心洞察:插画/漫画类风格AI生成效果远优于「专业极简」。 漫画风格有明确视觉语言,AI可充分发挥;暗色底+大留白缺乏视觉元素,生成结果「空」且「平」。

按主题推荐3个风格:

主题类型第一推荐第二推荐第三推荐
品牌/产品Snoopy漫画Neo-Pop浮世绘/敦煌
教育/培训Neo-Brutalism学習漫画Snoopy漫画
技术分享xkcd白板Neo-BrutalismLigne Claire
数据报告NYT Magazine ★Pentagram编辑Ligne Claire
年轻受众Neo-Pop像素画孔版印刷
国风/东方敦煌壁画浮世绘Takram思辨
正式商务NYT Magazine ★Pentagram编辑Build极简
路演/发布苏联构成主义NYT Magazine ★Neo-Pop
行业分析Pentagram编辑NYT Magazine ★Fathom数据
培训课件Takram思辨温暖叙事学習漫画
内部分享Neo-BrutalismThe Oatmealxkcd白板

用户说「想要XX风格」「不确定」「有例子吗」→ 查 references/design-movements.md 转换美学语言。

展示风格: 主动用 Read 工具显示 assets/style-samples/style-NN-name.png 样例图(不只是文字描述)。图片编号:01-snoopy, 02-manga, 03-ligne-claire, 04-neo-pop, 05-xkcd, 06-constructivism, 07-dunhuang, 08-ukiyo-e, 09-warm-narrative, 10-oatmeal, 11~17=第三梯队。

每个风格完整参数(色值/排版/构图/prompt规范)→ references/proven-styles-gallery.md

Checkpoint(Guided/Collaborative): 展示3个风格 + 样例图,用户选定后进入Step 3。


Step 3: 构建

Path A:HTML + 选择性插画

每张slide生成独立HTML文件(720pt × 405pt)。生成前必须遵守 4 条 html2pptx 硬性约束(见 references/prompt-templates.md 第2节),否则导出会报错:

  • DIV 里的文字必须用 <p> 或 <h1>-<h6> 包裹,不能裸文字
  • 不支持 CSS 渐变,只能纯色(linear-gradient 会报错)
  • <p>/<h*> 不能有背景/边框,这些放在外层 <div>
  • <div> 不能用 background-image,改用 <img> 标签

AI插画生成(输出到项目根目录):

# 使用 nano-banana2 技能生成插画
# 注意:--output 参数指定完整的输出文件路径
python3 /Users/jason/Desktop/heterocat-skills/.claude/skills/nano-banana2/scripts/generate_image.py \
  "[scene description in [STYLE] style]" \
  --image ".claude/skills/perfect-PPTmaker/assets/style-samples/style-NN-name.png" \
  --output "output_slides/illustration-NN.png"

垫图机制:传入风格样例图或角色设定图作为参考,强制AI生成与参照图风格一致的插画。

Path B:全AI视觉

每张slide生成完整图片(含所有文字和布局),输出到项目根目录:

# 使用 nano-banana2 技能生成完整slide图片
# 注意:--output 参数指定完整的输出文件路径
python3 /Users/jason/Desktop/heterocat-skills/.claude/skills/nano-banana2/scripts/generate_image.py \
  "[完整视觉描述:布局+内容+风格+情绪]" \
  --image ".claude/skills/perfect-PPTmaker/assets/style-samples/style-NN-name.png" \
  --output "output_slides/slide-NN.png"

短prompt比长prompt效果更好。 描述mood和内容,不要约束颜色比例、构图位置、字号数字。详细提示词模板 → references/prompt-templates.md


Step 4: 组装 PPTX(输出到项目根目录)

Path A(html2pptx):

# 注意:-o 参数使用相对路径,指向项目根目录
node $(find ~/.claude -path "*/stylization-slides/scripts/html2pptx.js" 2>/dev/null | head -1) \
  slide-01.html slide-02.html ... \
  -o ../../../../output_slides/output.pptx

Path B(create_slides.py):

# 注意:-o 参数使用相对路径,指向项目根目录
python3 $(find ~/.claude -path "*/stylization-slides/scripts/create_slides.py" 2>/dev/null | head -1) \
  slide-01.png slide-02.png ... \
  --layout fullscreen \
  -o ../../../../output_slides/output.pptx

Step 5: 收尾

  • Path A:可用 Playwright 截图预览关键slides
  • Path B:直接用 Read 工具显示生成的PNG

Checkpoint(所有模式): 展示预览,交付PPTX,汇报:完成X张,风格Y,文件路径Z。

Keynote/PowerPoint中可添加动画和Speaker Notes;Path A文字可继续编辑,Path B如有文字错误需重新生成该张图片。


Assets 目录

assets/
├── style-samples/     # 17种风格样例图(视觉参照 + 垫图两用)
│   └── style-NN-name.png
└── character/         # 用户个人形象
    ├── original.jpg   # 用户提供的照片
    └── [style]-sheet.png  # 各风格的角色设定图(首次使用时生成)

参考文件

需要文件
17种风格完整参数(色值/排版/构图/prompt规范)references/proven-styles-gallery.md
HTML规范 + Path A/B提示词模板references/prompt-templates.md
设计运动 → 风格映射(美学词汇转换)references/design-movements.md
设计原则与视觉规范references/design-principles.md
Snoopy风格专项深度指南references/proven-styles-snoopy.md

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.