Aham PPT 使用说明

1. 它解决什么问题

咨询级 AI PPT 制作：把原始素材（文字、数据、图表、PDF）按麦肯锡/德勤标准走完八阶段流水线，产出 Aham UI v6.1 风格的 native PPTX——文字可编辑、形状可独立选中，不是截图贴图。

与「一句话出几页图」不同，本 Skill 强调：

• 受众与论点先行 — 先定义「谁在看、看完做什么决定」，再写页
• Ghost Deck 骨架 — 每页一句话结论（Action Title），标题序列能还原完整论证
• 样稿确认门禁 — 3–5 页样稿对齐视觉后再全量出稿
• 能力自适应教练 — 专家/引导/教练三档，引导用户表达判断而非替用户拍板
• 质检交付 — 三级关卡 + 视觉合规清单 + QC 报告

设计哲学：白底 · 蓝是点缀 · 留白 · 内容优先。蓝 #336EE8 仅用于 logo、主操作、推荐标、单个高亮点——绝不铺底。

> Aham 是虚构的示例品牌。 可直接生成 Aham 风格 PPT，也可按本文 §8 替换 references/brand-spec/ 为自有品牌（推荐）。

2. 30 秒安装

git clone https://github.com/li599198347-svg/aham-ppt.git

复制到 Agent 技能目录：

验证目录含：

• SKILL.md — 技能入口与触发词
• assets/svg_to_pptx/ — SVG → PPTX 工具链
• references/phase-01.md ~ phase-08.md — 八阶段详细指引
• references/brand-spec/ — 品牌视觉规范（可替换）

依赖： Python 3（运行 assets/svg_to_pptx_wrapper.py）；Claude Code 等支持 Agent Skill 与文件读写的客户端。

3. 使用流程（八阶段）

Skill 被触发后，Agent 按 references/phase-01.md ~ phase-08.md 逐步推进。每阶段结束会输出「完成卡」，需你确认后才进入下一阶段。

交付模式（deck_mode）：

输出格式： 未指定时默认 both — SVG 预览版 + 可编辑 PPTX 同时交付。

4. 执行前准备

向 Agent 提供：

无素材时 Skill 会提醒质量下降，但仍可基于你的口述启动（教练模式会多问引导题）。

5. 触发方式与 Prompt 示例

触发关键词

• 「帮我做 PPT」「做演示文稿」「做一个汇报」
• 「根据这份资料做 PPT」「做客户方案 PPT」「制作幻灯片」

即使只有一句话也会触发；Skill 会在 Phase 1 补问受众与目标。

Prompt 示例

客户方案（推荐完整八阶段）：

根据附件客户调研 PDF，做一份 20 页方案 PPT，受众是客户 CEO，咨询风格；
先完成 Ghost Deck 和 3 页样稿确认，再全量出稿并跑质检。

管理层汇报：

帮我把这份季度经营数据做成管理层汇报 PPT，约 12 页；
KPI 看板 + 实施路线版式，hybrid 模式，输出可编辑 PPTX。

专家模式（已有清晰判断）：

用 aham-ppt：主题「零售会员运营平台升级」，15 页 solution deck；
灵魂句是「建议 Q3 启动试点，ROI 18 个月内回本」；直接来，少问引导题。

样稿先行：

先做 Ghost Deck + 5 页样稿（封面、KPI 看板、2×2 矩阵、实施路线、结尾），
确认视觉后再继续剩余页面。

换品牌后首次使用：

我已替换 brand-spec 为自有品牌，请按新规范做 10 页产品发布 PPT，
受众是投资人，reading 模式。

6. 能力自适应教练（三档模式）

Phase 1 末尾通过三道题判定档位，后续各 Phase 入口可降档（只降不升）：

AI 绝不替用户决定： 灵魂句、受众、推荐立场、数据真实性、风险承受度。你说「你来定」时，Agent 会分析正反两面，但结论需你确认。

觉得引导太多时，随时说 「直接来」 切换为专家式推进。

7. 版式库速查

7 大版式系 + 特殊页，详见 references/layout-library.md：

视觉节奏约束（Phase 5）： 连续 3 页不能同系；10 页窗口内至少 5 种系别；每 10 页至少 1 页 I 系；每 8–10 页至少 1 页 T 系。

样张预览：aham-ppt-v6.1-demo.pptx（11 页，含 KPI 看板、2×2 矩阵、架构图、深色过渡等）

8. 换成自有品牌（4 步）

Step 1：品牌元信息

编辑 references/brand-spec/brand.md 开头 Brand 块：品牌名、语言环境、调性、属性关键词。

Step 2：强调色

编辑 references/brand-spec/tokens.css：

--accent:       #你的主色;   /* 唯一色相 · 仅点缀 */
--accent-hover: #略浅色;
--accent-press: #略深色;

强调色只用于 logo / 主操作 / 推荐标 / 单个高亮数据点，绝不铺底。三层灰 #FFFFFF / #F3F3F3 / #E7E7E7 与四级墨 #262626~#C4C4C4 建议沿用默认。

Step 3：字体栈（可选）

--ff-sans: "Inter", "Microsoft YaHei", "PingFang SC", ...;  /* 正文/标题 · 无衬线 */
--ff-mono: "JetBrains Mono", "Consolas", ...;               /* 数字 · 等宽 */

不要引入衬线字体做正文。

Step 4：全局替换品牌名

cd aham-ppt/
grep -rn "Aham\|aham" .

9. 设计规范摘要

四个支柱

1. 清晰优先 — 留白与字号建立秩序，先加间距再考虑加线
2. 层次靠层差 — 三层背景灰度层差，卡片无边框无阴影
3. 蓝是点缀 — #336EE8 只点缀；「蓝若第一眼注意到就超标」
4. 单一无衬线 — Inter + 雅黑/黑体；数字一律 mono；状态用 6px 点 + 文字

Action Title 规则

• 每页完整结论句，无衬线 bold #262626
• 无蓝竖线、无话题式标题（如「市场分析」→ 应为「华东份额已连续两季度下滑」）

绝对禁用

渐变 · 3D · 投影（浮层除外）· 纯黑 #000 · 衬线正文 · 第二装饰色 · 蓝铺底 / 整行整列铺色 · 红黄绿灯 · 饼图 · 表格竖线 · emoji · 圆角滥用

禁用词（文案）

赋能 · 颠覆 · 生态 · 闭环 · 最佳实践 · 全链路 · 一站式 · 显著 · 大幅

数字格式

• 货币：¥1,200,000
• 百分比：37.5%
• 日期：YYYY-MM-DD
• 数字一律等宽 mono

10. 工具链与质检

SVG → PPTX

# 对外入口
python assets/svg_to_pptx_wrapper.py ...

# 一键生成样张（参考实现）
python examples/build_examples.py

转换前 Agent 会生成 preview.html，在浏览器逐页审查后再转 PPTX。

三级关卡（自动，不阻断转换）

Phase 8 交付检查

• PPTX 文字可编辑、形状可独立选中
• 抽取最复杂 3 页验证图表与表格
• QC 报告汇总 WARNING 与已知问题

详见 references/quality-audit-protocol.md。

11. 平台支持

12. 适合 / 不适合

✅ 适合

• 客户方案、管理层汇报、投资人 Deck
• 多素材（PDF / 数据 / 图表）需结构化叙事
• 需要麦肯锡金字塔 + Ghost Deck 的咨询风格项目
• 要求 原生可编辑 PPTX（非 HTML 截图）

❌ 不适合

• 一句话快速出图、无受众定义的 casual 演示
• 强个人风格演讲（杂志风 / 瑞士风 → 见 Guizang PPT Skill）
• 只需编排 Brief 不需构建页（→ 见 PPT Deck Pro Max）
• 无 Agent 环境、无法安装 Python 工具链

13. 与其他 Skill 的关系

14. 常见问题

Q：Aham 品牌必须保留吗？

不必。按 §8 四步替换 brand-spec 即可。

Q：可以跳过样稿直接全量出稿吗？

可以，但 Phase 6 样稿是为减少返工；页数多或品牌刚换时强烈建议保留。

Q：输出是什么格式？

默认 SVG 预览 + 原生 .pptx。视觉遵循 Aham UI v6.1（白底、蓝点缀、文档式表格）。

Q：和 officeCLI / pptxgenjs 有何不同？

Aham 是完整方法论 + 版式库 + 质检协议 + 专用转换器的一体化 Skill，不是单纯 API 封装。

Q：材料是英文可以吗？

可以；规范支持 Inter 西文 + CJK 字体栈，受众卡与灵魂句可用英文。

15. 目录结构（速查）

aham-ppt/
├── SKILL.md                      # 技能入口
├── ORIGIN.md                     # 来源与脱敏说明
├── LESSONS.md                    # 24 个场景化经验（供人阅读）
├── assets/
│   ├── svg_to_pptx_wrapper.py    # 对外入口
│   └── svg_to_pptx/              # 工具链主体
└── references/
    ├── brand-spec/               # ★ 品牌规范（替换此处）
    ├── phase-01.md ~ phase-08.md # 八阶段指引
    ├── layout-library.md         # 版式库
    ├── layout-impl-*.md          # 各系实现
    ├── svg-skeleton-*.md         # SVG 骨架模板
    ├── coach-engine.md           # 教练机制
    ├── quality-audit-protocol.md # 质检协议
    └── designer-rules.md         # 设计师执行规则

16. 延伸阅读

• 仓库 README.md
• SKILL.md
• ORIGIN.md — 来源与脱敏
• LESSONS.md — 24 个场景经验
• Releases — 版本下载
• Aham 应用矩阵：Aham UI · Aham Survey · Aham Voice · Aham PPT