萝卜 PPT：能生成和美化原生可编辑 PPT 的 Agent Skill

这是什么

萝卜 PPT（luobo-ppt）是一个开源的 Agent Skill，专门用来做 PPT 和美化 PPT，最终输出的是原生可编辑的 .pptx 文件。它由开发者 zhouwei713 创建，采用 MIT 协议，在 GitHub 上已获得 76 颗星、14 个 fork，目前没有未解决的 issue。

这个 Skill 有两条工作路线：

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

项目版本号为 2.5.0，核心特点是：交给你的永远是原生 PPT，不满意的地方你可以自己修改，不用求着 AI 重新生成。

适合谁

这个 Skill 适合以下场景：

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

无论你是内容创作者、老师、职场白领还是独立开发者，只要经常和 PPT 打交道，都能从中受益。

能做什么

萝卜 PPT 的亮点体现在以下能力：

文字零改动，换身衣服

美化时原稿的每一段文字都会先存一份，美化完逐页核对——少一行字就报错，直接点名是哪一页、哪一句。标题、要点、数字一个字都不改，换掉的是配色、版式、图标和插画。

14 套预设风格

没有参考图时，可以直接报名字调用：薄荷清新、商务蓝、暖橙活力、深色科技、雾紫柔和、纸感手记、黑金述职、几何色块、钴蓝字体、黑灰荧绿、蓝粉柔雾、蓝线发布、墨水杂志、硬边网格。

公式一个不丢

理科课件里用公式编辑器打的公式，在 LibreOffice 里打开常是空白。萝卜 PPT 解析时会把这类公式转成普通文字公式，换什么软件都看得见，也能直接改字。

截图专属版式

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

原生表格与图表

数据、流程、分析框架都装得下：时间线、漏斗、中心辐射、2x2 矩阵、原生表格、原生图表，外加 SWOT、PEST、波特五力、商业画布。表格是真表格，图表双击就能改数据。

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

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

出图后先自检

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

没装 LibreOffice 也能看图自检

预览默认用 LibreOffice 渲染。没装的话，它会按排版数据直接把每一页画出来，12 页大约 10 秒。

没配生图模型也能用

背景、装饰和插画都有程序化的画法。配了 OpenAI、Gemini、火山方舟或任意 OpenAI 兼容接口后插画更丰富，单张失败会自动退回程序化插画。

使用前准备

需要的依赖如下：

类别	内容
必需	Python 3.8+，python-pptx，Pillow，numpy，lxml，一款中文字体
推荐	LibreOffice（预览更准），pdftoppm 或 PyMuPDF，requests（调用生图接口）
可选	生图模型配置，见 config.example.json 和 references/imagegen_config.md

环境检查命令：python3 scripts/setup_check.py --install，会自动检查并安装缺少的部分。

安装方法

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

方式一：让 Agent 自己装

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

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

方式二：一行命令克隆

把仓库克隆到你的 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\你的用户名`。用 skills CLI 也可以一行安装：

npx skills add zhouwei713/luobo-ppt

方式三：一键安装脚本

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

Windows 双击 install.bat，或在 PowerShell 里运行 .\install.ps1。只装给某一个 Agent 加参数，比如 bash install.sh --agent codex。

方式四：Claude 应用

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

使用示例

装好以后，跟 Agent 这样说即可：

“把这篇文章做成 12 页的口播 PPT，每页带口播备注，用墨水杂志风格。”
“帮我美化这份 PPT，照着这张参考图的风格来，文字一个字都别改。”
“这份数学课件帮我美化一下，公式都要保留。”
“这是一篇工具教程，里面的截图帮我用截图版式排，操作点在截图上标出来。”
“主题是‘AI 工具号年度复盘’，给我出三张风格样张，我挑一个再往下做。”
“这份 PPT 要在会议室投影，用投影模式，字号大一点。”

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

风险与注意事项

需要 AI Agent 环境：这是 Agent Skill，需要配合 Claude Code、Codex、Gemini CLI、Cursor 等支持 SKILL.md 标准的 Agent 使用。
生图为可选能力：内置的插画功能全部为程序化绘制，不依赖生图模型；但没有生图模型时插画种类相对有限。
预览渲染依赖：推荐安装 LibreOffice 以获得更准确的渲染效果，但未安装时也有近似预览方案。
中文字体：需要系统具备一款中文字体，否则输出可能缺字。
开源协议：项目采用 MIT License，图标遵循 Lucide 的 ISC License，可以自由使用和修改，但注意保留相关授权信息。