Aham Ppt

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  ← 规范加载阶段
（按执行阶段依次读取对应 phase-XX.md）

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

优先级 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 线性图标 + iconcircle）、 layouts.py（内容区型版式层 8 式：hero(S-07 支撑 2/3/4 硬拦)/conceptcurve/stageflow/trilayer/actiontable/pyramidlight/teamgrid(2–8)/pricetable(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 |

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（无蓝竖线、无衬线）。
• 字体：单一无衬线 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。
• 每页一个核心结论，表格优于文字堆砌。

---

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

> 大体量册子（数十页、含信息图）批量生成时，以下几类坑会反复出现。渲染前后各跑一次 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. 每页独立信息图：同一章节相邻页不得套同一骨架（流程/对比/矩阵/空间/仪表轮换），避免"模板化"。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Aham-AIAPP
• Source: Aham-AIAPP/aham-ppt
• License: MIT
• Homepage: https://aham-aiapp.github.io/aham-ppt/

Install and usage instructions live in the source repository linked above.