Aham PPT 技能 — Aham UI v6.1 · Office 轨 · PPT

依赖（Phase 7 转换前确认）

• 必装 pip 包：python-pptx、cairosvg（见 requirements.txt；缺失时 Phase 7 转换第一步即 ImportError）。
• 可选：LibreOffice（soffice CLI）——用于 PDF 导出与渲染抽检；缺失时交付物不含 PDF，在交付说明中注明原因即可，不阻塞 PPTX 交付。
• 字体现实：规范字体 Inter / JetBrains Mono 若未安装，PPTX 打开时由系统回退（Windows 常见 Calibri/微软雅黑/Consolas），不影响可编辑性；需精确度量请安装 Inter。

当前能力概览（演进史统一见 CHANGELOG.md，正文不再按版本叙事）： 八阶段强制流程（防跳步 + 卡点等待）× 能力自适应教练机制 × A/B/C 三档视觉主题（含深色模板）。 版式库 39 个 ID（6 系 36 个内容版式 + 3 个 SPC 结构页；v4.0 起 16 个通用页型退库走栅格直排，见 grid-composition.md），选择走 layout-library 单一决策表 + 首选核心集； 数据强制图表化三环硬门禁。组件层：charts.py 14 类数据图表 · consulting.py 咨询异形与标注层 · structures.py 咨询结构版式（矩阵/树/泳道/蓝图/金字塔等，含 RACI 每行一 A、Mekko ≤7 列等强校验）· themes.py 结构页 · SVG→原生可编辑 PPTX 工具链 + tools/lint_svg.py 预检。 有意不落地：雷达图（依据与替代见 layout-library §不提供的图型）。

---

Step 1 · 加载规范（优先级顺序）

优先级 1（主路径）：

view references/brand-spec/brand.md
view references/brand-spec/track-rules.md

重点提取 PPT 相关内容：Action Title 规则、版式、色值、字体（Office 轨 · PPT 子模型，落地取值见 brand.md §7 + tokens.css §10）。

优先级 2（PPT 专项规范）：

view references/phase-01.md      ← 规范加载阶段
view references/wording-rules.md ← 用词风格规则，Phase 4 之前必须已加载
（按执行阶段依次读取对应 phase-XX.md）

（designer-rules.md 473 行，由 Phase 6/7 按需加载——启动时不预载，见下方索引表。）

wording-rules.md 管全部文字的写法，从 Phase 4 写第一个标题开始生效， 一直用到 Phase 8 自查。它是用词规则的唯一出处；phase-04/05/07/08 与 coach-engine 里只保留要点与指针，判据以该文件为准。

优先级 3（降级兜底）： 使用本文件末尾「降级基线」（唯一降级标准，phase-01 同此，不另设第二套）。

本技能自带完整 SVG→原生 PPTX 转换链，不加载官方 pptx 技能（其配色/装饰建议与本体系直接冲突）。仅当需要读取/编辑客户存量 .pptx 时，才按运行环境定位官方 pptx 技能，且只用其文件操作部分、忽略其全部设计建议。

视觉档规范（务必加载）：

view references/theme-tiers.md     ← 三档主题：A 克制 / B 现代专业 / C 高表现（默认 B）

（字宽修复 / 强调色语义 QC / 图标组件 / 内容方法论已并入 designer-rules.md、phase-02.md 与组件代码，不再单列文件。） 图标与组件资产位于 assets/components/：icons.py（~40 线性图标 + icon_circle）、 layouts.py（内容区型版式层 8 式：hero(S-07 支撑 2/3/4 硬拦)/concept_curve/stage_flow/tri_layer/action_table/pyramid_light/team_grid(2–8)/price_table(1–8 · 合计不求和)；整页 I·T 系与纯栅格版式已 v4.0 移出走 grid-composition 直排）、components.py（基础原子：文本 T / 线 L / 面板 P / 转义 esc / 箭头 arrow·carrow / 标签 chip / 六边形 / 状态点 status / 图占位框 placeholder / 色板与字体常量）、charts.py（15 类数据图表：柱/横柱/折线/瀑布/漏斗/甘特/子弹/堆叠/坡度/sparkline/KPI卡/Marimekko/FTE爬坡/三地平线/小倍数网格(V-05·共享尺度强制)，一行调用、brand §7.5 合规、转换实测可编辑）、themes.py（A/B 封面/目录/章节/页眉模板 + C 档深色模板 cover_dark/section_dark/quote_dark）、consulting.py（咨询异形层：雪佛龙链/流向带/哑铃/点阵/驱动树+肘线+算子/链式递减 + 标注层（椭圆圈注/引线/水印/线画对勾/So-What），形体骨架在各系文件 90 段章节、标注层与纪律见 references/svg-skeleton-common.md §咨询密集层 D）、structures.py（咨询结构层：网格/树对齐引擎 + 组合矩阵/RACI/issue tree/分层架构/泳道路线图（gantt·chevron·分桶三模式）/服务蓝图/剖面金字塔/论证阶梯/推算件/记号/降级同心弧 + v4.0 新增 Harvey评估表/竞争弧带图/价值链/鱼骨/Impact-Effort/决策树，含强校验：RACI 每行一 A、Mekko ≤7 列、蓝图固定 5 泳道、Harvey 0–4 五档、决策树 EV 不代算）。

---

Step 1.5 · 选择视觉档（默认 B · 现代专业档）

加载规范后、解析材料前，向用户确认一次视觉档（回车默认 B）：

这份 PPT 用哪种视觉档？
  A 克制档     —— 纯白极简，适合高层正式汇报、严谨决策
  B 现代专业档 —— 图标 + 关系图 + 设计化封面/目录/章节（默认，适合多数客户方案）
  C 高表现力档 —— B 的一切 + 深色重音页（封面/章节/金句）+ 数据图表占主导，适合路演/竞标/重点客户（偏“演说稿”，严肃决策仍用 A）
直接回车 = B。

记录 theme = A | B | C。三档共用同一套内容与组件，只切换主题层：A/B 切换封面/目录/章节模板 + 页眉皮肤；C 在 B 之上再叠加深色重音页（封面/章节/金句）。 三档都坚持单一品牌主色 + 中性灰，不引入多色体系（多色实测"AI 感/营销感"偏重）。 phase-05（版式）/ phase-07（出片）按 theme 取用 themes.py 对应模板：A/B 用 cover/toc/section/chrome；C 用 cover_dark/section_dark/quote_dark（封面/章节/金句）+ chrome（内容页沿用 B 皮肤）+ charts 组件（数据页占主导）。详见 references/theme-tiers.md。

---

Step 2 · 八阶段执行（逐阶段加载 · 卡点等待 · 不可跳步）

⚠️ 执行铁律（最高优先级，覆盖"尽快出片"的默认倾向）：

1. 逐阶段加载：进入第 N 阶段前，必须先 view references/phase-0N.md 并完整执行其中的「强制等待锚点」与全部步骤——禁止只凭下方阶段名脑补着做。
2. 卡点等待：每个阶段结束必须输出该阶段「完成卡」，并等用户确认后才进入下一阶段；用户未确认，不得继续。
3. 不可跳步 / 不可合并：八阶段按序逐个执行，禁止跳过（尤其 P3 论点提炼、P4 叙事骨架、P6 样稿确认这三个最易被省的环节），禁止把多个阶段并成一次产出。例外：专家档按 coach-engine「专家档合并闸门」合并部分停等卡点（只减停等次数、不减任何测试/质检项），不视为违反本条。
4. 进度可见：每个阶段开头先输出一行 【阶段 N/8 · 名称 · 已加载 phase-0N.md】，让执行轨迹可被监督（各 phase 文件顶部已重申此要求）。
5. Phase 1 ≠ Step 1：Step 1 只完成规范 view；phase-01 的受众问答（强制等待锚点）与受众卡/完成卡仍须照常执行，不得因 Step 1 已加载文件就跳过 Phase 1 的实质工作。

阶段一览（名称仅供索引，不能据此直接产出；详细指引各见对应文件）：

#	阶段	文件
1	规范与受众定义（Step 1 仅加载规范；受众卡/完成卡须按 phase-01 执行，不可视作已完成）	references/phase-01.md
2	材料解析与关键信息提取	references/phase-02.md
3	核心论点提炼（金字塔原理）	references/phase-03.md
4	叙事骨架搭建（Ghost Deck）	references/phase-04.md
5	大纲与版式规划	references/phase-05.md
6	样稿确认（与用户对齐）	references/phase-06.md
7	逐页设计输出（附属规范：pptx-native-rules.md 转换前必读、quality-audit-protocol.md 转换后 Gate/lint）	references/phase-07.md
8	质检交付（QC 清单；附属规范：quality-audit-protocol.md 人工审计环节）	references/phase-08.md
—	用词风格规则（全阶段生效，Phase 4 起必须已加载）	references/wording-rules.md

references 索引（全部文件 · 何时读）

文件	何时读	用途
brand-spec/brand.md + tokens.css	Step 1	品牌规范 + 取值唯一事实源
brand-spec/track-rules.md	Step 1	轨道分流与铁规
brand-spec/iconography.md	Phase 6/7（用图标时）	图标规范（含 icons.py 自绘例外登记）
theme-tiers.md	Step 1（务必）	A/B/C 三档主题对照
phase-01.md … phase-08.md	各阶段入口（铁律 1）	阶段执行细则
coach-engine.md	Phase 1 末尾起全程	档位检测 / 引导序列 / 专家档合并闸门
designer-rules.md	Phase 6/7	设计原则 + 品牌纪律 + PPTX 约束（全库最大 md，按需加载）
grid-system.md	Phase 5/7（直排页）	栅格坐标唯一源 + 汉字字数表
layout-library.md	Phase 5	版式单一决策表 + 图表速查（权威清单）
svg-skeleton-common.md	Phase 7	Chrome/构件/状态/咨询密集层 D
svg-skeleton-{s,e,g,i,t,v,a}.md	Phase 7（按当前页系，仅读 1 个）	各系版式五栏章节
chart-impl.md	Phase 7（图表页）	图表手画模板（charts.py 未覆盖时才用）
pptx-native-rules.md	Phase 7 转换前	转换规范 / 支持矩阵 / 排查
quality-audit-protocol.md	Phase 7 转换后 + Phase 8	三级关卡 + lint 双轨 + 人工审计

---

降级基线（无法读取外部规范时）

⚠️ 未找到外部规范，使用内嵌基线（Aham UI v6.1 · Office 轨 · PPT）。

PPT 核心规则（北极星：极简克制的桌面 AI 气质 · 冷色的纸 · 蓝是点缀）：

• 底永远纯白 #FFFFFF；三层灰 #FFFFFF/#F3F3F3/#E7E7E7；墨四级 #262626/#6E6E6E/#9B9B9B/#C4C4C4。禁纯黑 #000。
• 蓝 #336EE8 只点缀（品牌点/主操作/选中/推荐/单个高亮数据点/封面短线）；无顶部蓝条、绝不铺底。
• Action Title：每页完整结论句、无衬线 bold #262626（无蓝竖线、无衬线）。 写法与用词见 references/wording-rules.md §2——主语必须可指认、页间交替、不出现数字、≤24 汉字单行。禁格言警句与对话腔。
• 字体：单一无衬线 Inter, 'PingFang SC', 'Microsoft YaHei', sans-serif（禁衬线）；数字一律 mono 'JetBrains Mono', Consolas, monospace。
• 卡片无边框无阴影；分块靠留白 + #E7E7E7 细横线；选中=扁平灰非蓝。
• 表格只横线、无竖线、无整行底色；数字右对齐 mono；表头/合计加粗。状态 = 6px 点 + 文字（禁红黄绿灯/pill）。
• 图表灰阶 #9B9B9B/#C8C8C8 + 一个 #336EE8 高亮；无 3D/阴影/渐变/饼图。
• 标题字号：内容 24pt、封面 32–40pt（左对齐）、正文 14–16pt、大数字 mono 44–60pt。
• 禁用：纯黑#000 / 渐变 / 3D / 投影 / 衬线 / 第二装饰彩色 / emoji / 饼图 / 表格竖线 / 蓝铺底 / 红黄绿灯。
• 禁用词：赋能·颠覆·生态·闭环·最佳实践·全链路·一站式·显著·大幅·承接·沉淀·落地·抓手·粒度·颗粒度·归集·收敛·下沉·对位·波次·地基·命脉·灰度·旁路·水位·卡位（详见「文案措辞」一节）。
• 数字格式：货币 ¥1,200,000；百分比 37.5%；日期 YYYY-MM-DD；数字用等宽 mono。
• 每页一个核心结论，表格优于文字堆砌。

---

附 · 文案措辞（客户不能看出这是 AI 写的）

硬要求，不是风格建议。P3/P4/P8 都要照此自查；P8 的「视觉审计」把它列为一项。 本节讲通用措辞；Action Title、导语、图内文案、卡片标题的专用规则见 references/wording-rules.md，与本节冲突时以该文件为准。 判据是"这词是不是真的"，不是"够不够浅"——行业真有的说法直接用、不解释； 为表达顺畅凑出来的搭配，再好懂也不能出现。

词

• 禁用词见上（降级基线那行）。此外：IT 黑话不进业务 PPT（上下文·下钻·心跳·埋点）。
• **不借外行业的词打比方。**波次（军事）、地基/命脉（比喻）、灰度/旁路（IT 发布）、 水位、抓手——实测一页里能撞出三个，业务读者一个都读不出来。
• "形成"不当万能动词——是签署、登记、记录、取得、生成，就直接说哪一个。
• **一个抽象词只能有一个意思。**实测一份 57 页方案里"口径"用了 17 次、四种意思 （报表规则/工单定义/产出率算法/报价方式），"适配"用了 34 次。 第二个意思出现时就换具体词。

句

• 单句 ≤60 字。中长句为主，指成分完整，不是拉长。
• 一句一件事，主语和动作都在：谁在做、做什么、做完是什么样。
• **不为对仗砍字。**几个并列项字数接近就是可疑信号——砍掉的往往正是消歧的那部分。 封面标语最容易犯："承接计划·管好现场·汇聚回传·分步落地"里， "汇聚回传"没主语没宾语，"分步落地"是任何项目都成立的废话。

结构

• 自造框架词要么定义要么不用。"五主线""七域""三类适配""P0/P1"是为组织内容造的， 客户没有这套语言。首次出现一句话讲清它指什么；说不清就是框架本身没想明白， 拆掉重来，不靠词撑着。
• **小标题按内容起，不套固定栏目。**同一栏目名（如每页都有一栏叫"适配"） 会逼读者每页重新猜它指什么，也是模板化最明显的痕迹。
• **不凑数。**发现两条写两条，不为"三点"补第三点。凑出来的那条永远最空。
• **强调靠位置和留白，不靠满页加粗。**加粗多了等于没有重点。
• 图表用一句话说清图里是什么，不教读者怎么看图 （"横向是八个阶段、纵向是九条泳道、方框是单据"——那是在替读者读图）。

事实

• **数得清的写数，数不清的说明白。**写"七类""八个阶段"之前对着内容数一遍。 实测出过"说七类只列了六项""说八个阶段表里只有六个"。
• **符号必须有图例。**用了 ☆★ 就在表下写清两者区别，抄表时最容易漏掉这句。
• 现状不等于目标。"某事现在做不好"推不出"本期要把它做好"—— 哪些进目标是客户定的，不能从现状反推。
• 没调研到的正面写出来（"夜班情况待确认"），不是不写，也不是含糊带过。 前期方案里 AI 味的主要表现不是用词花哨，是过度确定和过度整齐。

附 · 工程预检与防坑（实战复盘沉淀）

大体量册子（数十页、含信息图）批量生成时，以下几类坑会反复出现。渲染前后各跑一次 assets/tools/lint_svg.py。

1. 字符安全（防 tofu □）：序号用「圆圈 + 阿拉伯数字」，不要用 ①②③；对错用 √(U+221A) / ×(U+00D7) 或画 path，不要用 ✓✕；MONO/等宽文本只放 ASCII。源码文案一律用「」，不要用中文双引号 “”（会截断字符串、触发 SyntaxError）。
2. 图标：一物一图标、命名即语义；新增或修改图标后先跑 assets/tools/icons_preview.py 出缩略表肉眼核对。具象制造业图标库见 assets/components/mes_icons.py（worker/conveyor/andon/gearmold/injection… 共 25+）。
3. 页码：各页页脚写统一占位（chrome 的 page 传 "—"、total 全册同一个数），最后用 assets/tools/pageno_fill.py 一次性回填，不要在各脚本各写 total（否则出现 /50 与 /57 并存）。
4. 软件界面未到位：用 components.placeholder() 占位框，不要硬编假 UI（等真实截图替换）。
5. 术语一致：开工就建项目级 canonical 术语表（同一事物只用一个名，如线材/磁线只留一个、SN 与序列号统一）。
6. 事实准确：先建《项目基线》（来源分层、客户确认白名单、缺口标"待确认"、绝不编造数字），所有页引用它；交付前做 双轨审计 = 内容审计（逐页对基线，含架构/主线/场景）+ 视觉审计（排版/色/矛盾/错别字/重复/自造词），批准后再改。
7. 客户已评审的图为锚：客户确认过的架构图/口径设为不可推翻，其余页向它对齐。
8. 每页独立信息图：同一章节相邻页不得套同一骨架（流程/对比/矩阵/空间/仪表轮换），避免"模板化"。