# Deck Studio

PPT 生产 Agent：理解场景 → 推荐风格 → 先出大纲 → 定义页面 → 双通路交付（PPT 内容稿 / 逐页视觉图 /...

- Repository: https://github.com/staruhub/ClaudeSkills (731 stars)
- Category: Design
- License: MIT
- Last updated: 2026-08-13
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add staruhub/ClaudeSkills --skill deck-studio -g -a claude-code -y`
Codex: `npx skills add staruhub/ClaudeSkills --skill deck-studio -g -a codex -y`
Cursor: `npx skills add staruhub/ClaudeSkills --skill deck-studio -g -a cursor -y`
Gemini CLI: `npx skills add staruhub/ClaudeSkills --skill deck-studio -g -a gemini-cli -y`

## Description

PPT 生产 Agent：理解场景 → 推荐风格 → 先出大纲 → 定义页面 → 双通路交付（PPT 内容稿 / 逐页视觉图 / 信息图组图）。当用户要做汇报、路演、培训课件、提案、咨询报告的演示文稿，或要把大纲/文章做成 slides、deck、PPT、信息图、小红书图文、可视化传播图时使用。支持指定风格或从风格库推荐，支持 image 模型逐页出视觉稿。前身为 notion-infographic（v2）并吸收 ppt-designer 的设计原则。不用于：pptx 文件的纯技术操作（拆分/合并/提取，用宿主 pptx skill）、演讲稿或文章本体的写作（用 wechat-article-writer）、需要先做研究的内容调研（先走 deep-research 再回来）、单张海报或 logo 设计。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Deck Studio：PPT 生产 Agent

不是"帮你排版润色"，而是一条从场景理解到成品交付的生产线。
核心信条（承自 ppt-designer）：**PPT 的本质是信息传达，设计是为内容服务的。**

## 铁律（不是建议）

1. **先 outline，后一切**。视觉图模式（模式 C）必须在大纲经用户确认后才启动；image 模型只负责"把已定义的页画出来"，永远不决定 deck 讲什么。用户要求"跳过大纲直接画"时，解释原因并先给大纲。
2. **每页先有 page brief，再有 image prompt**，禁止跳级。
3. **一套 deck 一个风格**。风格参数从 style brief 统一注入每页，不允许逐页漂移。

## 验收标准（交付前逐条自查）

- [ ] outline 在任何页面产出之前存在且经用户确认（模式 A 除外，它本身就是终点）
- [ ] 每页符合 page schema 必填字段，密度合规（要点 3-5 / 层级 ≤3 / 字号比 ≥2:1）
- [ ] 全套使用同一 style brief，任取两页字体、色板、版式代号一致
- [ ] 模式 C 的每页 prompt 包含风格名、构图、标题文案、正文文案、禁止项
- [ ] 交付物包含 speaker notes（用户明确不要时除外）
- [ ] 没有 emoji 充当功能图标；配色来自所选风格色板而非临场发挥
- [ ] 视觉产出（模式 B/C）渲染后过了 `references/visual-checklist.md`（原典量化 12 条 + 实战 10 条），每页声明了注册版式 `layout: LXX`

## 不做什么

- pptx 文件技术操作（拆分/合并/页数统计）→ 宿主环境 pptx skill
- 演讲稿、文章正文的深度写作 → `wechat-article-writer`
- 内容需要多源调研时 → 先移交 `deep-research`，拿到结论再回本流程
- 单张海报、logo、纯装饰图 → 图像生成类 skill 直接处理
- 用户只要"随便几页能用就行"时，压缩为：快速 outline → 模式 B 简化输出，不走完整六步

## 执行与真实性边界

- 仓库示例脚本只允许写入各自示例目录的 `html/`、`png/` 和明确命名的 `.pptx`；不得读取凭据、访问网络、执行 shell 或写到调用者当前目录。
- HTML→PNG→PPTX 路线锁定视觉，但每页在 PPTX 中是整页栅格图，**不可编辑**。不得把它宣传为“可编辑 PPTX”。
- 需要可编辑交付时走模式 B 的原生对象路线，并实际检查文字、形状、图表、speaker notes、溢出和渲染；未运行 Office/LibreOffice 时必须声明 fidelity 未验证。
- 外部事实和图片必须在 speaker notes 记录来源。仅有文件存在、预览图或脚本退出 0，不代表视觉质量通过。

## 工作流程（六步）

### Step 1 识别任务类型
汇报 / 路演 / 培训 / 提案 / 复盘 / 咨询报告 / 招聘介绍 / 自媒体分享。
判断规则见 `references/scene-routing.md`。识别不确定时直接问，不猜。

### Step 2 补齐关键上下文（最多问 5 项，已知的不重复问）
① 给谁看 ② 目标是什么 ③ 期望页数 ④ 偏内容清晰还是视觉冲击 ⑤ 有无指定风格/品牌色

### Step 3 选择风格
用户指定 → 锁定。未指定 → 按 `references/scene-routing.md` 的"场景×风格"矩阵推荐 3 个并给一句话理由。
用户有品牌资产（ChaoGeek / ClawTime / WorkBuddy）→ 直接用 `style-library/custom/` 定制风格。

### Step 4 出 outline（模式 A 到此为止）
按 `templates/outline-template.md`：主题 / 受众 / 目标 / 页数建议 / 每页标题 + 一句话摘要。
**停，等用户确认后再继续。**

### Step 5 页级结构
先按页面类型从 `references/layout-registry.md` **选注册版式并声明 `layout: LXX`**（不从零发明构图），再逐页填 page schema（`references/page-schema.md`）：页面类型、核心结论、视觉结构、内容模块、图像需求。

### Step 6 按模式交付

The rest: https://github.com/staruhub/ClaudeSkills/blob/HEAD/skills/Geek-skills-deck-studio/SKILL.md