Skip to content
Back to search

luobo-ppt

SkillWorks with Claude CodeGitHub

做 PPT 和美化 PPT 的一站式 skill,输出可编辑的原生 .pptx。从零生成时,给一个题目、一篇文章或口播稿、一份大纲,产出结论式标题、带口播备注、风格统一的 PPT;按参考图美化时,给一份朴素的 .pptx 和一张参考图,文字一字不改地换上统一的配色、母版、版式、图标和插画。当用户说"做个PPT""把这篇文章做成PPT""生成口播PPT""美化PPT""照这张图的风格改PPT""套个风格""用公司模板做""make slides""beautify my deck",或丢来 pptx、potx 模板、文章、大纲时,务必使用此skill。生图模型可配置;没配置时先问用户,可以现场接入模型、搜可商用的公开图库实拍图、用自己的素材,或用程序化插画。口播和讲课的稿子自带逐条出现的动画。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zhouwei713--luobo-ppt/badge.svg)](/listings/zhouwei713--luobo-ppt)

HTML

<a href="/listings/zhouwei713--luobo-ppt"><img src="/api/listings/zhouwei713--luobo-ppt/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

仓库根目录就是 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](https://github.com/vercel-labs/skills) 的话,一行就行:

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](INSTALL.md)。

方式四:Claude 应用

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

更新

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` 会检查并安装缺少的部分。

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 194 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: luobo-ppt
  3. description: 做 PPT 和美化 PPT 的一站式 skill,输出可编辑的原生 .pptx。从零生成时,给一个题目、一篇文章或口播稿、一份大纲,产出结论式标题、带口播备注、风格统一的 PPT;按参考图美化时,给一份朴素的 .pptx 和一张参考图,文字一字不改地换上统一的配色、母版、版式、图标和插画。当用户说"做个PPT""把这篇文章做成PPT""生成口播PPT""美化PPT""照这张图的风格改PPT""套个风格""用公司模板做""make slides""beautify my deck",或丢来 pptx、potx 模板、文章、大纲时,务必使用此skill。生图模型可配置;没配置时先问用户,可以现场接入模型、搜可商用的公开图库实拍图、用自己的素材,或用程序化插画。口播和讲课的稿子自带逐条出现的动画。
  4. ---
  5. # 萝卜 PPT(luobo-ppt)
  6. 两条路线共用一套设计引擎。生成是"写出内容再设计",美化是"抽出原稿内容再设计",从版式规划开始完全一样。
  7. 三份中间文件串起全流程,脚本负责确定性的活,Claude 负责理解内容和审美判断。
  8. | 文件 | 内容 | 美化时 | 生成时 |
  9. |---|---|---|---|
  10. | `deck.json` | 每页的页型、标题、要点、数据、备注 | 从原稿抽取,文字一字不改 | 按 `references/generate.md` 写出来 |
  11. | `style.json` | 色板、字体、圆角、装饰、插画风格 | 从参考图抽取 | 参考图抽取,或从预设库挑 |
  12. | `plan.json` | 每页版式、图标、插画和提示词 | `plan_deck.py` 起草,Claude 审改 | 同左 |
  13. 下文 `$S` 指本 skill 的 scripts 目录,`$W` 指本次的工作目录(如 `./ppt_work`)。Windows 上把 `python3` 换成 `python`。
  14. ## 开工前
  15. 1. **判断路线**
  16. - 用户给了 .pptx,要换个好看的样子 → 路线 A 美化
  17. - 给的是题目、文章、口播稿、大纲或其他素材,要做成 PPT → 路线 B 生成
  18. - 给了 .pptx 但要重写内容、调整结构 → 路线 B,把 pptx 当素材读
  19. - 另外给了企业 VI 手册、品牌规范,或者说"按公司 VI 做""用我们的品牌色"→ 两条路线都先做"品牌套件",风格从手册来,不再读参考图、不出风格样张
  20. - 另外给了公司的 PPT 模板(.pptx 或 .potx),或者说"用公司模板做""套我们的模板"→ 两条路线都先做"公司模板",在模板上出稿,不再读参考图、不出风格样张。模板和 VI 手册同时给时以模板为准,手册只拿来核对颜色
  21. 2. **环境自检**,之前通过的话一秒内结束,否则自动补装依赖。退出码非 0 就把建议告诉用户并停下;只缺推荐组件(如 LibreOffice)可以继续,pipeline 会改用 `render_lite.py` 按排版数据直接画近似预览,排版、配色、溢出照样能看,交付时说明预览是近似图。想跳过 LibreOffice 提速也可以加 `--lite`。
  22. ```bash
  23. python3 $S/setup_check.py --quick --install
  24. ```
  25. 3. **生图状态** `python3 $S/make_assets.py $W --status`,用一句话告诉用户接了哪家模型。没有模型时先别默认走程序化插画,等版式规划出来、确实需要配图时按下面的"配图来源"问用户。配置方法见 `references/imagegen_config.md`。
  26. 4. **一次提问**问清路线需要的选择,其余用默认值。用户说"直接做""不用问"或者不在场时,全部用默认值,交付时列出做过的选择。
  27. 5. **快速模式**:用户说"快速模式""别问了""赶时间"时,跳过风格卡、大纲、设计规格的确认,五维自评只修一轮"要修","顺手改"写进交付说明不动手。快速模式只省掉等用户确认的环节,逐字核对、图表和小字核对、全部 QA 检查照常跑,ERROR 没清零就不交付。12 页左右的稿子,正常 15 到 25 分钟,快速模式 10 分钟上下;时间大头在转写文字和看图,脚本本身只要一两分钟。
  28. - 美化:力度 light / standard / full(默认 full),是否允许精修文字(默认不允许)
  29. - 生成:用途、受众、时长、有无参考图、要不要口播备注,默认值见 `references/generate.md`
  30. ## 路线 A 美化
  31. 1. **解析原稿** `python3 $S/extract_deck.py 原稿.pptx $W`,然后看 `source_png/sheet.png`。脚本会修复 LibreOffice 打不开的 zip,也能读出藏在 descr 属性里的口播备注。
  32. 2. **读参考图** `python3 $S/extract_style.py 参考图.png $W`,再亲自看图,按 `references/style_extraction.md` 写 `$W/style.json`,然后 `python3 $S/style_card.py $W` 出风格卡。用户在场就发风格卡确认。
  33. 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` 原样保留。原稿里的图表在 `deck.draft.json` 每页的 `charts` 里已经整理成现成的图表写法,用 `chart` 页型照抄进去,`number_format`、`title`、`x_title`、`y_title` 一个都不能丢,丢了图上的单位和坐标轴说明就跟着没了。一页有两三个图表时整组抄进 `charts`,散点图带着每组的 `x` 原样抄。原稿表格在 `tables` 里,抄进 `table` 页型。页面底部带 * ※ 的注释、来源,role 是 footnote,写进该页的 `footnote` 和 `source`,两个可以同时写。原稿里的软件截图(`media/` 下的图片)用 `screenshot` 或 `screenshots` 页型,截图会放进统一的窗口外框,讲解点可以用 `at` 打在截图上。
  34. 4. 接着走下面的"版式、出图与检查"。
  35. ## 路线 B 生成
  36. 开始前先读 `references/generate.md`,里面有故事线、结论式标题、密度、口播备注和页型选择的全部规则。
  37. 1. **分析素材** `python3 $S/analyze_source.py $W --file 文章.md`(只有题目用 `--topic "…"`,可加 `--minutes 3`)。只有题目或需要补充事实时,先搜索查证,查不到的不写。
  38. 2. **写 deck.json**:先定故事线,再按"内容形状决定页型"逐页写,标题写结论,屏幕放关键词,完整的话放 `notes`。分了章节的稿子在封面后放一页 `toc` 目录(不写 items 会自动列章节),卡片页连得多了插一页 `question` 大问句或 `big_quote` 大引文。工具教程类的素材有截图时,一张图配几个操作点用 `screenshot`,几张图走流程用 `screenshots`。除了常规的卡片、步骤、对比,还有时间线、漏斗、中心辐射、2x2 矩阵、原生表格、原生图表和 SWOT/PEST/五力/商业画布,拿不准装不装得下就 `python3 $S/layout_info.py <版式名>` 查容量和示例。
  39. 3. **检查大纲** `python3 $S/outline_check.py $W`,修到没有 ERROR,把 outline.md 里的"只读标题"发给用户确认。
  40. 4. **定动画**:口播稿、讲课按 `scenario` 默认就是逐条点击出现,汇报默认只有翻页效果,一般不用写。用户提了要求或场景特殊再写 `meta.animation`(`none`、`transition`、`auto`、`click`),说明见 `references/deck_schema.md` 的"动画"一节。
  41. 5. **定风格**:有参考图走路线 A 第 2 步;没有就 `python3 $S/style_previews.py $W --auto` 出三张样张(用户自己的封面和内容页),发 `previews/sheet.png` 让用户挑,再 `--apply <id>`。预设在 `references/styles/`,共十四套,每套的硬规则排版时要遵守。要在会议室投影的,在 `meta` 里写 `"projection": true`,字号下限会抬高。
  42. 6. 接着走下面的"版式、出图与检查"。
  43. ## 公司模板(有 .pptx / .potx 模板时)
  44. 用户给的模板直接当底稿,母版上的背景、logo、色条、页脚原样留在每一页,配色和字体从模板主题里来,内容只排在母版图形让出来的区域里。规则见 `references/template.md`。
  45. 1. **读模板** `python3 $S/template_kit.py read 模板.pptx $W`。模板里的示例页会去掉,只留母版和版式;写出 `template.json`、`style.json` 和 `template/template_card.png`。旧版 .ppt / .pot 先让用户在 PowerPoint 里另存为 .pptx。
  46. 2. **看确认卡**:封面、章节页、内容页、结尾页各用模板的哪个版式,红框是内容能放的区域,下面是主色、强调色、字体。把确认卡发给用户。终端里的 NOTE 要转告用户,常见的有:主题色还是 PowerPoint 默认的蓝橙(主色可能不是公司色)、模板不是 16:9(内容会缩小,上下留白)、版式中间有图形(内容可能压上去)。
  47. 3. **改了 template.json 就重新生成风格** `python3 $S/template_kit.py apply $W`。主色、强调色、每类页面用哪个版式(`use`)、每个版式的可用区域(`free`,英寸)都能手改。
  48. 4. 回到原来的路线继续,跳过读参考图和挑风格。页眉 logo 和页脚由模板负责,不要写进 `stamps`。
  49. ## 品牌套件(有企业 VI 手册时)
  50. VI 手册规定的是精确色值、字体、logo 的用法和安全空间。拿手册页当参考图取色会取错,色板只占页面的一小块,所以有手册时风格只从手册来,规则见 `references/brand.md`。
  51. 1. **拆页** `python3 $S/brand_kit.py pages 手册.pdf $W`,手册页面放在 `$W/brand/pages/`,一整张长图导出的手册会按页切开。文字层里的色值会列出来;手册是整页图片时没有文字层,要看图读。
  52. 2. **读手册写 brand.json**:把 `brand.draft.json` 填好另存为 `$W/brand.json`。色值一律抄手册上印的数字,不从图上取色;每个颜色标 role(primary、secondary、accent、extra、text、background、neutral)。字体、logo 安全空间和最小尺寸、标志性元素(标题竖条、粗描边加硬投影)、禁用项、IP 形象和辅助图形都照手册写。logo 和形象用 `brand_kit.py crop $W 页面.png x0 y0 x1 y1 名字 --clear` 从页面上截下来(白底变透明);手册没有深底用的反白 logo 时,`brand_kit.py plate` 做一个白底版。手册对形象有限制的(比如"只用于运营活动"),写进 rules 并照办。
  53. 3. **核对** `python3 $S/brand_kit.py check $W`,每个色值会回到手册页面上找,一个像素都找不到的多半读错了,回去再看。
  54. 4. **生成风格** `python3 $S/brand_kit.py apply $W`,写出 `style.json` 和 `brand/brand_card.png`。把品牌卡发给用户确认颜色、字体和 logo,代替风格卡。
  55. 5. 回到原来的路线继续,跳过读参考图和挑风格。logo 每页自动放在手册要求的位置并留出安全空间,不要再写进 `stamps`;某页不要 logo 就在这页写 `"logo": false`。手册内页用文字页眉、不放 logo 图形的,`logo.content` 写 header。IP 形象只放封面、章节页、结尾页和需要情绪的页:在那一页写 `"art": "question"` 这类动作名(brand.json 里给每个形象标 mood),一份稿子内容页最多出现四次,整张放、不裁切。数据页、列表页不放形象。
  56. 6. QA 多出一组 brand 检查:手册以外的颜色、手册不许的渐变、logo 安全空间里有别的东西、logo 小于最小尺寸都是 ERROR。手册字体没装是 WARN,要告诉用户装上,或者发给别人前在 PowerPoint 里嵌入字体。
  57. ## 版式、出图与检查(两条路线共用)
  58. 1. **版式规划** `python3 $S/plan_deck.py $W --level full`(有生图模型时加 `--sheets`,一张大图切出几张小插画,风格更统一也更省)。
  59. 重跑时内容没变的页会保留原来的规划(包括手改过的版式和插画提示词),要全部重排加 `--reset`。
  60. 审 plan.json:版式贴不贴内容(`references/layouts.md`)、图标达不达意(`references/icons.md`)、插画提示词具不具体(`references/image_prompts.md`)。内容超出版式容量时脚本会自动换版式,并写进 design_spec.md 的"容量提醒",出图前先处理掉。
  61. 把生成的 design_spec.md 发给用户确认后再出图,出图最花钱。快速模式跳过确认。
  62. 没有生图模型时再跑一次 `make_assets.py $W --status`,输出里有 `ASK` 就按"配图来源"问用户,和设计规格放在同一次确认里问。
  63. 2. **出图、组装、自检**一条命令:
  64. ```bash
  65. python3 $S/pipeline.py $W
  66. ```
  67. 依次运行 make_assets(插画、背景、装饰,AI 提示词先落盘到 `prompts/`)、build_deck、render、qa_check、compare_sheet、review。
  68. 然后打开 `out/fine_print.md` 单独对一遍:每个图表的类别、系列名、数字显示出来的样子(带不带单位)、图表标题和坐标轴标题,以及每条注释、来源、单位说明和带 * ※ 的小字,左边原稿右边成品。正文逐字都对的稿子,意思常常就变在这些地方,交付前一定看。
  69. 有逐条动画(auto 或 click)时再跑 `python3 $S/anim_preview.py $W`,看 `out/anim/storyboard.png` 确认出现顺序对不对,交付时可以附上 `out/anim/preview.gif`。
  70. | 检查 | 级别 | 处理 |
  71. |---|---|---|
  72. | 美化时原稿文字缺失或被改;生成时 deck.json 的文字没上页面 | ERROR | 对照原文或 deck.json 修正 |
  73. | 文字溢出、文本框重叠、文字越过底线(压到胶囊条或页脚) | ERROR | 换版式、拆页,或用 `free` 版式手工摆 |
  74. | 强调色一页超过 3 处或面积超过 8% | WARN | 只留一处强调 |
  75. | 文字压插画、对比度不足、出界、正文过小 | WARN | 看图判断,多数要修 |
  76. | 图表少了,或者类别、系列名、数据、显示出来的数字(单位)、图表标题、坐标轴标题和原稿对不上 | ERROR | 按 deck.draft.json 的 charts 照抄 |
  77. | 注释、来源、单位说明这类小字被改了,比如 * ※ 符号丢了 | ERROR | 原样恢复,符号也要留 |
  78. | 动画指向不存在的形状 | ERROR | 重跑 build_deck.py |
  79. | 一页要点超过 6 次才出完 | WARN | 拆页,或这一页改 `auto` |
  80. | 新增的页眉、页码、步骤编号 | INFO | 正常 |
  81. 3. **五维自评**:看 `out/sheet.png` 和逐页 PNG,对照 `out/review.md` 里脚本数出的证据,按 `references/critique.md` 给统一、层级、细节、传达、节奏各打 0 到 10 分,写出保留、要修、顺手改三张清单。"要修"的交付前改掉,改完只重跑受影响的步骤,最多三轮。
  82. ## 配图来源
  83. 需要配图但没有生图模型时,先问用户选哪种,不要自己默认。一次问清,四个选项:
  84. 1. **现在接入生图模型**:按 `references/imagegen_config.md` 帮用户配好(OpenAI、Gemini、即梦/Seedream、HiAPI 或兼容接口)。用户在聊天里给 key 时只放进环境变量,不写进任何文件,提醒他用完作废,`make_assets.py $W --status` 确认生效后照常出图。
  85. 2. **搜公开图库的实拍图**:适合讲具体东西的稿子,比如门店、产品、城市、食物、活动现场。抽象概念(效率、增长、底层逻辑)搜出来大多是俗套图,这类页继续用插画。
  86. 3. **用自己的素材**:用户给图片文件或文件夹,按页对应放进去。
  87. 4. **用程序化插画**:不联网、不花钱,风格统一。
  88. 用户不在场、说了"直接做"或快速模式时选 4,交付时说明可以换成实拍图或接入模型。几种可以混用,比如封面用自己的照片,其余页用插画。
  89. 实拍图和用户素材都用 `photo_assets.py`:
  90. ```bash
  91. python3 $S/photo_assets.py sources # 现在能用哪些图库
  92. python3 $S/photo_assets.py search $W hero_01 "coffee shop interior" # 关键词用英文、写具体名词
  93. python3 $S/photo_assets.py pick $W hero_01 3 # 看 photos/hero_01/sheet.png 挑一张
  94. python3 $S/photo_assets.py local $W hero_01 用户的图.jpg # 用户自己的图
  95. python3 $S/photo_assets.py drop $W hero_01 # 退回插画
  96. ```
  97. - 搜图前先看 plan.json 里哪些图位值得放照片:封面、章节页、结尾页和图文页的大图位最合适;内容页右上角的小装饰位放照片偏挤,脚本会提醒,这类页继续用插画
  98. - 候选图先看 `sheet.png` 再挑,挑和这一页内容真正相关、画面干净、没有水印和大段文字的,特别留意杯子、招牌、包装上别家的品牌名;都不合适就换关键词或退回插画,宁缺毋滥
  99. - 照片会按图位裁切、圆角、加柔和投影;想让照片和配色更统一加 `--tint 0.12`;主体被裁掉就用 `--focus X Y` 调保留位置
  100. - 只收可商用、可修改的图:CC0、公有领域、CC BY、CC BY-SA,以及 Pexels、Unsplash、Pixabay 自家协议(这三家要用户在环境变量里配免费 key,见 `references/imagegen_config.md`)
  101. - CC BY 和 CC BY-SA 必须署名:脚本会打出 `CREDIT` 行。生成模式把它加到该页 `notes` 末尾;美化模式不改备注,把 `out/image_credits.md` 交给用户自己决定放哪
  102. - 输出 `NO_NETWORK` 说明命令行连不上图库(网络受限)。这时如果有浏览器工具,可以在浏览器里请求 Openverse 接口(`https://api.openverse.org/v1/images/?q=关键词&license_type=commercial,modification`),挑好图拿到图片文件,把作者、原始页面、协议、原图宽高写进一个 json,用 `local $W hero_01 图片 --credit meta.json` 放进去,署名照样记录;没有浏览器就告诉用户,改用他的素材或程序化插画
  103. - 原图太小(裁到图位后不到图位宽度的一半)脚本会提醒会发虚,换一张大图
  104. - 选好的照片和用户素材之后重跑 `make_assets.py`(包括 `--force`)都会保留,除非在 `--only` 里点名
  105. ## 交付
  106. - `out/beautified.pptx`,文件名用 `原名_美化版.pptx` 或 `主题.pptx`
  107. - 美化附 `out/compare.png` 前后对比图,生成附 `out/sheet.png` 全览图
  108. - 一句话报五维自评的分数和最弱的一项
  109. - 用了实拍图时附 `out/image_credits.md`,需要署名的图提醒用户
  110. - 一两句话说明风格、插画来源(哪家模型、程序化插画、图库实拍或用户素材)、字体,美化时说明有无精修文字,生成时说明哪些内容需要用户再核实
  111. - 用户连接了本地文件夹时,写回素材所在的位置
  112. ## 硬规则
  113. 通用
  114. 1. 所有文字都是可编辑文本框,卡片、胶囊条、分隔线用原生形状,只有背景、插画、图标、笔刷是图片。
  115. 2. 参考图只用来抽风格,不裁切、不贴进 PPT。
  116. 3. AI 插画里不出现文字(产品首字母这种图形化字母除外),提示词始终带负面约束。
  117. 4. 程序化插画是兜底方案,交付时如实说明,不说成 AI 生成。
  118. 5. 逐字核对和 QA 检查在任何模式下都不跳过,快速模式、用户不在场也一样。
  119. 6. 做稿子的过程中不改 skill 自己的文件。遇到 skill 的问题,绕过去完成交付,再把问题写进交付说明,由用户决定要不要改 skill。
  120. 美化
  121. 7. 默认不改任何文字;用户允许精修时,改动逐条列给用户过目。
  122. 8. 页序和页数与原稿一致,备注保留。
  123. 生成
  124. 9. 数据和事实只用素材里的或查证过的,标上 `source`;查不到就不写,绝不编数字。图表数据改了,标题和 insights 的结论跟着重写。
  125. 10. 大纲(只读标题)经用户确认后再做设计;风格和设计规格同理,快速模式除外。
  126. ## 局部修改
  127. - **单页重做**:改 plan.json 里那一页的 `layout`、`icons`,或改 `prompts/hero_NN.md`,再 `make_assets.py $W --only hero_NN --force` 和 `pipeline.py $W`。手改的键写进这页的 `locked` 就不会被之后的重新规划覆盖,换了版式用 `plan_deck.py $W --replan N` 只重排这一页(见 `references/layouts.md`)
  128. - **换风格**:换 style.json(参考图或 `style_previews.py --apply`),插画 `--force` 重出,deck.json 和 plan.json 可以沿用
  129. - **特殊页面**:该页 layout 设为 `free`,在 deck.json 或 plan 里直接写 `elements`(格式见 `references/layouts.md`)
  130. - **只要轻度美化**:`plan_deck.py $W --level light`,不出插画
  131. ## 常见问题
  132. - `soffice` 转换失败:渲染只影响预览,不影响交付文件;先确认 `extract_deck.py` 产出的 `source.pptx` 能打开
  133. - 美化后原稿的动画没了:重建时不保留原稿动画,默认只加翻页效果。用户要动画就在 deck.json 的 `meta` 里写 `"animation": "click"` 或 `"auto"` 重跑
  134. - 预览字体和用户电脑不同:预览用思源黑体代替微软雅黑,版式留了余量,见 `references/fonts.md`
  135. - 生图失败:自动换程序化插画,`assets/manifest.json` 记录错误,交付时说明哪几页是兜底图
  136. ## 文件索引
  137. | 路径 | 用途 |
  138. |---|---|
  139. | `references/generate.md` | 生成路线的完整规则(生成前必读) |
  140. | `references/deck_schema.md` | deck.json 字段和全部页型 |
  141. | `references/critique.md` | 五维自评的评分规则和常见改法 |
  142. | `references/layouts.md` | 版式库、适用场景、容量、free 版式元素格式 |
  143. | `scripts/layout_info.py` | 查版式容量和 deck.json 示例,`--check $W` 逐页查超容量 |
  144. | `references/style_extraction.md` | 从参考图读出 style.json |
  145. | `references/brand.md` | 企业 VI 手册做成品牌套件:brand.json 字段、logo 规则、品牌检查 |
  146. | `references/template.md` | 在公司 .pptx / .potx 模板上出稿:template.json 字段、版式怎么选、可用区域怎么算 |
  147. | `references/styles/` | 十四套风格预设(index.json + 每套 json,含硬规则和 imagery 标签),样张在 `assets/style_gallery.jpg`(第 N 行对应 index.json 里的 gallery_row) |
  148. | `references/image_prompts.md` | 视觉锚点和插画提示词 |
  149. | `references/imagegen_config.md` | 生图接口配置 |
  150. | `references/fonts.md` | 字体选择和兼容性 |
  151. | `references/icons.md` | 内置图标清单 |
  152. | `INSTALL.md` / `install.sh` / `install.ps1` / `install.bat` | 安装说明和一键安装 |
  153. | `config.example.json` | 生图配置模板 |
README.md · README · 393 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="docs/images/banner-dark.png">
  4. <source media="(prefers-color-scheme: light)" srcset="docs/images/banner-light.png">
  5. <img alt="萝卜 PPT,丢进来一篇文章或一份旧 PPT,拿回一份能直接改字的原生 PPT" src="docs/images/banner-light.png" width="100%">
  6. </picture>
  7. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  8. [![Version](https://img.shields.io/badge/version-2.9.0-F97316)](#更新记录)
  9. [![Output](https://img.shields.io/badge/Output-原生可编辑%20.pptx-1F7A55)](#效果示例)
  10. [![Runtime](https://img.shields.io/badge/Runtime-Claude%20·%20Codex%20·%20Gemini%20CLI%20·%20Cursor%20·%20Copilot-0E5A3E)](#安装)
  11. [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-SKILL.md-green)](https://agentskills.io)
  12. <br>
  13. <img src="docs/images/beautify-loop.gif" width="760" alt="一页朴素的 PPT 慢慢变成美化后的样子">
  14. <br><br>
  15. **一个做 PPT 和美化 PPT 的 Agent Skill,装进 Agent 发一句话就能用。**
  16. ```text
  17. 帮我安装这个 skill:https://github.com/zhouwei713/luobo-ppt
  18. ```
  19. [效果示例](#效果示例) · [安装](#安装) · [使用方式](#使用方式) · [它解决什么](#它解决什么) · [工作原理](#工作原理) · [14 套风格](#14-套风格)
  20. </div>
  21. ---
  22. ## 三件事
  23. ### 从零生成
  24. 给它一个题目、一篇文章、一份口播稿或大纲,它先写出结论式标题和口播备注,再排版、配图、加动画。
  25. ![从零生成](docs/images/feature-1-generate.png)
  26. ### 照参考图美化
  27. 给它一份朴素的 .pptx 和一张参考图,它把原文一字不改地搬进统一的配色、版式、图标和插画里,少一个字都不交。
  28. ![照参考图美化](docs/images/feature-2-beautify.png)
  29. ### 原生可编辑
  30. 文字是文本框,表格是真表格,图表是 PowerPoint 原生图表,双击就能改数据。PowerPoint、WPS、Keynote 都能打开。
  31. ![原生可编辑](docs/images/feature-3-native-pptx.png)
  32. ---
  33. ## 效果示例
  34. ### 同一页内容,美化前后
  35. 左边是原稿,右边是换上暖橙风格之后的样子。标题和数字一个没动,柱状图还是能改数据的原生图表。
  36. ![一页图表美化前后](docs/images/before-after-chart.png)
  37. ### 套用公司自己的模板
  38. 给它一份公司的 .pptx 或 .potx 模板,它直接在模板上出稿。母版上的 logo、色条、页脚每页都在,颜色和字体跟着模板主题走,内容只排在 logo 和色条让出来的地方。红色封面、深色模板也能自动换一套看得清的字色。
  39. ![在公司模板上出稿](docs/images/company-template.jpg)
  40. ### 文字一个不动,换身衣服
  41. 上面一排是原稿,下面一排是给了一张薄荷绿参考图之后美化出来的。标题、要点、数字一个字都没改,换掉的是配色、版式、图标和插画。
  42. ![美化前后对比](docs/images/beautify-before-after.jpg)
  43. ### 同一份原稿,换一张参考图就是另一套风格
  44. 从上往下依次是原稿、薄荷参考图、深色科技、墨水杂志。四个版本文字完全一样。
  45. ![同一份原稿换三种风格](docs/images/one-deck-three-styles.jpg)
  46. ### 参考图里有什么,封面就画什么
  47. 参考图是一张环保科普封面,山坡上立着风车。美化后的封面照着参考图的元素画出了风景,整张图没接任何 AI 生图模型,是程序画出来的。
  48. ![照参考图美化](docs/images/follow-reference-image.jpg)
  49. ### 理科课件,公式一个不丢
  50. 一份高中数学导数复习课,原稿里有 12 个用公式编辑器打的公式,在 LibreOffice 里打开全是空白。解析时它会把这类公式转成普通文字公式,换什么软件都看得到,也能直接改字。
  51. ![理科课件美化前后](docs/images/math-deck-before-after.jpg)
  52. ![公式不再是空白](docs/images/equations-kept.jpg)
  53. ### 一篇文章,直接变成能讲的 PPT
  54. 把一篇公众号文章丢给它,生成 15 页的口播 PPT。它先写一份只有标题的"幽灵稿"让你确认,每页标题都是一句结论,每页都带口播备注。
  55. ![文章做成的 PPT](docs/images/article-to-deck.jpg)
  56. ### 数据、流程、分析框架也装得下
  57. 时间线、漏斗、中心辐射、2x2 矩阵、原生表格、原生图表,外加 SWOT、PEST、波特五力、商业画布。表格是真表格,图表双击就能改数据。
  58. ![复杂内容的版式](docs/images/rich-layouts.jpg)
  59. ### 工具教程的截图有专门的版式
  60. 一张截图配几条说明,说明里写上位置,截图上就打一个对应的编号点。几张截图走一个流程,按各自的宽高比分配宽度,中间自动加箭头。
  61. ![截图版式](docs/images/screenshot-layouts.jpg)
  62. ---
  63. ## 它解决什么
  64. AI 做的 PPT,常见的毛病就这几样。
  65. - 整页是一张图片,看着漂亮,错一个字也改不了
  66. - 能编辑的又是一股模板味,谁做出来都长一个样
  67. - 内容装不下就把字越缩越小,投到墙上看不清
  68. - 美化的时候顺手把原文"润色"了,丢了一句都不知道
  69. - 标题写成"数据分析""项目介绍",只读标题串不成一个故事
  70. - 每页字号忽大忽小,强调色到处都是
  71. - 原稿里的公式、编号、来源说明,美化完就没了
  72. 这个 Skill 把这些都变成了脚本能检查的规矩,交付前先过一遍。
  73. ---
  74. ## 适合什么场景
  75. - 口播视频、公众号文章配套的讲解 PPT
  76. - 拿到一份朴素的工作汇报、课件、方案,想照某张图的风格整体换装
  77. - 理科和教学课件,公式多、示意图多
  78. - AI 工具教程,截图多
  79. - 数据复盘、竞品分析,需要原生表格、图表和分析框架
  80. - 会议室投影,需要更大的字号下限
  81. ---
  82. ## 工作原理
  83. 两条路线共用一套设计引擎,中间靠三份文件串起来。
  84. ```text
  85. 路线 A 美化 原稿.pptx ──解析──┐
  86. ├──> deck.json(每页内容) + style.json(风格) ──> plan.json(版式规划)
  87. 路线 B 生成 文章/题目 ──写稿──┘
  88. plan.json ──> 出插画 ──> 组装原生 pptx ──> 渲染预览 ──> 自动检查 ──> 五维自评 ──> 交付
  89. ```
  90. 脚本负责确定性的活,Agent 负责理解内容和审美判断。
  91. ### 美化时少一个字,它都不交
  92. 原稿的每一段文字都会先存一份,美化完逐页核对。少一行字就报错,直接点名是哪一页、哪一句。
  93. ![少一个字都不交](docs/images/qa-fidelity.png)
  94. ### 装不下的内容,写大纲时就拦住
  95. 每个版式都标了容量,比如漏斗最多 5 层、每层说明不超过 26 个字。超了就在大纲阶段提醒,排版时自动换一个装得下的版式。
  96. ![写大纲时就拦住](docs/images/outline-capacity.png)
  97. ### 出图以后,先给自己挑一遍刺
  98. 先查丢字、溢出、字压页脚、对比度、强调色用量这些硬伤,再把能数出来的证据列成表,从统一、层级、细节、传达、节奏五个方面给自己打分,要修的修完再交。
  99. ![五维自评证据](docs/images/self-review.png)
  100. ### 没装 LibreOffice 也能看图自检
  101. 预览默认用 LibreOffice 渲染。没装的话,它会按排版数据直接把每一页画出来,12 页大概 10 秒,左边是 LibreOffice,右边是近似画法。
  102. ![近似预览](docs/images/lite-preview.png)
  103. ### 没配生图模型也能用
  104. 背景、装饰和插画都有程序化的画法,上面所有的图都是在没接生图模型的情况下跑出来的。配了 OpenAI、Gemini、火山方舟、HiAPI 或任意 OpenAI 兼容接口,插画会更丰富,单张失败会自动退回程序化插画。
  105. 需要配图又没有模型时,Agent 会先问你想怎么配:现场接一个生图模型,去公开图库搜实拍图,用你自己的照片,还是用程序化插画。搜图只收能商用的图(CC0、公有领域、CC BY、CC BY-SA,配了 key 还能用 Pexels、Unsplash、Pixabay),照片会按图位裁好、加圆角和投影,需要署名的会单独列一份图片来源清单给你。
  106. ### 口播和讲课自带逐条出现的动画
  107. 翻页统一淡入淡出。口播稿、讲课这类边讲边放的稿子,卡片、步骤、数据卡会点一下出一条,标题和背景始终在页面上,不会出现飞入旋转这种抢戏的效果。汇报类默认只有翻页效果,想要也可以改成打开页面自动依次出现。静态预览看不出动画,可以单独出一张逐次出现的分镜图和动图来检查。
  108. ---
  109. ## 安装
  110. ![三步装好](docs/images/install-steps.png)
  111. 仓库根目录就是 skill 本身(`SKILL.md` 在最外层),装好之后第一次使用时,Skill 会自己检查环境、补装缺少的 Python 包。
  112. ### 方式一:让 Agent 自己装
  113. 在 Claude Code、Codex、Gemini CLI、Cursor 这类能执行命令的 Agent 里直接说:
  114. ```text
  115. 帮我安装这个 skill:https://github.com/zhouwei713/luobo-ppt
  116. ```
  117. Agent 会把仓库克隆到它自己的 skills 目录。装完开一个新会话就能用。
  118. ### 方式二:一行命令克隆
  119. 把仓库克隆到你的 Agent 的 skills 目录,目录名用 `luobo-ppt`。
  120. ```bash
  121. # Claude Code
  122. git clone https://github.com/zhouwei713/luobo-ppt.git ~/.claude/skills/luobo-ppt
  123. # Codex 及其他支持 SKILL.md 开放标准的 Agent
  124. git clone https://github.com/zhouwei713/luobo-ppt.git ~/.agents/skills/luobo-ppt
  125. # Gemini CLI
  126. git clone https://github.com/zhouwei713/luobo-ppt.git ~/.gemini/skills/luobo-ppt
  127. # Cursor
  128. git clone https://github.com/zhouwei713/luobo-ppt.git ~/.cursor/skills/luobo-ppt
  129. ```
  130. Windows 上 `~` 是 `C:\Users\你的用户名`。只想在某个项目里用,就克隆到项目里的 `.claude/skills/`、`.agents/skills/` 这类目录。
  131. 用 [skills CLI](https://github.com/vercel-labs/skills) 的话,一行就行:
  132. ```bash
  133. npx skills add zhouwei713/luobo-ppt
  134. ```
  135. ### 方式三:一键安装脚本
  136. 想一次装给电脑上所有的 Agent,并且提前把依赖装好:
  137. ```bash
  138. git clone https://github.com/zhouwei713/luobo-ppt.git
  139. cd luobo-ppt
  140. bash install.sh
  141. ```
  142. Windows 双击 `install.bat`,或在 PowerShell 里运行 `.\install.ps1`。脚本会自动找到装了哪些 Agent,分别装进去,检查并补装依赖,最后生成一份两页的小样做自测。只装给某一个 Agent 加参数就行,比如 `bash install.sh --agent codex`,更多参数见 [INSTALL.md](INSTALL.md)。
  143. ### 方式四:Claude 应用
  144. 在仓库页面点 Code → Download ZIP,在 Claude 应用的技能设置里上传这个压缩包。
  145. ### 更新
  146. ```bash
  147. cd ~/.claude/skills/luobo-ppt && git pull # 换成你实际的安装目录
  148. ```
  149. ### 依赖
  150. | 类别 | 内容 |
  151. |---|---|
  152. | 必需 | Python 3.8+,python-pptx,Pillow,numpy,lxml,一款中文字体 |
  153. | 推荐 | LibreOffice(预览更准),pdftoppm 或 PyMuPDF,requests(调用生图接口) |
  154. | 可选 | 生图模型配置,见 `config.example.json` 和 `references/imagegen_config.md` |
  155. `python3 scripts/setup_check.py --install` 会检查并安装缺少的部分。
  156. ---
  157. ## 使用方式
  158. 装好以后,跟 Agent 这么说:
  159. ```text
  160. 把这篇文章做成 12 页的口播 PPT,每页带口播备注,用墨水杂志风格。
  161. ```
  162. ```text
  163. 帮我美化这份 PPT,照着这张参考图的风格来,文字一个字都别改。
  164. ```
  165. ```text
  166. 这份数学课件帮我美化一下,公式都要保留。
  167. ```
  168. ```text
  169. 这是一篇工具教程,里面的截图帮我用截图版式排,操作点在截图上标出来。
  170. ```
  171. ```text
  172. 主题是"AI 工具号年度复盘",给我出三张风格样张,我挑一个再往下做。
  173. ```
  174. ```text
  175. 这份 PPT 要在会议室投影,用投影模式,字号大一点。
  176. ```
  177. ```text
  178. 这是我们公司的 PPT 模板,用它把这份周报做成 PPT。
  179. ```
  180. 赶时间可以加一句"快速模式",它会跳过中间的确认环节。
  181. ---
  182. ## 14 套风格
  183. 没有参考图时,可以直接报名字。
  184. ![十四套风格](docs/images/14-styles.jpg)
  185. | 风格 | 英文名 | 适合 |
  186. |---|---|---|
  187. | 薄荷清新 | mint-fresh | 科普讲解、工具教程、环保生活、小白入门 |
  188. | 商务蓝 | business-blue | 工作汇报、方案提案、B 端产品、培训 |
  189. | 暖橙活力 | warm-orange | 个人分享、活动宣传、营销增长、生活方式 |
  190. | 深色科技 | dark-tech | AI 与科技产品、发布会、开发者内容 |
  191. | 雾紫柔和 | lavender-soft | 情绪心理、美妆穿搭、读书感悟 |
  192. | 纸感手记 | paper-notes | 读书笔记、方法论、个人成长、知识分享 |
  193. | 黑金述职 | black-gold | 晋升述职、高层汇报、年度总结、高端品牌 |
  194. | 几何色块 | geo-blocks | 运营复盘、团队年终、数据报告、市场活动 |
  195. | 钴蓝字体 | cobalt-type | 设计分享、观点演讲、学术报告、创意提案 |
  196. | 黑灰荧绿 | ink-lime | 业绩汇报、销售复盘、指标分析、项目进度 |
  197. | 蓝粉柔雾 | pastel-mist | 实习汇报、校园分享、个人总结、轻量课程 |
  198. | 蓝线发布 | wave-launch | 新品发布、科技大会、产品路线图、融资路演 |
  199. | 墨水杂志 | ink-magazine | 观点分享、读书与人文、研究报告、个人品牌 |
  200. | 硬边网格 | swiss-grid | 产品发布、方法论、数据复盘、设计提案 |
  201. ---
  202. ## 仓库结构
  203. ```text
  204. .
  205. ├── SKILL.md Skill 主说明,Agent 读这个
  206. ├── INSTALL.md 安装说明
  207. ├── install.sh / install.ps1 / install.bat
  208. ├── config.example.json 生图模型配置模板
  209. ├── scripts/ 解析、规划、组装、渲染、检查、自评的全部脚本
  210. ├── references/ 版式库、deck.json 字段、风格提取、14 套风格预设、自评规则
  211. ├── assets/ 图标库、风格样张
  212. └── docs/images/ README 用图
  213. ```
  214. ---
  215. ## 设计理念
  216. 好看的 PPT 少有靠堆装饰撑起来的。它先要讲得清楚:只读标题能串成一个故事,每页字数装得下,字号就那么几级,强调色只给最关键的那一处。
  217. AI 最容易偷懒的地方恰好是这些看不见的规矩。所以这个 Skill 把它们写成了能数出来的检查,丢字、溢出、字号乱、对比度不够,脚本先过一遍,再让 AI 看图挑刺。
  218. 交出去的永远是原生 PPT。不满意的地方你自己动两下就行,不用求着 AI 重新生成。
  219. ---
  220. ## 致谢
  221. 做这个 Skill 时参考过这些项目和资料,全部只提炼思路、自己改写,没有搬运原文和代码。
  222. - dashi-ppt-skill:给每个版式标注容量的思路
  223. - [open-design](https://github.com/nexu-io/open-design):可检查的排版规则和五维设计评审
  224. - 多个 PPT 设计网站的模板:归纳出 36 条视觉路线,目录与章节联动、装饰母题、投影模式都来自这里
  225. - [Lucide](https://lucide.dev) 图标(ISC License,见 `assets/LICENSE-lucide.txt`)
  226. ---
  227. ## 更新记录
  228. - 2.9.0 支持在公司自己的 PPT 模板(.pptx / .potx)上出稿:母版上的背景、logo、色条、页脚原样保留,配色和字体从模板主题里来,内容只排在母版图形让出来的区域里;红色封面、深色结尾页这类版式自动换一套配得上的颜色;`template_kit.py read` 出一张确认卡([#22](https://github.com/zhouwei713/luobo-ppt/issues/22))
  229. - 2.8.2 `render_lite.py --pages 3,7` 只重画指定的页,其余页的预览图保留,改一页不必整份重画
  230. - 2.8.1 没装 LibreOffice 时风格样张改用近似预览,生成路线挑风格这一步不再中断;样张脚本读子进程输出不再在中文 Windows 上报 GBK 解码错误
  231. - 2.8.0 plan.json 每页可以用 `locked` 锁住手改的版式、图标、插画提示词,重新规划(包括 `--reset`)时照样保留;`plan_deck.py --replan 3,7` 只重排指定的页;内容装不下、自动换了版式时写 `layout_auto` 说明原因;改一页的动画不再触发重排
  232. - 2.7.7 给旧稿子的页补上 `uid` 不再让 plan_deck 判定内容变了,手改过的版式规划照样保留
  233. - 2.7.6 deck.json 每页可以带一个 `uid`,调整页序也不变,给外部工具认页用;QA 不再把它当成该上页面的文字
  234. - 2.7.5 QA 关口更可信:手写的线条不再让 QA 崩溃;QA 崩溃时退出码是 2,pipeline 明说稿子没检查过;报告缺失或过期时 review 写“QA 没跑完”,不再显示错误 0;free 页的 elements 写在 deck.json 里也能用,重新规划时 plan 里手写的 elements 会保留,空的 free 页报 ERROR
  235. - 2.7.4 大数字页的数字很宽时(比如“≤ 0.5 元 / 秒”),两行说明改排到数字下方,不再被挤出页面;QA 遇到页面外的文本框不再中途崩溃,整块在页面外或宽度为负的文字报 ERROR
  236. - 2.7.3 主色是亮黄、珊瑚红这类浅色时:结尾页留在主色上配深色字,标签底用主色,主色块上的小字改深色,淡到看不见的连接线换成深色品牌色,QA 会提醒看不见的连接线
  237. - 2.7.2 品牌主色是橙、黄这类浅色时,文字和大数字按手册的颜色顺序退到下一个读得清的品牌色,结尾页这类深色底改用最深的品牌色
  238. - 2.7.1 品牌稿内页可以照手册用文字页眉,IP 形象按页挑选、按动作匹配内容,不再每页都放
  239. - 2.7.0 按企业 VI 手册做 PPT:从手册拆页、截 logo 和形象,生成品牌套件,颜色只用手册色板,logo 按手册放并留安全空间,支持标题竖条、粗描边加硬投影这类标志性元素,QA 新增品牌检查
  240. - 2.6.3 拿刁钻的经营复盘稿实测后补的:只存在表格格式里的百分号也能读出来,多条折线的末端数字带上单位,一页两三个图表、散点图、表格都能照抄,页面底部的注释不再被当成全篇页脚,注释和来源同时存在时两条都印
  241. - 2.6.2 图表和小字单独核对:原稿图表的数据、单位、坐标轴标题逐项比对,注释和来源连符号一起核对,交付前出一份对照清单;快速模式也照常核对
  242. - 2.6.1 讲解页也有逐条动画(多栏一栏一栏出来,单栏按讲解步骤出来),条目编号跟着条目一起出现
  243. - 2.6.0 翻页效果和逐条出现的动画;没有生图模型时可以搜可商用的公开图库,或用自己的照片配图
  244. - 2.5.0 解析原稿时自动转换公式对象,新增理科讲解版式,SVG 图自动转 PNG,原稿 logo 可原位保留
  245. - 2.4.0 截图版式,不装 LibreOffice 的近似预览,字号阶梯按实际可用字号排版
  246. - 2.3.x 标题字号全篇统一,原稿编号和小标签不再丢失,重跑规划保留手改内容
  247. - 2.3.0 版式容量、行高按真实渲染计算、五维自评、墨水杂志和硬边网格风格
  248. ---
  249. ## License
  250. MIT License. 图标遵循 Lucide 的 ISC License。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.