PPT Deck Pro Max 使用说明

1. 它解决什么问题

多数 AI PPT 工具是「一句话出几页图」。PPT Deck Pro Max 把 Deck 生产当作有门禁的视觉传播系统：

• 进入页面构建前，先把商业叙事和内容密度讲对
• 每页有视觉主角（图表、图标链、概念 UI），而非纯文本框
• Expert Mode 通过结构化访谈补真实案例与数据
• 25+ QA 维度，失败时结构化回滚到正确上游阶段

> 它不是构建引擎，而是编排层；最终 HTML/PPTX 需交给构建型 Skill 完成。

2. 三层 AI Deck 生产

推荐串联：Library 找可复用页 → Deck Pro Max 规划叙事与缺口 → 构建 Skill 出页。

3. 环境要求

python3 -m pip install -r requirements.txt
# 测试：python3 -m pip install -r requirements-dev.txt

• Python 3.10+
• python-pptx、Pillow、jsonschema
• 可选：playwright（URL 截图、视觉 QA）

安装后健康检查：

python3 scripts/run_deck_pipeline.py doctor
python3 scripts/run_deck_pipeline.py doctor --project-dir ./my-deck

4. 安装 Agent Skill

仓库根目录含 SKILL.md，复制到 Agent skills 目录或在会话中引用：

# 示例：Cursor 项目级
cp SKILL.md references/ scripts/ assets/ -r .cursor/skills/ppt-deck-pro-max/
# 或直接 clone 后在 Prompt 中 @ 仓库路径

5. 快速开始

5.1 初始化项目（Expert 模式，12 页方案 Deck）

python3 scripts/run_deck_pipeline.py init \
  --project-dir ./my-deck \
  --pages 12 \
  --preset solution_deck \
  --production-mode expert

5.2 Quick 模式（小 Deck、低风险）

python3 scripts/run_deck_pipeline.py init \
  --project-dir ./quick-deck \
  --pages 6 \
  --preset product_intro \
  --production-mode quick

5.3 投标 / 标书（formal_bid_image_led）

python3 scripts/run_deck_pipeline.py init \
  --project-dir ./formal-bid-deck \
  --pages 60 \
  --production-mode expert \
  --production-sub-mode formal_bid_image_led

6. 强制工作流（8 步 + 门禁）

Step 0   任务分类
Step 1   锁定 Brief                    → deck_brief.md          🔔 用户确认
Step 1.2 源材料摘要
Step 1.3 容量规划
Step 1.4 缺口门禁
Step 1.5 Expert 访谈（expert 模式）   → interview_preparation.json
Step 1.6 脱敏审查（expert 模式）       → deck_expert_context.md 🔔 用户确认
Step 2   锁定 Vibe
Step 3   叙事弧与 Hero 页             → deck_narrative_arc.md  🔔 用户确认
Step 4   版式草稿
Step 5   压缩 + 视觉构图              → deck_visual_composition.md
Step 5.5 资产规划                     🔔 用户确认
Step 6   视觉组件系统
Step 7   构建 Deck（交给 Build Skill）
Step 8   QA 与回滚

带 ★ 的步骤为 Expert Mode 专有；production_mode: quick 可跳过。

7. 常用命令

# Expert 访谈准备
python3 scripts/run_deck_pipeline.py expert-interview --project-dir ./my-deck

# 内容治理校验
python3 scripts/run_deck_pipeline.py validate \
  --project-dir ./my-deck --output-mode pptx+html \
  --expert-mode --content-governance

# 生成视觉构图 spec
python3 scripts/run_deck_pipeline.py visual-composition --project-dir ./my-deck

# 生成 Build AI handoff
python3 scripts/run_deck_pipeline.py handoff \
  --project-dir ./my-deck --role build --page-ids slide_05

# 批量构建 dispatch
python3 scripts/run_deck_pipeline.py dispatch-build \
  --project-dir ./my-deck --batch-id batch_01

# 截图资产（需 Playwright）
python3 scripts/run_deck_pipeline.py capture-assets \
  --project-dir ./my-deck --cookies cookies.json

# QA
python3 scripts/run_deck_pipeline.py qa \
  --project-dir ./my-deck --write-state \
  --require-review --review-findings ./my-deck/deck_review_findings.json

8. 场景预设（Presets）

9. 推荐搭配的构建 Skill

Codex 图片型默认循环：generate-assets → $imagegen → asset-status 审批 → 组装 → QA。

10. Prompt 示例

完整 Expert 方案 Deck

使用 PPT Deck Pro Max：
- 项目目录 ./decks/retail-member-ops
- 12 页 solution_deck，production-mode expert
- 主题：零售企业会员运营平台方案，面向 CIO
- 请先锁定 Brief 与叙事弧，再 expert-interview 补案例与数据
- 通过后生成 visual-composition，并 handoff 给 frontend-slides 构建 HTML

Quick 小 Deck

用 PPT Deck Pro Max quick 模式：6 页 product_intro，
介绍我们的 AI 客服产品，跳过专家访谈，直接到 visual-composition 与 build handoff。

与 PPT Library 串联

1. 用 ppt-library 搜索「会员架构」可复用页 Top 10；
2. 用 PPT Deck Pro Max 规划 15 页新方案叙事，标注哪些页复用 Library、哪些页需新建；
3. 缺口页交给 imagegen + frontend-design 构建。

11. 模式对比

12. 延伸阅读

• 仓库 README.zh-CN.md
• SKILL.md（主指令）
• docs/ai_worker_execution.md（多 Agent 执行）
• examples/solution_deck_minimal/run_smoke.sh（最小 smoke）