name: luobo-ppt description: 做 PPT 和美化 PPT 的一站式 skill，输出可编辑的原生 .pptx。从零生成时，给一个题目、一篇文章或口播稿、一份大纲，产出结论式标题、带口播备注、风格统一的 PPT；按参考图美化时，给一份朴素的 .pptx 和一张参考图，文字一字不改地换上统一的配色、母版、版式、图标和插画。当用户说"做个PPT""把这篇文章做成PPT""生成口播PPT""美化PPT""照这张图的风格改PPT""套个风格""make slides""beautify my deck"，或丢来 pptx、文章、大纲时，务必使用此skill。生图模型可配置，没配置时自动用程序化插画兜底。

萝卜 PPT（luobo-ppt）

两条路线共用一套设计引擎。生成是"写出内容再设计"，美化是"抽出原稿内容再设计"，从版式规划开始完全一样。

三份中间文件串起全流程，脚本负责确定性的活，Claude 负责理解内容和审美判断。

下文 $S 指本 skill 的 scripts 目录，$W 指本次的工作目录（如 ./ppt_work）。Windows 上把 python3 换成 python。

开工前

1. 判断路线
   • 用户给了 .pptx，要换个好看的样子 → 路线 A 美化
   • 给的是题目、文章、口播稿、大纲或其他素材，要做成 PPT → 路线 B 生成
   • 给了 .pptx 但要重写内容、调整结构 → 路线 B，把 pptx 当素材读
2. 环境自检，之前通过的话一秒内结束，否则自动补装依赖。退出码非 0 就把建议告诉用户并停下；只缺推荐组件（如 LibreOffice）可以继续，pipeline 会改用 render_lite.py 按排版数据直接画近似预览，排版、配色、溢出照样能看，交付时说明预览是近似图。想跳过 LibreOffice 提速也可以加 --lite。

   python3 $S/setup_check.py --quick --install
   

3. 生图状态 python3 $S/make_assets.py $W --status，用一句话告诉用户接了哪家模型，或者走程序化插画。配置方法见 references/imagegen_config.md。
4. 一次提问问清路线需要的选择，其余用默认值。用户说"直接做""不用问"或者不在场时，全部用默认值，交付时列出做过的选择。
5. 快速模式：用户说"快速模式""别问了""赶时间"时，跳过风格卡、大纲、设计规格的确认，五维自评只修一轮"要修"，"顺手改"写进交付说明不动手。12 页左右的稿子，正常 15 到 25 分钟，快速模式 10 分钟上下；时间大头在转写文字和看图，脚本本身只要一两分钟。
   • 美化：力度 light / standard / full（默认 full），是否允许精修文字（默认不允许）
   • 生成：用途、受众、时长、有无参考图、要不要口播备注，默认值见 references/generate.md

路线 A 美化

1. 解析原稿 python3 $S/extract_deck.py 原稿.pptx $W，然后看 source_png/sheet.png。脚本会修复 LibreOffice 打不开的 zip，也能读出藏在 descr 属性里的口播备注。
2. 读参考图 python3 $S/extract_style.py 参考图.png $W，再亲自看图，按 references/style_extraction.md 写 $W/style.json，然后 python3 $S/style_card.py $W 出风格卡。用户在场就发风格卡确认。
3. 整理 deck.json，按 references/deck_schema.md 从 deck.draft.json 转写。文字逐字复制，局部加粗写成 **片段**；图片里的文字重建成 diagram 等原生结构；notes 原样带上；写好 meta.anchor 视觉锚点。原稿页面上的小标签（"01 · 概览"这类章节胶带）写进该页的 kicker，条目自带的编号（01、02）写进条目的 num，这样换任何列表符号都不会丢字。原稿里用公式编辑器打的公式，解析时会自动转成普通文字公式（如 V′(x) = (a−2x)(a−6x)），照常逐字转写；公式多的讲解页用 explain 页型。SVG 图会顺手转一份 PNG（raw.json 里的 png 字段），版式里用 PNG。logo、"AI 生成"标识这类小图写进 stamps 原样保留。原稿里的软件截图（media/ 下的图片）用 screenshot 或 screenshots 页型，截图会放进统一的窗口外框，讲解点可以用 at 打在截图上。
4. 接着走下面的"版式、出图与检查"。

路线 B 生成

开始前先读 references/generate.md，里面有故事线、结论式标题、密度、口播备注和页型选择的全部规则。

1. 分析素材 python3 $S/analyze_source.py $W --file 文章.md（只有题目用 --topic "…"，可加 --minutes 3）。只有题目或需要补充事实时，先搜索查证，查不到的不写。
2. 写 deck.json：先定故事线，再按"内容形状决定页型"逐页写，标题写结论，屏幕放关键词，完整的话放 notes。分了章节的稿子在封面后放一页 toc 目录（不写 items 会自动列章节），卡片页连得多了插一页 question 大问句或 big_quote 大引文。工具教程类的素材有截图时，一张图配几个操作点用 screenshot，几张图走流程用 screenshots。除了常规的卡片、步骤、对比，还有时间线、漏斗、中心辐射、2x2 矩阵、原生表格、原生图表和 SWOT/PEST/五力/商业画布，拿不准装不装得下就 python3 $S/layout_info.py <版式名> 查容量和示例。
3. 检查大纲 python3 $S/outline_check.py $W，修到没有 ERROR，把 outline.md 里的"只读标题"发给用户确认。
4. 定风格：有参考图走路线 A 第 2 步；没有就 python3 $S/style_previews.py $W --auto 出三张样张（用户自己的封面和内容页），发 previews/sheet.png 让用户挑，再 --apply <id>。预设在 references/styles/，共十四套，每套的硬规则排版时要遵守。要在会议室投影的，在 meta 里写 "projection": true，字号下限会抬高。
5. 接着走下面的"版式、出图与检查"。

版式、出图与检查（两条路线共用）

1. 版式规划 python3 $S/plan_deck.py $W --level full（有生图模型时加 --sheets，一张大图切出几张小插画，风格更统一也更省）。 重跑时内容没变的页会保留原来的规划（包括手改过的版式和插画提示词），要全部重排加 --reset。 审 plan.json：版式贴不贴内容（references/layouts.md）、图标达不达意（references/icons.md）、插画提示词具不具体（references/image_prompts.md）。内容超出版式容量时脚本会自动换版式，并写进 design_spec.md 的"容量提醒"，出图前先处理掉。 把生成的 design_spec.md 发给用户确认后再出图，出图最花钱。快速模式跳过确认。

2. 出图、组装、自检一条命令：

   python3 $S/pipeline.py $W
   

   依次运行 make_assets（插画、背景、装饰，AI 提示词先落盘到 prompts/）、build_deck、render、qa_check、compare_sheet、review。

   检查	级别	处理
   美化时原稿文字缺失或被改；生成时 deck.json 的文字没上页面	ERROR	对照原文或 deck.json 修正
   文字溢出、文本框重叠、文字越过底线（压到胶囊条或页脚）	ERROR	换版式、拆页，或用 free 版式手工摆
   强调色一页超过 3 处或面积超过 8%	WARN	只留一处强调
   文字压插画、对比度不足、出界、正文过小	WARN	看图判断，多数要修
   新增的页眉、页码、步骤编号	INFO	正常

3. 五维自评：看 out/sheet.png 和逐页 PNG，对照 out/review.md 里脚本数出的证据，按 references/critique.md 给统一、层级、细节、传达、节奏各打 0 到 10 分，写出保留、要修、顺手改三张清单。"要修"的交付前改掉，改完只重跑受影响的步骤，最多三轮。

交付

• out/beautified.pptx，文件名用 原名_美化版.pptx 或 主题.pptx
• 美化附 out/compare.png 前后对比图，生成附 out/sheet.png 全览图
• 一句话报五维自评的分数和最弱的一项
• 一两句话说明风格、插画来源（哪家模型或程序化插画）、字体，美化时说明有无精修文字，生成时说明哪些内容需要用户再核实
• 用户连接了本地文件夹时，写回素材所在的位置

硬规则

通用

1. 所有文字都是可编辑文本框，卡片、胶囊条、分隔线用原生形状，只有背景、插画、图标、笔刷是图片。
2. 参考图只用来抽风格，不裁切、不贴进 PPT。
3. AI 插画里不出现文字（产品首字母这种图形化字母除外），提示词始终带负面约束。
4. 程序化插画是兜底方案，交付时如实说明，不说成 AI 生成。
5. 做稿子的过程中不改 skill 自己的文件。遇到 skill 的问题，绕过去完成交付，再把问题写进交付说明，由用户决定要不要改 skill。

美化 6. 默认不改任何文字；用户允许精修时，改动逐条列给用户过目。 7. 页序和页数与原稿一致，备注保留。

生成 8. 数据和事实只用素材里的或查证过的，标上 source；查不到就不写，绝不编数字。图表数据改了，标题和 insights 的结论跟着重写。 9. 大纲（只读标题）经用户确认后再做设计；风格和设计规格同理，快速模式除外。

局部修改

• 单页重做：改 plan.json 里那一页的 layout、icons，或改 prompts/hero_NN.md，再 make_assets.py $W --only hero_NN --force 和 pipeline.py $W
• 换风格：换 style.json（参考图或 style_previews.py --apply），插画 --force 重出，deck.json 和 plan.json 可以沿用
• 特殊页面：该页 layout 设为 free，在 plan 里直接写 elements（格式见 references/layouts.md）
• 只要轻度美化：plan_deck.py $W --level light，不出插画

常见问题

• soffice 转换失败：渲染只影响预览，不影响交付文件；先确认 extract_deck.py 产出的 source.pptx 能打开
• 预览字体和用户电脑不同：预览用思源黑体代替微软雅黑，版式留了余量，见 references/fonts.md
• 生图失败：自动换程序化插画，assets/manifest.json 记录错误，交付时说明哪几页是兜底图

文件索引

萝卜 PPT.skill

丢进来一篇文章或一份旧 PPT，拿回去一份能直接改字的原生 PPT。

一个做 PPT 和美化 PPT 的 Agent Skill。

从零生成时，给它一个题目、一篇文章、一份口播稿或大纲，它先写出结论式标题和口播备注，再排版出图。 按参考图美化时，给它一份朴素的 .pptx 和一张参考图，它把原文一字不改地搬进统一的配色、版式、图标和插画里，少一个字都不交。

效果示例 · 安装 · 使用方式 · 它解决什么 · 工作原理 · 14 套风格

效果示例

文字一个不动，换身衣服

上面一排是原稿，下面一排是给了一张薄荷绿参考图之后美化出来的。标题、要点、数字一个字都没改，换掉的是配色、版式、图标和插画。

同一份原稿，换一张参考图就是另一套风格

从上往下依次是原稿、薄荷参考图、深色科技、墨水杂志。四个版本文字完全一样。

参考图里有什么，封面就画什么

参考图是一张环保科普封面，山坡上立着风车。美化后的封面照着参考图的元素画出了风景，整张图没接任何 AI 生图模型，是程序画出来的。

理科课件，公式一个不丢

一份高中数学导数复习课，原稿里有 12 个用公式编辑器打的公式，在 LibreOffice 里打开全是空白。解析时它会把这类公式转成普通文字公式，换什么软件都看得到，也能直接改字。

一篇文章，直接变成能讲的 PPT

把一篇公众号文章丢给它，生成 15 页的口播 PPT。它先写一份只有标题的"幽灵稿"让你确认，每页标题都是一句结论，每页都带口播备注。

数据、流程、分析框架也装得下

时间线、漏斗、中心辐射、2x2 矩阵、原生表格、原生图表，外加 SWOT、PEST、波特五力、商业画布。表格是真表格，图表双击就能改数据。

工具教程的截图有专门的版式

一张截图配几条说明，说明里写上位置，截图上就打一个对应的编号点。几张截图走一个流程，按各自的宽高比分配宽度，中间自动加箭头。

它解决什么

AI 做的 PPT，常见的毛病就这几样。

• 整页是一张图片，看着漂亮，错一个字也改不了
• 能编辑的又是一股模板味，谁做出来都长一个样
• 内容装不下就把字越缩越小，投到墙上看不清
• 美化的时候顺手把原文"润色"了，丢了一句都不知道
• 标题写成"数据分析""项目介绍"，只读标题串不成一个故事
• 每页字号忽大忽小，强调色到处都是
• 原稿里的公式、编号、来源说明，美化完就没了

这个 Skill 把这些都变成了脚本能检查的规矩，交付前先过一遍。

适合什么场景

• 口播视频、公众号文章配套的讲解 PPT
• 拿到一份朴素的工作汇报、课件、方案，想照某张图的风格整体换装
• 理科和教学课件，公式多、示意图多
• AI 工具教程，截图多
• 数据复盘、竞品分析，需要原生表格、图表和分析框架
• 会议室投影，需要更大的字号下限

工作原理

两条路线共用一套设计引擎，中间靠三份文件串起来。

路线 A 美化   原稿.pptx ──解析──┐
                               ├──> deck.json（每页内容） + style.json（风格） ──> plan.json（版式规划）
路线 B 生成   文章/题目 ──写稿──┘

plan.json ──> 出插画 ──> 组装原生 pptx ──> 渲染预览 ──> 自动检查 ──> 五维自评 ──> 交付

脚本负责确定性的活，Agent 负责理解内容和审美判断。

美化时少一个字，它都不交

原稿的每一段文字都会先存一份，美化完逐页核对。少一行字就报错，直接点名是哪一页、哪一句。

装不下的内容，写大纲时就拦住

每个版式都标了容量，比如漏斗最多 5 层、每层说明不超过 26 个字。超了就在大纲阶段提醒，排版时自动换一个装得下的版式。

出图以后，先给自己挑一遍刺

先查丢字、溢出、字压页脚、对比度、强调色用量这些硬伤，再把能数出来的证据列成表，从统一、层级、细节、传达、节奏五个方面给自己打分，要修的修完再交。

没装 LibreOffice 也能看图自检

预览默认用 LibreOffice 渲染。没装的话，它会按排版数据直接把每一页画出来，12 页大概 10 秒，左边是 LibreOffice，右边是近似画法。

没配生图模型也能用

背景、装饰和插画都有程序化的画法，上面所有的图都是在没接生图模型的情况下跑出来的。配了 OpenAI、Gemini、火山方舟或任意 OpenAI 兼容接口，插画会更丰富，单张失败会自动退回程序化插画。

安装

仓库根目录就是 skill 本身（SKILL.md 在最外层），装好之后第一次使用时，Skill 会自己检查环境、补装缺少的 Python 包。

方式一：让 Agent 自己装

在 Claude Code、Codex、Gemini CLI、Cursor 这类能执行命令的 Agent 里直接说：

帮我安装这个 skill：https://github.com/zhouwei713/luobo-ppt

Agent 会把仓库克隆到它自己的 skills 目录。装完开一个新会话就能用。

方式二：一行命令克隆

把仓库克隆到你的 Agent 的 skills 目录，目录名用 luobo-ppt。

# Claude Code
git clone https://github.com/zhouwei713/luobo-ppt.git ~/.claude/skills/luobo-ppt

# Codex 及其他支持 SKILL.md 开放标准的 Agent
git clone https://github.com/zhouwei713/luobo-ppt.git ~/.agents/skills/luobo-ppt

# Gemini CLI
git clone https://github.com/zhouwei713/luobo-ppt.git ~/.gemini/skills/luobo-ppt

# Cursor
git clone https://github.com/zhouwei713/luobo-ppt.git ~/.cursor/skills/luobo-ppt

Windows 上 ~ 是 C:\Users\你的用户名。只想在某个项目里用，就克隆到项目里的 .claude/skills/、.agents/skills/ 这类目录。

用 skills CLI 的话，一行就行：

npx skills add zhouwei713/luobo-ppt

方式三：一键安装脚本

想一次装给电脑上所有的 Agent，并且提前把依赖装好：

git clone https://github.com/zhouwei713/luobo-ppt.git
cd luobo-ppt
bash install.sh

Windows 双击 install.bat，或在 PowerShell 里运行 .\install.ps1。脚本会自动找到装了哪些 Agent，分别装进去，检查并补装依赖，最后生成一份两页的小样做自测。只装给某一个 Agent 加参数就行，比如 bash install.sh --agent codex，更多参数见 INSTALL.md。

方式四：Claude 应用

在仓库页面点 Code → Download ZIP，在 Claude 应用的技能设置里上传这个压缩包。

更新

cd ~/.claude/skills/luobo-ppt && git pull   # 换成你实际的安装目录

依赖

python3 scripts/setup_check.py --install 会检查并安装缺少的部分。

使用方式

装好以后，跟 Agent 这么说：

把这篇文章做成 12 页的口播 PPT，每页带口播备注，用墨水杂志风格。

帮我美化这份 PPT，照着这张参考图的风格来，文字一个字都别改。

这份数学课件帮我美化一下，公式都要保留。

这是一篇工具教程，里面的截图帮我用截图版式排，操作点在截图上标出来。

主题是"AI 工具号年度复盘"，给我出三张风格样张，我挑一个再往下做。

这份 PPT 要在会议室投影，用投影模式，字号大一点。

赶时间可以加一句"快速模式"，它会跳过中间的确认环节。

14 套风格

没有参考图时，可以直接报名字。

仓库结构

.
├── SKILL.md                 Skill 主说明，Agent 读这个
├── INSTALL.md               安装说明
├── install.sh / install.ps1 / install.bat
├── config.example.json      生图模型配置模板
├── scripts/                 解析、规划、组装、渲染、检查、自评的全部脚本
├── references/              版式库、deck.json 字段、风格提取、14 套风格预设、自评规则
├── assets/                  图标库、风格样张
└── docs/images/             README 用图

设计理念

好看的 PPT 少有靠堆装饰撑起来的。它先要讲得清楚：只读标题能串成一个故事，每页字数装得下，字号就那么几级，强调色只给最关键的那一处。

AI 最容易偷懒的地方恰好是这些看不见的规矩。所以这个 Skill 把它们写成了能数出来的检查，丢字、溢出、字号乱、对比度不够，脚本先过一遍，再让 AI 看图挑刺。

交出去的永远是原生 PPT。不满意的地方你自己动两下就行，不用求着 AI 重新生成。

致谢

做这个 Skill 时参考过这些项目和资料，全部只提炼思路、自己改写，没有搬运原文和代码。

• dashi-ppt-skill：给每个版式标注容量的思路
• open-design：可检查的排版规则和五维设计评审
• 多个 PPT 设计网站的模板：归纳出 36 条视觉路线，目录与章节联动、装饰母题、投影模式都来自这里
• Lucide 图标（ISC License，见 assets/LICENSE-lucide.txt）

更新记录

• 2.5.0 解析原稿时自动转换公式对象，新增理科讲解版式，SVG 图自动转 PNG，原稿 logo 可原位保留
• 2.4.0 截图版式，不装 LibreOffice 的近似预览，字号阶梯按实际可用字号排版
• 2.3.x 标题字号全篇统一，原稿编号和小标签不再丢失，重跑规划保留手改内容
• 2.3.0 版式容量、行高按真实渲染计算、五维自评、墨水杂志和硬边网格风格

License

MIT License. 图标遵循 Lucide 的 ISC License。