中文
一个 Claude 技能（Skill）：把一个文件夹里的需求说明 + 资料 + 你自己的模板，一键变成可二次编辑的 PowerPoint。你只管丢资料、写一句需求，剩下的（搭大纲、套模板、按需联网、出片）交给它。
- 按你的模板生成 PPT：用你自己的
.pptx作底稿，保留母版、主题色和字体，产物是原生可编辑的 PowerPoint 对象，不是图片。 - 需求文件驱动：你在文件夹里写一个简单的需求说明，它据此自动生成幻灯片大纲（
content.md），你不用手写大纲。 - 8 种制作角色（风格）：在需求文件里指定角色，输出风格随之改变——
简约、商务、汇报者、咨询顾问、创意、数据派、路演者、教学者。 - 联网搜索：需求里要"补充最新数据"时，自动用 Claude Code 内置的 WebSearch / WebFetch 联网取证（Bedrock/Vertex 网关下可用搜索类 MCP 兜底），并把来源标注到讲者备注里。
- 一键调用：在 Claude Code 里输入
/gppt即可触发，也会在你自然描述需求时被自动识别。 - 可反复迭代：改需求文件或
content.md再跑一次，即可重塑整份 PPT。
gppt/
├── SKILL.md # 技能主文件（Claude 据此工作）
├── README.md # 本说明（中文）
├── LICENSE # MIT 协议
├── references/
│ ├── brief-guide.md # 需求文件能写哪些内容、如何解读
│ ├── roles.md # 8 种制作角色的定义
│ ├── research.md # 联网搜索方案
│ └── content-md-format.md # content.md 大纲格式规范
└── scripts/
└── scan_folder.py # 扫描文件夹、自动分类资料
Claude Code 通过读取 ~/.claude/skills/<名字>/SKILL.md 来发现技能。关键：放进去的必须是解压后的文件夹，而不是 .skill 压缩包。
用 git 安装（最简单）：
git clone https://github.com/gaiwanniao/gppt.git ~/.claude/skills/gppt或手动放置：把本仓库内容复制到 ~/.claude/skills/gppt/，确保存在 ~/.claude/skills/gppt/SKILL.md。
如果你手上是 gppt.skill 压缩包（它本质是 zip）：
cd ~/.claude/skills
unzip -o gppt.skill -d . # 解压后得到 gppt/SKILL.md验证：
ls ~/.claude/skills/gppt/SKILL.md # 能列出就成功了回到 Claude Code，输入 /gp，应能看到 /gppt。若没出现，退出重进 claude 一次再试。
想给整个团队共享，也可以放到某个项目的
<项目>/.claude/skills/gppt/下并提交到仓库。
网页端是「上传安装」，要的是 .skill 压缩包：
- 从本仓库的 Releases 下载
gppt.skill（或git clone后用下方命令自行打包）。 - 打开 Claude → Settings → Capabilities / Skills → 上传
gppt.skill。
自行打包命令（在仓库上一级目录执行）：把
gppt整个文件夹压缩成 zip，并改名为gppt.skill即可。
技能本身装好后，你每次只需要准备「一个文件夹 + 里面的输入材料」：
| 准备什么 | 必需? | 作用 | 命名 / 格式提示 |
|---|---|---|---|
需求文件（如 需求.md） |
强烈建议 | 指挥棒：写清你要什么——受众、页数、重点、跳过什么、角色、用哪个模板、要不要联网 | 文件名含「需求 / 要求 / 说明 / 大纲 / brief / requirements」，.md 或 .txt |
| 内容素材 | 需要 | 实际正文来源 | .docx / .pdf / .md / .txt |
| 模板 | 可选 | 品牌底稿，保留母版 / 配色 / 字体 | 一个 .pptx，名字含「template / 模板 / brand / 母版」会被优先识别；不放则按角色从零设计 |
| 图表数据 | 可选 | 会被画成可编辑图表 | .csv / .xlsx |
| 图片 | 可选 | 配图、Logo | png / jpg 等 |
最低限度：只要有一个需求文件（或一份内容素材）就能跑；模板、数据、图片都可以没有。
典型文件夹长这样：
my-deck/
├── 需求.md ← 你写的要求（含角色、模板名、是否联网）
├── 业务说明.docx ← 正文素材
├── 季度数据.xlsx ← 可选，做图表
├── hero.png ← 可选，配图
└── brand.pptx ← 可选，你的模板
需求文件里可以写：受众、目标、页数、重点、要跳过什么、顺序、语气、角色、是否联网、用哪个模板。示例：
给管理层的季度复盘，8 页，角色：汇报者，模板用 brand.pptx，
重点讲增长来源和下半年预算建议，方法论部分跳过，
补充一下行业最新增速数据，结尾要一页明确的预算请求。
- Claude Code：输入
/gppt，并告诉它文件夹路径（例如"用 ~/Desktop/testppt 文件夹做 PPT"）。 - 或自然描述："按这个文件夹里的需求和模板生成 PPT"。
它会按这个流程跑：扫描文件夹 → 读需求和资料 → 定角色 → 按需联网补料 → 生成 content.md 大纲（给你确认）→ 套你的模板渲染 → 自检 → 交付可编辑的 .pptx。
| 角色 | 风格关键词 |
|---|---|
简约 |
大量留白、一页一观点、克制配色 |
商务 |
专业均衡（默认） |
汇报者 |
结论先行，每页回答"so what" |
咨询顾问 |
行动式标题、MECE / 金字塔结构 |
创意 |
大胆编辑风、强视觉冲击 |
数据派 |
图表主导、标注来源与单位 |
路演者 |
问题→方案→进展→诉求的叙事 |
教学者 |
循序渐进、友好、配示例 |
模板与角色同时存在时：模板定品牌（色/字/母版），角色定版式、密度、标题风格与视觉母题。
- 主方案：Claude Code 内置
WebSearch+WebFetch，无需额外配置。若被要求授权，或加入~/.claude/settings.json：{ "permissions": { "allow": ["WebSearch", "WebFetch"] } } - 兜底方案：走 Bedrock / Vertex 网关时内置 WebSearch 不可用，可接入搜索类 MCP（如 Brave Search、Exa），并把
WebSearch加入disabledBuiltinTools。 - 查到的事实会在大纲里标注来源；查不到不会编造。
输入 /gppt 搜不到？
多半是把 gppt.skill 压缩包直接丢进了 ~/.claude/skills/gppt/。Claude Code 需要的是解压后的 SKILL.md。按"方式 A"重新解压，确保 ~/.claude/skills/gppt/SKILL.md 存在，再退出重进 claude。
没有模板可以用吗？ 可以。不放模板时，它会按所选角色的配色和字体从零设计一套。
生成的 PPT 能改吗？ 能。全部是原生 PowerPoint 对象（文字、形状、图表），可在 PowerPoint / WPS / Keynote 里直接编辑。
MIT 协议，见 LICENSE。本技能依赖 Claude 自带的 pptx、file-reading 等能力完成渲染。