萝卜PPT.skill

萝卜PPT.skill（luobo-ppt）是用于AI Agent的PPT生成与美化技能。输入文章、口播稿、大纲，或是一份朴素PPT+风格参考图，可直接产出原生可编辑pptx文件。项目遵循开放SKILL.md标准，适配Claude Code、Cursor、Gemini CLI等支持技能机制的Agent。

核心能力

• 从零生成PPT：输入主题、文章、口播稿、大纲，自动生成结论式标题、每页口播备注，完成排版配图。
• 风格换装美化：传入旧PPT与参考风格图，原文一字不改，迁移到统一配色、版式、图标插画；完整保留原稿公式、编号、来源注释。
• 内置校验规则：在交付前自动检查，规避AI生成PPT的一系列常见缺陷。

解决AI PPT的典型痛点

1. 输出整张图片型PPT，文字不可编辑；
2. 可编辑PPT千篇一律模板风；
3. 内容放不下就缩小字号，投影看不清；
4. 美化过程擅自修改原文，丢失内容；
5. 标题空洞，无法串联完整叙事；
6. 字号混乱、强调色滥用；
7. 公式、注释、引用信息丢失。

适用场景

口播视频配套PPT、公众号讲解文稿；工作汇报/方案课件风格换装；理科教学课件（公式多）；AI工具教程（大量截图标注）；数据复盘、竞品分析（原生表格图表）；会议室投影场景（强制字号下限）。

安装方法

仓库根目录即为Skill本体，首次运行自动检测环境，补齐Python依赖包，四种安装途径：

1. Agent自动安装：在支持命令执行的Agent中直接下发指令安装仓库地址，Agent自动克隆至技能目录，新建会话即可使用。
2. Git手动克隆：克隆到对应Agent的skills目录，适配Claude Code、Cursor、Gemini CLI等；Vercel Skills可一行命令 npx skills add zhouwei713/luobo-ppt。
3. 一键安装脚本：Linux/macOS运行bash install.sh，Windows使用install.bat / PowerShell脚本；可批量给本机多个Agent安装，自动补依赖并生成测试样例。
4. Claude应用上传：下载仓库ZIP包，在Claude应用技能设置上传压缩包。

更新方式：进入技能目录执行git pull拉取最新代码。

依赖要求

• 必备：Python3.8+，python-pptx、Pillow、numpy、lxml；
• 推荐：LibreOffice（预览效果更准确），pdftoppm/PyMuPDF；
• 可选：配置生图模型，用于PPT内插图生成。
  执行python3 scripts/setup_check.py --install自动检测并安装缺失依赖。

使用示例指令

• 把这篇文章做成12页口播PPT，每页带口播备注，墨水杂志风格。
• 帮我美化这份PPT，照着这张参考图的风格来，文字一个字都别改。
• 这份数学课件美化，所有公式完整保留。
• 工具教程PPT，截图使用截图版式，在截图上标注操作点。
• 主题“AI工具号年度复盘”，先生成3张风格样张，选定后继续制作。
• 会议室投影使用，启用投影模式，放大字号。
• 增加快速模式，跳过中间确认环节。

要点小结

1. luobo-ppt是SKILL标准PPT Agent技能，输出原生pptx，非图片幻灯片。
2. 两大核心模式：文稿从零生成PPT；旧PPT按参考图风格换装，原文不变，保留公式、注释、截图。
3. 适配多款主流Agent，四种安装方案，自带环境自检脚本。
4. 内置排版校验规则，针对性解决AI PPT文字不可编辑、乱改原文、字号失控等常见问题。