fwpeng/Claude-ppt-skill:用用户模板生成 PPTX 的 Claude Code Skill
fwpeng/Claude-ppt-skill:用用户模板生成 PPTX 的 Claude Code Skill
fwpeng/Claude-ppt-skill 是一个模板驱动的 Claude Code PPT Skill,用来让 Claude 基于用户自定义 PPT 模板、规则文件和可复用提示词生成可编辑的 PowerPoint 文件。它明确不是通用 PPT 生成器,而是把模板作为视觉设计的唯一事实来源,减少重复提示和风格跑偏。
公开仓库:fwpeng/Claude-ppt-skill。
一分钟看效果
最小试跑先从克隆、安装或目录检查开始,确认能打开入口文件、读取 Skill 规则或启动对应服务。
git clone https://github.com/fwpeng/Claude-ppt-skill.git ~/.claude/skills/Claude-ppt-skill
ls ~/.claude/skills/Claude-ppt-skill/templates/business
cat ~/.claude/skills/Claude-ppt-skill/template_rules/business.md
跑通后重点确认这些产物:
- 基于业务模板的 PPTX 文件
- output/ 目录中的生成结果
- 可复用提示词系统
- 模板规则文件
- 用户自定义模板工作流
自制结构图把项目的最小路径压成一条线:先确认输入,再套用规则或模板,最后检查能交付的文件。
为什么需要这个项目
用 AI 做公司汇报时,最常见的问题不是内容生成,而是模板不一致。每次都要提醒字体、颜色、母版和输出位置,既浪费 token,也容易漏规则。Claude-ppt-skill 把 `CLAUDE.md`、模板规则、系统提示和模板路径固定下来,让 Claude 每次按同一套模板生成。
核心功能
- 基于 `templates/business/PPT_template.pptx` 的模板驱动生成。
- 通过 `template_rules/business.md` 描述模板使用规则。
- 把重复提示沉淀到 `prompts/system.md` 和 `CLAUDE.md`。
- 输出到 `output/`,便于和模板文件分开管理。
- 强调 PPT 模板是视觉设计来源,Claude 不应随意发明新风格。
与传统方案对比
| 维度 | 传统流程 | 自动化流程 |
|---|---|---|
| 核心目标 | 人工做 PPT 与配图 | 用本项目搭建自动化流程 |
| 适用场景 | 一次性汇报、临时排版 | 需要复用模板、生成、预览和修改的演示生产 |
| 输入格式 | 文章、想法、截图分散在不同文件 | 主题、Markdown、模板、脚本或 Agent 指令 |
| 输出形态 | 手工维护的 PPT 文件 | HTML、PPTX、PNG、视频或可继续编辑的项目产物 |
| 模板处理方式 | 靠人记住字体、配色和版式 | 把模板、规则和检查步骤放进仓库或 Skill |
| 检查方式 | 人工翻页找问题 | 命令、预览、目录检查或视觉 QA 逐步确认 |
| 适合人群 | 偶尔做演示的人 | 希望把 PPT 生产流程沉淀成工具的开发者和内容团队 |
工作原理
- Claude 先读取 `CLAUDE.md`。
- 读取选定模板的规则文件。
- 使用 `templates/` 中匹配的 PPTX 模板。
- 生成页面大纲和正文内容。
- 按模板样式填充幻灯片。
- 把最终 PPTX 保存到 `output/`。
仓库结构
下面按公开文件和二次开发时应保留的工程入口整理,实际新增目录应以你的本地改造为准。
Claude-ppt-skill/
├── CLAUDE.md
├── README.md
├── LICENSE
├── prompts/system.md
├── template_rules/business.md
├── templates/business/PPT_template.pptx
├── output/.gitkeep
├── examples/
├── references/
环境要求
- Claude Code。
- PowerPoint、WPS 或 Keynote,用于打开输出 PPTX。
- Git。
- 可选:python-pptx 或其他 PPTX 处理库,用于自动生成和检查。
安装方式
git clone https://github.com/fwpeng/Claude-ppt-skill.git ~/.claude/skills/Claude-ppt-skill
ls ~/.claude/skills/Claude-ppt-skill
ls ~/.claude/skills/Claude-ppt-skill/templates/business
推荐使用流程
- 把业务模板放到 `templates/business/`。
- 把模板使用规则写入 `template_rules/business.md`。
- 让 Claude 按 `CLAUDE.md` 读取项目规则。
- 给出主题、页数和演示目标。
- 生成并保存 PPTX 到 `output/`。
- 打开 PPTX 检查是否保留模板风格。
常用命令
git clone https://github.com/fwpeng/Claude-ppt-skill.git ~/.claude/skills/Claude-ppt-skill
cat ~/.claude/skills/Claude-ppt-skill/CLAUDE.md
cat ~/.claude/skills/Claude-ppt-skill/template_rules/business.md
ls ~/.claude/skills/Claude-ppt-skill/output
fwpeng/Claude-ppt-skill 最适合已经有固定 PPT 模板的人。它把模板、规则和提示词固定成 Skill,让 Claude 少猜设计、多按规范填内容,适合业务汇报、客户提案和内部模板化产出。