slide-writer

---
name: slide-writer
display_name: Slide-Writer
description: 把想法、大纲、文档或草稿变成结构清晰、设计精良的企业级 HTML 演示文稿。
version: 1.0.0
author: Feei
homepage: https://github.com/FeeiCN/slide-writer
repository: https://github.com/FeeiCN/slide-writer
license: MIT
tags:
  - presentation
  - slides
  - ppt
  - keynote
  - html
  - storytelling
  - enterprise
entry: SKILL.md
language: zh-CN
compatible_with:
  - claude-code
  - codex
---

# Slide-Writer

把任意输入（想法、大纲、草稿文档、会议纪要）转化为企业级 HTML 演示文稿，自动匹配所在公司的品牌主题。

## 核心原则

1. **品牌一致** — 从请求中自动识别公司，应用对应品牌色主题；内置 14 家互联网公司主题。
2. **内容为王** — 自动润色每句话：去冗余、精简、让表达更有力。
3. **不溢出** — 每张幻灯片必须在 100vh 内完整呈现，内容多则分页，绝不出现滚动条。
4. **单文件交付** — 输出单个 `.html` 文件，CSS/JS 全部内联，零依赖，浏览器直接打开。

---

## Phase 0：准备

### 自动更新（第一步，必须执行）

```bash
git pull --ff-only
```

成功 → 静默继续；失败（无网络 / 有冲突）→ 静默忽略，继续使用当前版本。

### 模式识别

- **Mode A：全新制作** — 从主题/大纲/草稿创建，进入 Phase 1。
  - **A1：内容压缩** — 用户提供了演讲稿、大纲或草稿（输入字数 ≥ 200 字），目标是提炼精简，应用演讲稿转PPT规则和密度上限。
  - **A2：主题创作** — 用户只提供了主题/标题（输入字数 < 200 字），目标是**主动生成丰富内容**，充分展开每个子话题，**不受演讲稿压缩规则约束**，卡片描述上限放宽至 120 字，页数默认 10–15 页。
- **Mode B：增强改稿** — 在现有 HTML 上修改或扩充内容：
  1. 完整读取现有 HTML，识别所有 `<section>` 的 `id`、`class`、标题，输出当前幻灯片清单
  2. **范围判断**：修改 ≤ 3 张 → 精确改稿；修改 > 30% 或新增 > 原有 → 建议用 Mode A 重新生成
  3. 识别原有主题（用户未要求更换则保留）
  4. 按用户描述（序号、标题关键词）定位目标 `<section>`，**确认后再操作**
  5. 只改被点名的 `<section>`，新增页插入逻辑最合适的位置
  6. 未被点名的幻灯片保持原样，不做"顺手优化"
  7. 改完检查：目录议程项数与内容页数是否一致？章节逻辑是否连贯？不一致则列出，询问用户是否同步更新
  8. 执行与 Mode A 相同的质量检查

### 主题检测

读取 [themes/_index.md](themes/_index.md)，从用户请求提取公司关键词，优先级从高到低：

1. 用户明确指定的公司名、产品名
2. 署名中的部门/团队名称
3. 内容中出现的公司名

- 识别到 → 记录主题 ID 和 `themes/[id].md` 路径
- 未识别到 → 默认蚂蚁集团+支付宝双 Logo 主题
- 多品牌冲突 → 按 `themes/_index.md` 优先级链执行

---

## Phase 1：内容收集

一次性收集以下信息（运行环境支持 `AskUserQuestion` 则用它补问，否则发一条消息补问）：

| 字段 | 说明 |
|---|---|
| **公司** | 所在公司或品牌名称（用于匹配主题色） |
| **主题** | 演讲 / 汇报的核心主题 |
| **受众** | 管理层 / 团队内部 / 跨部门 / 外部客户 |
| **页数** | 5–8 页 / 10–15 页 / 20 页以上 |
| **内容** | 粘贴大纲、草稿或关键要点；只有主题时说明即可 |
| **署名** | 演讲者姓名 + 角色/岗位/Title（用于封面） |
| **日期** | 演讲日期（默认今天） |

**缺失字段的推断规则：**

- **公司** → 从内容、署名、部门名称推断；仍无法识别则默认蚂蚁集团
- **受众** → 含"汇报/review/决策/管理层" → 管理层；含"分享/复盘/团队" → 团队内部；含"提案/客户/合作" → 外部客户；无法判断 → 内部汇报
- **页数** → 按模式和字数推断：
  - **Mode A2（主题创作）**：默认 10–15 页，主题内涵丰富（含多子话题、历史文化、数据等）可到 15–20 页；
  - **Mode A1（内容压缩）**：< 500 字 → 4–6 页；500–1500 字 → 8–12 页；1500–3000 字 → 12–18 页；> 3000 字 → 18 页以上；
  - 推断结果与内容明显不符时，进入 Phase 2 前显式确认
- **日期** → 默认今天
- **署名** → 从内容或当前用户信息推断；无法推断则默认"演讲者"

Phase 1 完成后通知：`已收集：[公司] · [受众] · [页数] 页 · [署名]`

---

## Phase 2：结构规划

### 必须包含的页面

| 页面类型 | Slide Class | 豁免条件 |
|---|---|---|
| 封面页 | `slide-cover` | 无豁免 |
| 目录页 | `slide-white` | 总页数 ≤ 6 时省略 |
| 章节过渡页 | `slide-section` | 该章节内容页 < 3 时省略；章节页总数不超过内容页的 1/3 |
| 结尾页 | `slide-qa` | 无豁免 |

> **小型 PPT（≤ 6 页）**：封面 + 内容页 + 结尾，不强插目录和章节页。

### 演讲稿转 PPT 规则（**仅 Mode A1** 执行，Mode A2 跳过）

1. **PPT 是辅助，不是原文上墙** — 禁止逐段照搬，单页文字量必须明显少于讲稿密度。
2. **一页一判断** — 提炼一个结论句作为标题，保留 2–4 个支撑点；多论点拆成多页。
3. **留金句，删铺垫** — 保留数字、判断、类比；删寒暄、重复、口语化过渡；引用只取 1 句。
4. **3 秒可读** — 满足任一条即达标：① 单页总字数 ≤ 80 字；② bullet ≤ 4 条且每条 ≤ 15 字；③ 数字 ≤ 3 个且说明 ≤ 30 字；④ 视觉块占页面 ≥ 40%。
5. **第一视角** — 标题优先用"我们 / 今天想讲"，不用"作者认为""整场发言围绕"。

不适合搬到 PPT 的内容：开场寒暄、重复表达、口语化连接词、大段故事细节、抒情句、可口头补充的背景说明。

### 主题创作原则（**仅 Mode A2** 执行）

1. **内容深度优先** — 每个子话题充分展开，给出背景、细节、意义，让读者看完幻灯片本身就能获得完整信息，无需演讲者补充。
2. **完整性** — 凡主题中含有明确数量的事物（如"十景"、"三原则"、"五步骤"），必须全部列出，不得因排版便利而截断；超出单页容量则拆分为多页并在标题注明"（上）""（下）"。
3. **引用原话** — 文化/历史类主题应引用原始诗句、史料或名言，不用泛泛描述代替。
4. **卡片描述上限放宽** — 信息卡片描述 ≤ 120 字，步骤卡描述 ≤ 80 字，单页总字数 ≤ 300 字；超出则拆页，不压缩内容。
5. **标题是结论，不是话题** — 即便是介绍性内容，标题也应给出判断（"苏堤是人工干预自然的最美典范"而非"苏堤简介"）。

### 视觉化原则

1. **先做结构，再放文字** — 优先用数字、卡片、对比、流程承载内容。
2. **主视觉节奏清晰** — 多个视觉区块间必须有明确层级和分组；内容超出屏幕时拆页，不缩字号强塞。
3. **把段落改成组件** — 长段优先改写成组件；可复用 `stat-block`、`step-card`、`quote-box`、`agenda-item`，也可按内容需要设计新的页面骨架与信息组件。
4. **关键词可扫读** — 数字、判断句必须一眼能扫到；长句只作补充。
5. **多横向，少纵向** — 优先并列卡片、对比、矩阵，少用连续纵向文字。
6. **每 3–4 页变换节奏** — 穿插章节页、金句页、大字判断页或轻内容页。
7. **先判内容形态，再选版式** — 见「内容类型 → 组件选择」表。
8. **标题区固定** — 所有内容页标题区位置一致，不因正文密度漂移。
9. **SVG 优先** — 数量对比、趋势、占比、流程优先用内联 SVG；禁止纯数字+文字句子描述可视化数据。
10. **视觉效果分层** — 重点卡片叠加渐变背景 + 顶部色条 + pill 标签；径向渐变光圈作点缀，不要每张卡都加。
11. **组件库是起点，不是边界** — `components.md` 提供的是高频可复用参考，不是完整上限；当主题更适合地图、时间带、关系网、年表、分镜、注释图、海报式大字、档案卡、实物标注、时间切片、城市剖面等表达时，应优先为内容发明更合适的新组件。

### 内容类型 → 组件选择

在写每页 HTML 前，先判断内容形态，再选布局。优先级：**页面骨架 > 成组组件 > 普通 bullet**。下表是推荐起点，不是限制清单；若现有组件不够贴合，应自定义新骨架而不是勉强套用。

| 内容形态 | 推荐组件 / 骨架 | 避免 |
|---|---|---|
| 全文总览 / 章节预告 | `agenda-item`、分组目录页 | 普通 bullet 平铺目录 |
| 开场判断 / 问题定义 | 开场钩子页、`highlight-box` + `info-card` | 整页长段正文 |
| 单一核心结论 | `highlight-box`、`stat-block`、大数字 | 密集列表或多主题混页 |
| 核心结论 + 数据支撑 | `insight-panel` | 判断句和数字分散在两张独立卡片 |
| 并列要点 / 三原则 | `three-col`、`info-card`、`stat-block` | 三个平级观点写成纵向长段 |
| 双对象对比 | `two-col`、左右图文混排 | 单列顺序写法 |
| 分阶段推进 | `step-card`、`step-flow-grid` | 普通 bullet 描述"第一第二第三" |
| 月度 / 季度路线图 | `roadmap-col` | 普通 step-card 忽略时间轴感 |
| 工作流 / 研发流程 | `flow-item`（4列×N行） | 有序列表平铺 8 个步骤 |
| 能力成熟度 / 等级体系 | `level-row` | 普通 bullet 描述各等级 |
| 组织支撑 / 能力体系 | `support-board`、`support-card`、`role-card` | 多段正文描述体系 |
| 责任清单 / 人员分工 | `support-mini-card` + `@负责人` | 普通 bullet 列名字 |
| 多角色流转 / 跨方协同 | `demand-flow-board` | 静态列表描述角色 |
| 数据 / 占比 / 趋势 | `stat-block`、进度条、SVG 图表、表格 | 只写数字句子无图形支撑 |
| 排名 / 优先级 | `bar-rank` | 纯数字列表 |
| 业务线 / 产品集合 | `tag-cloud` | 等高等大标签平铺 |
| 产品截图 | `browser-mockup` | 裸放图片无上下文 |
| 引用原话 | `quote-box`、`insight` | 堆多段长引用 |
| 结尾总结 | 分组总结页、`agenda-item`、`highlight-box` | 结尾再展开大量新信息 |

**组件约束：**
- 先选骨架，再选骨架内组件；强结构页（`support-board`、`demand-flow-board`）不退回普通卡片页。
- 卡片未铺满一行时容器收窄居中：1张→40%、2张→60%、3张→80%、4张以上→100%；用 `style="max-width:X%;margin:0 auto;"` 写在容器上。
- 内容偏少时 `slide-body` 显式加 `justify-content:center`，避免内容贴在上半屏。
- `components.md` 是参考库，不是白名单。允许自定义 HTML、CSS class 和新的信息组件，只要遵守当前模板的 CSS 变量、字号体系、留白系统与交互约束。
- 自定义组件应优先解决“现有组件表达不清”的问题，而不是只换视觉皮肤；新组件必须有清晰的信息任务，例如表达时间跨度、地理关系、因果链、空间层级、证据标注、版本差异、结构剖面。
- 新组件优先保持语义化命名，例如 `timeline-band`、`map-note-card`、`artifact-callout`、`split-metric-stage`、`city-axis-board`，避免无语义的 `box-1`、`layout-a`。
- 新组件可以是整页骨架，不必退化成卡片拼贴；允许使用注释线、时间轴带、分层底图、局部放大框、编号锚点、档案标签、印章式视觉、报纸栏、策展墙、编年表、示意地图等展示方式。
- **叙述型卡片页禁止 5 列**：含标题+描述+bullet 的解释型页面最多 4 列；5 列只用于极短标签卡或纯图标卡。
- **禁止"上实下空"**：页面底部留白明显大于顶部时，视为未完成布局。

### 新组件设计规则

当需要超出 `components.md` 时，按以下规则设计：

1. **先定义信息任务** — 先说清楚这页要表达的是时间、空间、关系、证据、对照、层次还是叙事，再决定组件形态。
2. **一页只引入 1 个主创意** — 可以有辅助组件，但主视觉语言必须单一，避免一页内同时出现时间轴 + 地图 + 大表格 + 多层卡片。
3. **可扫读优先于炫技** — 新组件必须让读者 3 秒内看懂主结论，不能为了“新”而牺牲信息获取速度。
4. **结构先于装饰** — 先确定信息区块、阅读顺序、锚点和对齐关系，再加渐变、阴影、纹理、印章、边框等装饰。
5. **允许为主题定制组件** — 历史类可用编年轴、文物注释卡、古今对照图；战略类可用战区图、优先级棋盘；产品类可用分镜、界面放大镜、漏斗剧场；教育类可用黑板式推演、题眼拆解图。
6. **复用已有设计语言** — 即便新建组件，也要继续使用现有颜色变量、圆角、阴影、字号层级和 reveal 动画，不要做成另一个完全割裂的系统。
7. **能抽象再抽象** — 如果某个新组件在 2 页以上重复出现，第二次开始应抽成稳定 class 命名，而不是每页一套散装内联样式。

### 内容密度规则

| 内容类型 | Mode A2（主题创作） | Mode A1（内容压缩） |
|---|---|---|
| 文字要点 | 10–15 条 bullet，每条 ≤ 40 字 | **6–8 条**，每条 ≤ 25 字 |
| 信息卡片（横向） | 5–6 列，描述 ≤ 120 字 | **4–5 列**，描述 ≤ 50 字 |
| 信息卡片（纵向） | 单列 ≤ 10 张，描述 ≤ 120 字/张 | 单列 ≤ 6 张，描述 ≤ 35 字/张 |
| 数据统计 | 6–9 个 stat-block，配 1–2 句解读 | 6 个，配 1 句解读 |
| 对比/流程 | 4–6 个 step-card，描述 ≤ 80 字 | **4 个**，描述 ≤ 35 字 |
| 表格 | 最多 12 行 × 6 列 | 最多 8 行 × 5 列 |
| 引用原话 | 1–3 段，每段 ≤ 150 字 | 1 段，**≤ 80 字** |
| 卡片描述正文 | **3–5 句话**，≤ 120 字 | **2–3 句话**，≤ 50 字 |
| 单页总字数 | ≤ 300 字 | ≤ 150 字 |

超出限制 → 自动拆成多页，页间用连贯的过渡标题衔接。

### 布局多样性

**规划完成后，进入 Phase 3 前必须执行以下自检：**

1. 统计各类型布局的页数（多列卡片、流程、bullet、纯视觉）
2. 检查局部连续约束：
   - `three-col` / `info-card` ≥ 4 连续 → 中间插入过渡页或大字判断页
   - `step-card` ≥ 3 连续 → 第 4 页换其他骨架
   - `styled-list` ≥ 4 连续 → 至少 1 页改为卡片或图表
3. 检查全局约束：
   - 多列卡片页占内容页 > 55% → 替换超出部分
   - 总页数 > 10 且无纯视觉页 → 插入至少 1 页（建议放中段）
4. 有调整则在规划清单中用 `[调整]` 标注改动位置

### 文字润色（自动执行）

1. **去冗余** — 删除"我们认为""需要指出的是"等无信息量前缀。
2. **名词化** — "进行分析"→"分析"，"做出决策"→"决策"。
3. **数字化** — 只润色原文已有数字的表达（"百分之三十七"→"37%"）；禁止编造原文无源的具体数字。
   - ✅ 原文含"50+"→ 保留"50+ 轮测试"；原文含"故障率""下降"→ 可补"故障率下降 40%"
   - ❌ 原文"取得成果"→ 不可杜撰"节省 200 万元"；原文"反馈不错"→ 不可杜撰"满意度 92%"
4. **动词有力** — 用"推进""落地""打通""提升"替代"做""进行""开展"。
5. **层级清晰** — 主标题是结论/判断，副标题是补充说明，内容是支撑。
6. **引用克制** — 只保留最有代表性的 1 句；同页不出现多段长引用。

Phase 2 完成后通知：`规划完成，共 N 张，开始生成…`

---

## Phase 3：生成 HTML

### Step 3.1：准备文件

**① 复制模板**
```bash
cp template.html [输出文件名].html
```
- 禁止直接编辑 `template.html` 本身
- 文件名使用英文小写 + 连字符，例如 `antgroup-q1-review.html`

**② 并行读取**（同时发起）

- **`themes/[id].md`** — 获取 CSS 变量、`.slide-section` / `.slide-qa` 覆盖、logo 路径
- **`components.md`** — 只 Grep Phase 2 中用到的组件章节，不必全读
- **`components.md`** — 作为高频组件参考；若规划包含创新布局，只需读取相关章节借鉴命名、字号和留白，不要把它当成白名单
- **`icons.md`**（含图标槽时按需 Grep）— 中文主题 → 英文图标名参考：

  | 中文关键词 | 推荐图标名 |
  |---|---|
  | 安全、防护、权限、合规 | `shield`, `lock`, `eye-off` |
  | 数据、分析、统计、报告 | `bar-chart-2`, `pie-chart`, `trending-up` |
  | 用户、客户、团队、人员 | `users`, `user`, `user-check` |
  | 流程、步骤、推进、路径 | `arrow-right`, `git-branch`, `navigation` |
  | 目标、战略、方向、规划 | `target`, `flag`, `compass` |
  | 技术、系统、架构、平台 | `cpu`, `server`, `layers` |
  | 效率、性能、速度、优化 | `zap`, `clock`, `activity` |
  | 成本、金融、收益、预算 | `dollar-sign`, `credit-card`, `trending-down` |
  | 协同、沟通、对接、整合 | `link`, `share-2`, `message-circle` |
  | 风险、问题、告警、异常 | `alert-triangle`, `x-circle`, `bell` |
  | 创新、产品、功能、特性 | `star`, `package`, `box` |
  | 运营、推广、增长、运作 | `trending-up`, `repeat`, `refresh-cw` |

### Step 3.2：填充占位符

`template.html` 已内置蚂蚁集团默认值（双 logo、页脚文字）。标题、主题样式、logo 全部改为脚本直接写回 HTML，不再手工替换。

**① 标题**
**② 主题样式**
**③ Logo**

```bash
# `theme-id` 默认为 `ant-group`
python3 scripts/apply-template-branding.py [文件名].html \
  --title "[演讲主题]" \
  --speaker "[演讲者]" \
  --theme-id [theme-id]
```

规则：

- `theme-id=ant-group` 时保留 `<!-- %%THEME_STYLE%% -->`
- 其他主题从 `themes/[id].md` 的 `## CSS` 代码块注入 `<style>...</style>`
- `#globalLogoGroup` 是唯一 logo 节点，**禁止在任何 `<section>` 内写 logo**
- logo 文件缺失时按脚本 fallback；必要时自动隐藏并输出 warning

**④ 幻灯片内容（必填）**
```
old: <!-- %%SLIDES%% -->
new: 所有 <section> 幻灯片 HTML
```

**主题应用说明：**
- `.slide-section` / `.slide-qa` 必须用 `!important` 覆盖基础 CSS 中的硬编码渐变
- `--primary-pale` 会自动影响 `info-card` 背景、`agenda-item` hover 等，无需逐一覆盖

### Step 3.3：写幻灯片

每张写入前先输出进度：`→ 03/12  技术架构现状`（序号补零到总数位数）

**封面页**
```html
<section class="slide slide-cover" id="slide-1">
    <div class="cover-arcs" aria-hidden="true">
        <div class="arc arc-1"></div><div class="arc arc-2"></div><div class="arc arc-3"></div>
    </div>
    <div class="cover-top reveal" style="display:flex;align-items:center;">
        <span style="color:rgba(255,255,255,0.65);font-size:clamp(0.65rem,1.1vw,0.85rem);">[部门]</span>
    </div>
    <div class="cover-main">
        <h1 class="cover-title reveal">[主标题]</h1>
        <p class="cover-subtitle reveal">[副标题]</p>
        <p class="reveal" style="font-size:clamp(0.85rem,1.5vw,1.1rem);color:#fff;font-weight:700;">[姓名｜角色/Title]</p>
    </div>
    <div class="cover-bottom"><div class="cover-date reveal">[日期]</div></div>
</section>
```

**内容页（白色）**
```html
<section class="slide slide-white" id="slide-N">
    <div class="slide-header center-stack">
        <span class="header-mark"></span>
        <h2 class="header-title">[结论/判断句]</h2>
        <p class="header-sub">[补充说明]</p>
    </div>
    <div class="slide-body" style="justify-content:center;">
        <!-- 组件区 -->
    </div>
</section>
```

**章节过渡页**
```html
<section class="slide slide-section" id="slide-N">
    <p class="section-num reveal">PART [N]</p>
    <h2 class="section-title reveal">[章节标题]</h2>
    <p class="section-desc reveal">[一句话说明本章节要回答的问题]</p>
</section>
```

**结尾页**
```html
<section class="slide slide-qa" id="slide-N">
    <h2 class="qa-title reveal">Q&amp;A</h2>
    <p class="qa-sub reveal">[感谢语]</p>
</section>
```

**写入约束（所有幻灯片必须遵守）：**

| 场景 | 写法 |
|---|---|
| 普通间距、字号 | `clamp()` 或 CSS 变量 |
| 固定 px 尺寸 | `calc(Npx * var(--vp-scale, 1))` |
| 容器最大宽度 | `min(calc(XYZpx * var(--vp-scale, 1)), 100%)` |
| `max-width` 写死 px | **禁止** |
| 内容区宽度 | `<div style="width:min(100%,var(--deck-safe-width));margin:0 auto;">` |

**密度自检**（每页必须执行，按模式选对应上限）：

| 检查项 | A2 主题创作上限 | A1 内容压缩上限 | 处理 |
|---|---|---|---|
| bullet 条数 | ≤ 15 条 | ≤ 8 条 | 超出则拆页 |
| 每条 bullet 字数 | ≤ 40 字 | ≤ 25 字 | 超出则压缩 |
| 单页总字数 | ≤ 300 字 | ≤ 150 字 | 超出则拆页 |
| info-card 描述 | ≤ 120 字/张 | ≤ 35 字/张 | A1 超出则精简；A2 超出则拆页 |
| 标题类型 | 结论句 | 结论句 | 话题词改判断句 |

---

## Phase 4：输出

**Step 4.1：保存**

文件名英文小写 + 连字符；中文关键词转拼音或英译。

**Step 4.2：单体化兜底扫描**

logo 应在 Step 3.2 ③ 直接从 `themes/logos/*.txt` 写入。此步骤仅处理其他外部图片遗漏的边缘情况：

```bash
python3 scripts/inline-images.py [文件名].html
```

**Step 4.3：Smoke Test（必须执行，不得跳过）**

生成完成后立即运行静态检查；失败时必须修复后重跑，不得跳过也不得仅凭”看起来没问题”省略：

```bash
./scripts/smoke-test.sh [文件名].html
```

> **执行后在回复中明确写出：** `smoke-test: passed（N 张幻灯片）` 或 `smoke-test: FAILED — [原因]`。未写出视为未执行。

**Step 4.4：用浏览器直接打开文件（必须执行，不得跳过）**

```bash
open [文件名].html
```

> **执行后在回复中明确写出：** `已用 open 打开浏览器` 或 `受环境限制无法打开 — [原因]`。未写出视为未执行。

成功标准：浏览器直接打开本地 HTML 文件，且不依赖本地 HTTP 服务。

**Step 4.5：最终交付摘要（必须输出，格式固定）**

在回复的最后输出以下固定格式的摘要块，所有字段必填，缺任何一项视为未完成：

```
📦 交付摘要
文件路径：[绝对路径或相对路径]
文件大小：[X KB]
幻灯片数：[N] 张
主题：[theme-id]
smoke-test：通过 / 失败（[原因]）
浏览器：已打开 / 无法打开（[原因]）
导航：方向键 / 空格翻页 · 右侧圆点 · F 全屏
```

### Phase 4 完成门槛（硬性约束）

> **在以下全部条件满足前，禁止输出”完成””Done””已生成”或任何等价的结束表述。**

- [ ] Step 4.1 文件已保存，文件名符合命名规范
- [ ] Step 4.2 `inline-images.py` 已执行
- [ ] Step 4.3 `smoke-test.sh` 已执行，结果已在回复中明确写出
- [ ] Step 4.4 `open` 已执行，结果已在回复中明确写出
- [ ] Step 4.5 交付摘要已按固定格式输出
- [ ] Step 4.5 已向用户回报上述结果

如果任一步未完成，最终答复必须改为“当前进度 + 阻塞原因”，不能伪装成完整交付。

---

## 附录 A：支持文件

| 文件 | 用途 | 何时读取 |
|---|---|---|
| [template.html](template.html) | 预构建引擎壳（含完整 CSS/JS） | Step 3.1 `cp`（必须） |
| [themes/_index.md](themes/_index.md) | 主题识别规则 + 子品牌表 + logo 索引 | Phase 0 主题检测 |
| `themes/[id].md` | CSS 变量 + logo 路径 + 补充规则 | Step 3.1 并行读取 |
| [components.md](components.md) | 组件 HTML 片段参考 | Step 3.1 按需 Grep |
| [icons.md](icons.md) | 287 个 Feather Icons 内联 SVG | 有图标槽时按需 Grep |
| `themes/logos/` | 品牌 logo 的 data URI 文本文件 | Step 3.2 ③ 直接读取 `.txt` |
| [examples/index.html](examples/index.html) | 完整示例文档 | 需要查阅组件骨架时 |

---

## 附录 B：进度通知规范

格式统一为纯文本，不用 markdown 列表或标题。

| 时机 | 格式 | 示例 |
|---|---|---|
| Phase 1 完成后 | 一句话确认元数据 | `已收集：腾讯 · 管理层汇报 · 12 页 · 张三 总监` |
| Phase 2 完成后 | 一句话说明页数 | `规划完成，共 12 张，开始生成…` |
| Step 3.3 每张写入前 | `→ 序号/总数  标题` | `→ 03/12  技术架构现状` |
| Step 4.2 完成后 | 一句话含文件大小 | `单体化完成，1.2 MB，无外部依赖。` |
| Step 4.3 | 见 Phase 4 Step 4.3 | — |

序号统一补零到总数位数（总数 12 则写 `01`，总数 100 则写 `001`）。

---

## 附录 C：执行检查清单

### Phase 0
- [ ] `git pull --ff-only`（失败则静默忽略）
- [ ] 提取公司关键词，确定主题文件路径

### Phase 1
- [ ] 一次性收集所有字段；缺失项按推断规则补全
- [ ] 页数推断结果与内容不符时，显式确认

### Phase 2
- [ ] 演讲稿输入：应用"演讲稿转换规则"，禁止逐段照搬
- [ ] 内容密度符合对应场景上限
- [ ] 布局多样性自检通过（局部连续 + 全局比例）
- [ ] 封面、目录、章节过渡、结尾均已规划

### Phase 3
- [ ] `cp template.html` 完成
- [ ] 填充 ① 标题 ② 主题样式 ③ logo（base64）④ 幻灯片内容
- [ ] 当前主题所需的 logo `.txt` 文件存在并已直接写入；文件缺失时执行 Fallback
- [ ] 每张幻灯片密度自检通过
- [ ] 所有 info-card / step-card 包含图标

### Phase 4
- [ ] Step 4.1 保存
- [ ] Step 4.2 扫描无残留外部引用
- [ ] Step 4.3 `smoke-test` 已执行并检查结果
- [ ] Step 4.4 已执行浏览器直接打开本地文件；若受限，已明确说明阻塞
- [ ] Step 4.5 已告知用户文件信息与验证结果

### 最终答复模板（必须对照）
- [ ] 文件路径
- [ ] 文件大小 / 幻灯片总数 / 主题名称
- [ ] `smoke-test` 结果
- [ ] 浏览器打开结果或阻塞原因
- [ ] 下一步可选动作

### 禁止项
- ❌ 在 `<section>` 内写 logo 代码
- ❌ `max-width` 写死 px
- ❌ 直接编辑 `template.html`
- ❌ 编造原文无源的具体数字
- ❌ 演讲稿逐段照搬
- ❌ info-card 不加图标
- ❌ 少量卡片在全宽容器里偏左留白

---

## 非目标

- 不生成 .pptx，只输出单个 HTML
- 不自动抓取互联网内容，除非用户提供素材
- 不伪造演讲者身份、职位、部门
- 不擅自修改未被点名的现有页面
- 不保证所有品牌主题与官方品牌规范完全一致