# Aham Ppt

> >

- **Type:** Skill
- **Install:** `agentstack add skill-aham-aiapp-aham-ppt-aham-ppt`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Aham-AIAPP](https://agentstack.voostack.com/s/aham-aiapp)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Aham-AIAPP](https://github.com/Aham-AIAPP)
- **Source:** https://github.com/Aham-AIAPP/aham-ppt
- **Website:** https://aham-aiapp.github.io/aham-ppt/

## Install

```sh
agentstack add skill-aham-aiapp-aham-ppt-aham-ppt
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 线性图标 + 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` |

### 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](https://github.com/Aham-AIAPP)
- **Source:** [Aham-AIAPP/aham-ppt](https://github.com/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.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-aham-aiapp-aham-ppt-aham-ppt
- Seller: https://agentstack.voostack.com/s/aham-aiapp
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.