Alan PPT Skill

📌 署名：本 skill 由 Alan Lee (BitmanAlan) 原创，以 CC BY-SA 4.0 开源。欢迎使用 / fork / 二次开发，但须署名原作者、保留 NOTICE、衍生版同样 CC BY-SA 4.0 开源，不得冒充原创（详见 LICENSE、NOTICE）。

重要：本 skill 覆盖四种顶级视觉身份，按客户场景选用——不是一种风格打天下，也不是随意混搭。每种身份是一套自洽、互不污染的设计系统（咨询风的克制绝不掺玻璃渐变，发布会风的留白绝不塞咨询密度）。生成物里不要写入 "alanppt" 或任何品牌名。

设计身份 · 四选一（决定一切的根原则）

本 skill 不预设风格——先读场景，再选身份。四种身份各对应一类客户需求，详细配方见 references/design-identities.md。

Design Read · 前门（动手前第一步，必做）

借鉴 design-taste 的"先读懂再生成"：任何 deck 开工前，先用一行声明"这份该是什么身份"，避免无脑套默认风。

1. 读信号：客户是谁、汇报场景、行业、有没有 vibe 词（"高级感/科技感/克制/发布会/杂志感"）、参考链接。
2. 输出一行 Design Read：「这份读作：给 <受众> 的 <场景>，用 <身份 A/B/C/D>，密度旋钮 <低/中/高>。」
3. 场景与身份不冲突就直接声明并推进，不要追问；只有真分不清（如"科技公司的董事会汇报"=A 还是 D）才问一个问题。
4. 默认值：没有明显风格信号时 → A 咨询风（最稳、最不会翻车）。

三个旋钮（跨身份的微调，借自 design-taste-frontend）

选定身份后，用三个旋钮微调，而不是另起炉灶：

• 变化度 VARIANCE（1 对称严整 ↔ 10 不对称张力）：A≈3 / B≈7 / C≈8 / D≈7
• 动效 MOTION（1 静态 ↔ 10 电影感）：A≈2 / B≈6 / C≈4 / D≈7
• 密度 DENSITY（1 画廊留白 ↔ 10 驾驶舱密集）：A≈4 / B≈2 / C≈3 / D≈3
• 呼吸优先恒定：无论哪个身份，每页留白 ≥30%、正文不顶边（见核心原则 #11）。

跨身份铁律（四种都适用）

• 结论先行：每页大标题是结论句不是"关于 XX 的分析"。
• 反默认（借 high-end-visual "Absolute Zero"）：避开 LLM 默认审美——AI 紫渐变、居中 hero over dark mesh、三等分卡、Inter+slate 全家桶。
• 字体配身份：A 用无衬线（Inter/苹方）；B 用宽几何 Grotesk（Geist/Plus Jakarta，大字 weight 拉满）；C 用高对比变量衬线（PP Editorial/Source Han Serif）做大标 + 无衬线正文；D 用几何 Grotesk（Geist/Clash Display）。A 出现衬线是错的；C 大标用无衬线是浪费。
• 换眼 QA 必跑（见 #12 + references/visual-qa.md）：四种身份交付前都要渲染+换眼挑刺，重点查呼吸。
• 交付后沉淀：每做完一份真实 deck（尤其翻过车或被 QA 揪出问题的），在 references/field-notes.md 追加一条带日期的踩坑记录（症状/根因/修法/适用身份）。严重的坑上升为配方或检查项——让 skill 像老师傅一样累积里程，同样的坑只踩一次。

⚠️ 身份不混搭：一份 deck 只走一种身份。咨询风（A）继续遵守它原有的全部克制规则——渐变/阴影/玻璃/圆角>4px/衬线 在 A 里依旧是错的；这些只在 B/C/D 对应身份里按配方使用。

三种输出格式（决定走哪条路径）

由"最终落位 + 后续编辑需求"决定走哪条：

选路径快问快答

Alan 偏好（默认值）

• 默认中文。所有口播、文案、caption 都用简体中文，除非用户明确要英文 deck。
• 避免互联网营销腔。"震撼 / 颠覆 / 赋能 / 重新定义"这类词直接砍掉；改用具体动词和数字。
• 文件路径默认放 ~/Desktop/<项目名>/<格式>/：
  • HTML：~/Desktop/<项目名>/deck/index.html，images/ 同级
  • PPTX：~/Desktop/<项目名>/pptx/，含 png_assets/ / page_visual_previews/
  • COVER：~/Desktop/<项目名>/covers/，命名 cover-{平台}-{比例}.jpg（例如 cover-gzh-21x9.jpg）
• 生成前先写一份大纲 markdown（叙事弧：结论 → 论据 → 拆解 → 路径 → 收束），保存为 项目记录.md 或 大纲-v1.md，便于后续迭代。
• 三种格式不混用。一份 deck 只走一条；如果客户既要网页版又要 pptx，分别做两份。封面（COVER）可以和任意 deck 配套生成，但不要直接截 deck 的某一页当封面——必须按 cover-specs.md 重新构图。

HTML 路径 · 工作流（网页 deck）

Step 1 · 需求澄清

如果用户已经给了完整大纲 + 图片要求，可以跳过直接进 Step 2。

如果用户只给了主题或模糊想法，用下面 6 个问题逐项对齐：

Step 2 · 拷贝模板

先按 Design Read 选定的身份，拷对应模板（四选一）：

mkdir -p "项目/XXX/deck/images"
# A 咨询风（默认）
cp "<SKILL_ROOT>/assets/template-consulting.html" "项目/XXX/deck/index.html"
# B Keynote 发布会风
cp "<SKILL_ROOT>/assets/template-keynote.html"    "项目/XXX/deck/index.html"
# C Editorial 杂志风
cp "<SKILL_ROOT>/assets/template-editorial.html"  "项目/XXX/deck/index.html"
# D Dark-tech 玻璃风
cp "<SKILL_ROOT>/assets/template-darktech.html"   "项目/XXX/deck/index.html"

四个模板都是完整可运行的——CSS、字体、翻页 JS、ESC 索引、动效全已预设好，共用同一套翻页/键盘骨架，只是视觉系统不同。每个模板顶部注释写明它的身份与配方（详见 references/design-identities.md）。

2.1 · 必改占位符（容易漏）

每次拷贝完第一件事：grep 一下"[替换" 和 "[必填"确认全部替换完。

Step 3 · 填充内容

3.0 · 预检：类名必须在模板里有定义

写 slide 前先 Read assets/template-consulting.html 的 <style> 块，确认你要用的每个 class 都在。layouts-consulting.md 顶部有 Pre-flight 类名清单，对照着检查。

3.0.5 · 规划主题节奏

在挑布局之前，必须先列出每一页的 light / dark：

• 7 页以下：1 个 dark hero 即可
• 8-15 页：≥ 1 个 dark hero + ≥ 1 个 dark 章节幕封
• 15+ 页：每 4-5 页插入 1 个 dark 页换气
• 连续 3 页以上同 light/dark = 视觉疲劳，不允许

3.1 · 挑布局

打开 references/layouts-consulting.md，里面有 10 种现成 layout 骨架：

选对应 layout，粘过去，改文案。务必先完成 3.0 预检。

3.2 · 图片处理

如果 deck 里要插图，图片放 项目/XXX/deck/images/，命名 {页号}-{语义}.{ext}（如 03-matrix.png）。

• 单张 ≥ 1600px 宽
• JPG 用于照片 / 截图，PNG 用于透明 UI
• 总大小 ≤ 10MB
• 绝对禁用 stock photo（商务握手 / 团队会议）

Step 4 · 对照检查清单自检

按下面 5 项过一遍：

1. ✅ 结论先行：每页大标题都是结论，不是"XX 分析"这种描述
2. ✅ 配色克制：红色 ≤ 3 次；没有渐变 / 阴影 / 圆角 > 4px
3. ✅ 字体只用无衬线：grep serif 应该为空
4. ✅ 节奏合理：light / dark 交替，没有连续 3 页同主题
5. ✅ 底部不压 nav：内容收尾 ≤ 93vh，nav 在 ~97vh
6. ✅ 呼吸充足：每页负空间 ≥ 30%，正文不顶版边，卡片间距宽松统一；宁可拆页不挤满

Step 5 · 本地预览

open "项目/XXX/deck/index.html"

不需要本地服务器。键盘 ← → 翻页 / ESC 索引 / B 低功耗 / F 全屏 / 1-9 直跳。

Step 5.5 · 换眼视觉 QA（必跑，不可跳过）

自查（Step 4）是同一个 agent 看自己，有预期盲区，发现不了"挤"。交付前必须按 references/visual-qa.md 跑一遍：渲染每页成图 → 派一个全新子agent用挑刺视角找问题（重点查呼吸/留白：疏密不均、贴边、顶到页脚、负空间不足）→ 修 → 重验。没跑完至少一轮"修复+重验"，不算完成。

Step 6 · 迭代

90% 的调整是改 inline style（字号 font-size:Xvw / 高度 height:Yvh / 间距 gap:Zvh）。

PPTX 路径 · 工作流（可编辑 pptx）

入口文档：references/mckinsey-pptx.md（走 PPTX 前必读）

简要流程：

1. 生成 16:9 整页视觉：用 GPT-Image-2 / Nano Banana / Imagen，按 assets/mckinsey-pptx/image2-prompt-template.md 的 Shared Visual System + 单页 Prompt 模板生成
2. 拆分透明 PNG（可选，标准图表可跳过）：按 assets/mckinsey-pptx/decompose-prompt.md 的 Prompt 把每页拆成透明 PNG 素材
3. 重建可编辑 pptx：把 assets/mckinsey-pptx/ 整个目录拷到项目根，改 make-deck.js 顶部的 PROJECT 常量和 addSlideN 函数，跑 npm install && node make-deck.js
4. 自检：按 references/checklist-mckinsey.md 的 P0/P1/P2/P3 清单逐项核对，在 PowerPoint 里打开验证文字可编辑
5. 换眼视觉 QA（必跑）：按 references/visual-qa.md 把 pptx 渲染成图（soffice→pdf→pdftoppm）→ 派全新子agent挑刺（重点查呼吸/留白、溢出、重叠）→ 修 → 重验，零新问题才交付

与 HTML 路径的差异：

• HTML：纯网页 / 浏览器翻页 / CSS class
• PPTX：.pptx / PowerPoint 翻页 / pptxgenjs SVG+PNG+文本框

视觉系统完全一致：同样 McKinsey 调色板、同样 Inter 字体（pptx 用 Arial 兼容性更好但视觉等价）、同样结论先行原则。

COVER 路径 · 工作流（多平台封面）

入口文档：references/cover-specs.md（走 COVER 前必读）

COVER 路径不生成 deck，只生成单张封面图。覆盖五种平台尺寸：

工作流：

1. 问清平台：哪个尺寸？要不要一起做多平台（一次最多 4 个）？
2. 抽标题：≤ 12 个中文字符，必须是结论句或强反差
3. 按 cover-specs.md 的 Prompt 模板生成
4. 保存到 ~/Desktop/<项目名>/covers/，命名 cover-{平台}-{比例}.jpg

绝不要直接截 deck 的某一页当封面——deck 横向版式信息密度低，缩到 1:1 或 3:4 会留白过多、字号失衡。封面必须按 cover-specs.md 重新构图。

资源文件导览

alanppt/
├── SKILL.md                  ← 你正在读
├── README.md / README.en.md  ← 速查
├── LICENSE                   ← MIT
├── CONTRIBUTING.md           ← 维护说明
├── assets/
│   ├── template-consulting.html  ← ★ 身份 A · 咨询风模板（10 layout）
│   ├── template-keynote.html     ← ★ 身份 B · Keynote 发布会风模板
│   ├── template-editorial.html   ← ★ 身份 C · Editorial 杂志风模板
│   ├── template-darktech.html    ← ★ 身份 D · Dark-tech 玻璃风模板
│   └── mckinsey-pptx/            ← ★ PPTX 路径 self-contained 工作目录
│       ├── image2-prompt-template.md  ← Image-2 整页视觉 Prompt 模板
│       ├── decompose-prompt.md        ← 拆透明 PNG 的 Prompt
│       ├── rebuild-prompt.md          ← 兜底：让模型直出 pptx 的 Prompt
│       ├── make-deck.js               ← pptxgenjs 脚本（含咨询图表原语库）
│       └── package.json               ← pptxgenjs + sharp 依赖声明
└── references/
    ├── design-identities.md      ← ★ 四种视觉身份配方手册（A/B/C/D 各自宪法，先读）
    ├── layouts-consulting.md     ← ★ 身份 A · 10 种 layout 骨架（可粘贴）
    ├── mckinsey-pptx.md          ← ★ PPTX · 完整工作流主文档
    ├── cover-specs.md            ← ★ COVER · 多平台封面规格 + Prompt 模板
    ├── checklist-mckinsey.md     ← ★ PPTX · 自检清单（P0/P1/P2/P3 + 呼吸 P2-5）
    ├── visual-qa.md              ← ★ 通用 · 渲染+换眼子agent视觉QA回环（HTML/PPTX 交付前必跑）
    └── field-notes.md            ← ★ 实战踩坑日志（每做完真实 deck 追加一条，累积里程）

加载顺序建议：

1. 先读完 SKILL.md（这个文件）了解整体
2. Step 1 需求澄清第一问：先确定产出形式（HTML / PPTX / COVER）
3. 走 HTML 时：读 layouts-consulting.md（顶部有 Pre-flight 类名清单），动手前先 Read assets/template-consulting.html 的 <style> 块
4. 走 PPTX 时：读 mckinsey-pptx.md，按需读 assets/mckinsey-pptx/ 里的对应 prompt 模板 / 脚本，交付前过 checklist-mckinsey.md
5. 走 COVER 时：直接读 cover-specs.md → 按 Prompt 模板生成

核心设计原则（哲学）· 身份 A 咨询风专属

下列 10 条是身份 A（咨询风）的宪法——无衬线/直角/单一红 accent/hairline 等只对 A 成立。B/C/D 各有自己的配方（见 references/design-identities.md），不要把 A 的克制规则套到 B/C/D，也不要把 B/C/D 的玻璃渐变带进 A。跨四身份恒定的只有：结论先行 · 呼吸优先(#11) · 换眼 QA(#12) · 反默认审美。 对 A 而言：违反其中任何一条，画面瞬间从咨询风掉到 PowerPoint。

1. 单一锚点色 — 一份 deck 只用一个 accent（红色），不允许多色高亮拼贴
2. 极致字号对比 — 主标题（48px）与正文（16px）比例 ≥ 3:1；KPI 大数字（72px）与 label（24px）比例 3:1
3. 无衬线只此一家 — Inter / Helvetica / 苹方；任何衬线都是错的
4. 直角纯色 — 不允许渐变 / 阴影 / 圆角 > 4px
5. 网格至上 — 所有元素吸附到 12-col grid，左对齐；留白是设计元素不是浪费：页边距 ≥ 画布 6%，相邻区块间距取"宽松档"且全 deck 统一，文本块宽度 ≤ 62 字符（中文 ≤ 34 字），不要让正文顶到边
6. Hairline 是手术刀 — 1px 的极细分割线就够，不要加粗、不要加阴影
7. 结论先行 — 每页大标题都是结论，副标补论据，不要写"关于 XX 的分析"
8. 红色克制 — 红色一份 deck ≤ 3 次，每次都对应"最该看的那一项"
9. 配图不用 stock — 真实素材或自己生成，stock photo 一秒掉档次
10. 入场动效极简 — opacity + 微 translateY + 数字 scaleIn；不用流体 / 视差 / sequence
11. 呼吸优先于密度 — 宁可一页少讲一点、多拆一页，也不把版面填满；每页保留 ≥30% 负空间；上下内容收在画布纵向 ~10%–90% 之间，给天地留气口。密度是上限，留白是默认
12. 换眼验证再交付 — 自己写的版面有"预期盲区"，看不出自己挤了。交付前必须渲染成图、派一个全新子agent用挑刺视角找问题（见 references/visual-qa.md），修完重验，零新问题才算完成