zhouwei713/luobo-ppt

选用指南

AI 根据 README 整理 · 2026/10/20 00:36:41

适用场景

适用于口播视频、公众号文章配套的讲解PPT，工作汇报、课件、方案的美化，以及需要原生表格、图表和分析框架的数据复盘、竞品分析等场景。

查看 README 依据

### 数据、流程、分析框架也装得下 时间线、漏斗、中心辐射、2x2 矩阵、原生表格、原生图表，外加 SWOT、PEST、波特五力、商业画布。表格是真表格，图表双击就能改数据。  ### 工具教程的截图有专门的版式 一张截图配几条说明，说明里写上位置，截图上就打一个对应的编号点。几张截图走一个流程，按各自的宽高比分配宽度，中间自动加箭头。  --- ## 它解决什么 AI 做的 PPT，常见的毛病就这几样。 - 整页是一张图片，看着漂亮，错一个字也改不了 - 能编辑的又是一股模板味，谁做出来都长一个样 - 内容装不下就把字越缩越小，投到墙上看不清 - 美化的时候顺手把原文"润色"了，丢了一句都不知道 - 标题写成"数据分析""项目介绍"，只读标题串不成一个故事 - 每页字号忽大忽小，强调色到处都是 - 原稿里的公式、编号、来源说明，美化完就没了 这个 Skill 把这些都变成了脚本能检查的规矩，交付前先过一遍。 --- ## 适合什么场景 - 口播视频、公众号文章配套的讲解 PPT - 拿到一份朴素的工作汇报、课件、方案，想照某张图的风格整体换装 - 理科和教学课件，公式多、示意图多

- AI 工具教程，截图多 - 数据复盘、竞品分析，需要原生表格、图表和分析框架 - 会议室投影，需要更大的字号下限 --- ## 工作原理 两条路线共用一套设计引擎，中间靠三份文件串起来。 ```text 路线 A 美化 原稿.pptx ──解析──┐ ├──> deck.json（每页内容） + style.json（风格） ──> plan.json（版式规划） 路线 B 生成 文章/题目 ──写稿──┘ plan.json ──> 出插画 ──> 组装原生 pptx ──> 渲染预览 ──> 自动检查 ──> 五维自评 ──> 交付 ``` 脚本负责确定性的活，Agent 负责理解内容和审美判断。 ### 美化时少一个字，它都不交 原稿的每一段文字都会先存一份，美化完逐页核对。少一行字就报错，直接点名是哪一页、哪一句。  ### 装不下的内容，写大纲时就拦住 每个版式都标了容量，比如漏斗最多 5 层、每层说明不超过 26 个字。超了就在大纲阶段提醒，排版时自动换一个装得下的版式。 

使用方式

通过支持SKILL.md的Agent（如Claude Code、Codex、Gemini CLI、Cursor、Copilot）使用，安装后向Agent发出自然语言指令即可。

查看 README 依据

[](#安装) [](https://agentskills.io) <br> <img src="docs/images/beautify-loop.gif" width="760" alt="一页朴素的 PPT 慢慢变成美化后的样子"> <br><br> **一个做 PPT 和美化 PPT 的 Agent Skill，装进 Agent 发一句话就能用。** ```text 帮我安装这个 skill：https://github.com/zhouwei713/luobo-ppt ``` [效果示例](#效果示例) · [安装](#安装) · [使用方式](#使用方式) · [它解决什么](#它解决什么) · [工作原理](#工作原理) · [14 套风格](#14-套风格) </div> --- ## 三件事 ### 从零生成

翻页统一淡入淡出。口播稿、讲课这类边讲边放的稿子，卡片、步骤、数据卡会点一下出一条，标题和背景始终在页面上，不会出现飞入旋转这种抢戏的效果。汇报类默认只有翻页效果，想要也可以改成打开页面自动依次出现。静态预览看不出动画，可以单独出一张逐次出现的分镜图和动图来检查。 --- ## 安装  仓库根目录就是 skill 本身（`SKILL.md` 在最外层），装好之后第一次使用时，Skill 会自己检查环境、补装缺少的 Python 包。 ### 方式一：让 Agent 自己装 在 Claude Code、Codex、Gemini CLI、Cursor 这类能执行命令的 Agent 里直接说： ```text 帮我安装这个 skill：https://github.com/zhouwei713/luobo-ppt ``` Agent 会把仓库克隆到它自己的 skills 目录。装完开一个新会话就能用。 ### 方式二：一行命令克隆 把仓库克隆到你的 Agent 的 skills 目录，目录名用 `luobo-ppt`。 ```bash # Claude Code

部署要求

需要Python 3.8+，以及python-pptx、Pillow、numpy、lxml等Python包和一款中文字体。推荐安装LibreOffice以获得更准确的预览。

查看 README 依据

### 方式三：一键安装脚本 想一次装给电脑上所有的 Agent，并且提前把依赖装好： ```bash 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](INSTALL.md)。 ### 方式四：Claude 应用 在仓库页面点 Code → Download ZIP，在 Claude 应用的技能设置里上传这个压缩包。 ### 更新 ```bash cd ~/.claude/skills/luobo-ppt && git pull # 换成你实际的安装目录 ``` ### 依赖 | 类别 | 内容 | |---|---| | 必需 | 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` 会检查并安装缺少的部分。 --- ## 使用方式 装好以后，跟 Agent 这么说： ```text 把这篇文章做成 12 页的口播 PPT，每页带口播备注，用墨水杂志风格。 ``` ```text 帮我美化这份 PPT，照着这张参考图的风格来，文字一个字都别改。 ``` ```text 这份数学课件帮我美化一下，公式都要保留。 ``` ```text 这是一篇工具教程，里面的截图帮我用截图版式排，操作点在截图上标出来。 ``` ```text 主题是"AI 工具号年度复盘"，给我出三张风格样张，我挑一个再往下做。 ``` ```text 这份 PPT 要在会议室投影，用投影模式，字号大一点。 ``` 赶时间可以加一句"快速模式"，它会跳过中间的确认环节。 --- ## 14 套风格 没有参考图时，可以直接报名字。 

已知限制

作者指出，美化时若原稿文字有丢失会报错；每个版式有容量限制，超限会在大纲阶段提醒并自动更换版式。

查看 README 依据

- AI 工具教程，截图多 - 数据复盘、竞品分析，需要原生表格、图表和分析框架 - 会议室投影，需要更大的字号下限 --- ## 工作原理 两条路线共用一套设计引擎，中间靠三份文件串起来。 ```text 路线 A 美化 原稿.pptx ──解析──┐ ├──> deck.json（每页内容） + style.json（风格） ──> plan.json（版式规划） 路线 B 生成 文章/题目 ──写稿──┘ plan.json ──> 出插画 ──> 组装原生 pptx ──> 渲染预览 ──> 自动检查 ──> 五维自评 ──> 交付 ``` 脚本负责确定性的活，Agent 负责理解内容和审美判断。 ### 美化时少一个字，它都不交 原稿的每一段文字都会先存一份，美化完逐页核对。少一行字就报错，直接点名是哪一页、哪一句。  ### 装不下的内容，写大纲时就拦住 每个版式都标了容量，比如漏斗最多 5 层、每层说明不超过 26 个字。超了就在大纲阶段提醒，排版时自动换一个装得下的版式。