Stats
Actions
Tags
From dizhu-skills
Build high-quality presentation decks from scratch. Covers the full lifecycle from brainstorming through content writing, visual design, AI image generation, iterative QA, and final delivery. Uses OpenRouter + Nano Banana Pro for slide image generation. No external SaaS dependency.
How this skill is triggered — by the user, by Claude, or both
Slash command
/dizhu-skills:ppt-builderThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
从一句话需求到高品质演示 PPT 的完整方法论。覆盖内容策划、文案撰写、视觉设计、AI 生图、QA 迭代、交付全流程。
从一句话需求到高品质演示 PPT 的完整方法论。覆盖内容策划、文案撰写、视觉设计、AI 生图、QA 迭代、交付全流程。
内容和形式分离。分三步走，每步独立交付、独立审批：
| Step | 产出 | 关注什么 | 不关注什么 |
|---|---|---|---|
| 1. 内容文档 | content.md | 说什么、论证逻辑、数据 | 颜色、字体、版式 |
| 2. 设计文档 | design.md | 视觉风格、模板、每页版式 | 文案本身 |
| 3. PPT 生成 | deck.pptx | 按 Step 1 + 2 落地成品 | 回头改文案或改结构 |
下游不反向改上游。如果 Step 3 生成时发现某页内容装不下，回 Step 1 改内容，不在 Step 3 里"压一压"。
阶段 1 Brainstorming → 收敛决策，形成定位 阶段 2 Spec 文档 → 大纲 + 多轮自审 → 批准 阶段 3 内容文档 → 每页文案 阶段 4 设计文档 → 视觉系统 + 模板 + 每页指令 阶段 5 PPT 生成 → Nano Banana 逐页生图 + 组装 阶段 6 QA 迭代 → 只修有问题的页 阶段 7 交付 → pptx + pdf
目标：把模糊的需求收敛为一份明确的决策清单。
推荐 Skill：如果已安装
idea-to-design（头脑风暴 · 从想法到设计），可以先调用它完成通用的 brainstorming 流程（探索上下文 → 逐一提问 → 提出方案 → 呈现设计 → Spec 自审）。本阶段的 PPT 专属决策项作为 brainstorming 的具体问题输入。
每次只问一个问题，给 3-5 个选项，标注你的推荐。等用户回答后再问下一个。不要一次性抛多个问题。
| 决策项 | 为什么重要 | 典型选项 |
|---|---|---|
| 类型 | 通用可复用 / 针对特定客户 / 内部用 | 决定复用性和信息密度 |
| 受众 | 老板 / 中层管理 / 技术人 / 投资人 / 终端用户 | 决定语言、深度、卖点 |
| 使用场景 | 现场讲 / 发给客户自己看 / 双用 | 双用 = 每页必须自解释 |
| 时长和页数 | 15 页精简 / 25 页标准 / 35+ 页深度 | 页数服务于内容，不硬限 |
| 叙事骨架 | 问题驱动 / 场景驱动 / 模块驱动 / 混合 | 决定全 deck 的节奏 |
| 主线故事（可选） | 用一个具体场景串联整份 deck | 有故事的 deck 代入感强 |
| 视觉风格 | 有参考 PDF / 跟产品视觉统一 / 用形容词描述 | 有参考最好，减少猜测 |
| 数据和案例 | 有真实数据 / 用占位符 / 都没有 | 决定可信度策略 |
| 商业信息 | 明码标价 / 给定位信号 / 不提价格 | 老板关心"我付不付得起" |
目标：写一份全局定位 + 每页大纲 + 视觉方向的 spec 文档。
| # | 页面 | 核心论点 | 必备内容 |
Spec 写完后必须至少做两轮自审，不审不进下一步。
第一轮：受众视角审
站在目标受众的角度读一遍大纲，问自己：
详细检查清单见 references/spec-review-checklist.md
第二轮：文案质量审
grep 扫描禁用词（见 references/writing-principles.md），确保零正文命中。
直接改。改完不需要重新审——修了就过。但严重问题（如结构性缺失）需要标注版本号（v1 → v2）并记录变更原因。
目标：写 content.md，覆盖每一页的完整文案。
| 页面类型 | 粒度 | 原因 |
|---|---|---|
| 核心页（主线故事 / 核心宣言 / 关键转折） | 终稿级文案 | 这些页决定 deck 成败 |
| 其他页（模块展开 / 落地 / 附录） | 结构化要点 | Step 3 生成时根据版式微调 |
核心论点：[一句话，这页要让读者记住什么] 详细文案：[终稿文字 或 3-5 个 bullet 要点] 图片意图：[需要什么视觉素材——只讲意图不讲样式] 关键数据（可选）：[数字和引用来源，占位用 [待补]]
[待补]，别编[待补]，不用 TBD / TODO详细写作原则见 references/writing-principles.md
目标：写 design.md，定义视觉系统和每页的具体版式。
色彩（hex 值 + 用途）/ 字体（字号层级）/ 背景 / 标志性元素 / 间距
每种模板：用途 / Wireframe / 元素清单 / 尺寸 / 变体 / 禁止事项
每页：模板 / 文案来源 / 图像清单 / 版式要点
概念插画（需要 AI 生成的）/ 示意图（脚本生成的）/ 图标
投影仪 / 打印 / 移动端 的适配规则
模板：[模板名或变体]
文案来源：content.md Slide N
图像清单：
目标：用 Nano Banana Pro 逐页生成幻灯片图片，组装成 pptx。
Skill 自带 scripts/generate_deck.py，直接可用：
# 1. 复制 slides.example.json 为 slides.json，填入你的 prompt
cp scripts/slides.example.json scripts/slides.json
# 2. 生成全部页
python3 scripts/generate_deck.py
# 3. 只生成第 1-5 页
python3 scripts/generate_deck.py --start 1 --end 5
# 4. 重跑某页（删旧图再跑）
rm scripts/output/slide_03.jpg && python3 scripts/generate_deck.py --start 3 --end 3
# 5. 生成完自动组装 PPTX
python3 scripts/generate_deck.py --assemble
slides.json 格式：style（全局风格前缀）+ slides 数组（每页一个 num + prompt）。
见 scripts/slides.example.json 示例。
依赖：pip install python-pptx（仅组装 PPTX 时需要）
每页 prompt = 全局风格前缀 + 页面具体内容。
全局前缀应包含：角色设定（"你是一名顶级 PPT 设计师"）、输出格式（"16:9 比例的幻灯片图片"）、设计风格要求（从 design.md 提取的背景、色彩、字体）、中文渲染强制要求、"只生成一张图片"。
详见 references/prompt-writing-guide.md，核心要点：
已生成的页自动跳过（检查文件是否存在且大于 10KB）。要重跑某页时手动删掉该 JPG 再跑。
使用 python-pptx 创建 16:9 空白演示文稿，逐页将 JPG 以全屏尺寸添加到空白 slide 上，最后保存为 pptx。
目标：审查所有页面，只修有问题的页，不动通过的页。
rm slide_NN.jpg → 修 prompt → 重跑 → 重组装详见 references/qa-fix-patterns.md，涵盖：
生成每页时把上一页的 JPG 作为 visual reference 传入 API。减少页间风格跳跃。
首次全量生成可不用（独立出图速度更快），QA 修复特定页时建议启用。
output/ ├── slide_01.jpg ~ slide_NN.jpg ├── deck-v1.pptx └── deck-v1.pdf (可选)
改 content.md 里的内容 → 只重跑受影响的页 → 重组装。
不需要全量重跑。改一页成本 ¥0.1-0.3 + 30 秒。
| 项目 | 成本 | 时间 |
|---|---|---|
| 阶段 1-4（Brainstorming → 设计文档） | ¥0（纯思考和写作） | 4-10 小时 |
| 阶段 5（Nano Banana 生图 30 页） | ~¥5 | ~15 分钟 |
| 阶段 6（QA 重跑 5 页） | ~¥1 | ~5 分钟 |
| 总计 | ~¥6 | 5-12 小时 |
大部分时间花在内容和设计上（阶段 1-4）。PPT 生成本身只需 15 分钟 + ¥5。
内容质量 > 视觉效果——PPT 的说服力 80% 来自内容，20% 来自视觉。
[待补]npx claudepluginhub dizhu/dizhu-skills --plugin dizhu-skillsCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.