| name | slide-writer |
| description | 把想法、大纲、文档或草稿变成结构清晰、设计精良的企业级 HTML 演示文稿。 Use when this capability is needed. |
| metadata | {"author":"FeeiCN"} |
Slide-Writer
把任意输入（想法、大纲、草稿文档、会议纪要）转化为企业级 HTML 演示文稿，自动匹配所在公司的品牌主题。
核心原则
- 品牌一致 — 从请求中自动识别公司，应用对应品牌色主题；内置 14 家互联网公司主题。
- 内容为王 — 自动润色每句话：去冗余、精简、让表达更有力。
- 不溢出 — 每张幻灯片必须在 100vh 内完整呈现，内容多则分页，绝不出现滚动条。
- 单文件交付 — 输出单个
.html 文件，CSS/JS 全部内联，零依赖，浏览器直接打开。
Phase 0：准备
自动更新（第一步，必须执行）
git pull --ff-only
成功 → 静默继续；失败（无网络 / 有冲突）→ 静默忽略，继续使用当前版本。
模式识别
- Mode A：全新制作 — 从主题/大纲/草稿创建，进入 Phase 1。
- A1：内容压缩 — 用户提供了演讲稿、大纲或草稿（输入字数 ≥ 200 字），目标是提炼精简，应用演讲稿转PPT规则和密度上限。
- A2：主题创作 — 用户只提供了主题/标题（输入字数 < 200 字），目标是主动生成丰富内容，充分展开每个子话题，不受演讲稿压缩规则约束，卡片描述上限放宽至 120 字，页数默认 10–15 页。
- Mode B：增强改稿 — 在现有 HTML 上修改或扩充内容：
- 完整读取现有 HTML，识别所有
<section> 的 id、class、标题，输出当前幻灯片清单
- 范围判断：修改 ≤ 3 张 → 精确改稿；修改 > 30% 或新增 > 原有 → 建议用 Mode A 重新生成
- 识别原有主题（用户未要求更换则保留）
- 按用户描述（序号、标题关键词）定位目标
<section>，确认后再操作
- 只改被点名的
<section>，新增页插入逻辑最合适的位置
- 未被点名的幻灯片保持原样，不做"顺手优化"
- 改完检查：目录议程项数与内容页数是否一致？章节逻辑是否连贯？不一致则列出，询问用户是否同步更新
- 执行与 Mode A 相同的质量检查
主题检测
读取 themes/_index.md，从用户请求提取公司关键词，优先级从高到低：
- 用户明确指定的公司名、产品名
- 署名中的部门/团队名称
- 内容中出现的公司名
- 识别到 → 记录主题 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 跳过）
- PPT 是辅助，不是原文上墙 — 禁止逐段照搬，单页文字量必须明显少于讲稿密度。
- 一页一判断 — 提炼一个结论句作为标题，保留 2–4 个支撑点；多论点拆成多页。
- 留金句，删铺垫 — 保留数字、判断、类比；删寒暄、重复、口语化过渡；引用只取 1 句。
- 3 秒可读 — 满足任一条即达标：① 单页总字数 ≤ 80 字；② bullet ≤ 4 条且每条 ≤ 15 字；③ 数字 ≤ 3 个且说明 ≤ 30 字；④ 视觉块占页面 ≥ 40%。
- 第一视角 — 标题优先用"我们 / 今天想讲"，不用"作者认为""整场发言围绕"。
不适合搬到 PPT 的内容：开场寒暄、重复表达、口语化连接词、大段故事细节、抒情句、可口头补充的背景说明。
主题创作原则（仅 Mode A2 执行）
- 内容深度优先 — 每个子话题充分展开，给出背景、细节、意义，让读者看完幻灯片本身就能获得完整信息，无需演讲者补充。
- 完整性 — 凡主题中含有明确数量的事物（如"十景"、"三原则"、"五步骤"），必须全部列出，不得因排版便利而截断；超出单页容量则拆分为多页并在标题注明"（上）""（下）"。
- 引用原话 — 文化/历史类主题应引用原始诗句、史料或名言，不用泛泛描述代替。
- 卡片描述上限放宽 — 信息卡片描述 ≤ 120 字，步骤卡描述 ≤ 80 字，单页总字数 ≤ 300 字；超出则拆页，不压缩内容。
- 标题是结论，不是话题 — 即便是介绍性内容，标题也应给出判断（"苏堤是人工干预自然的最美典范"而非"苏堤简介"）。
视觉化原则
- 先做结构，再放文字 — 优先用数字、卡片、对比、流程承载内容。
- 主视觉节奏清晰 — 多个视觉区块间必须有明确层级和分组；内容超出屏幕时拆页，不缩字号强塞。
- 把段落改成组件 — 长段优先改写成组件；可复用
stat-block、step-card、quote-box、agenda-item，也可按内容需要设计新的页面骨架与信息组件。
- 关键词可扫读 — 数字、判断句必须一眼能扫到；长句只作补充。
- 多横向，少纵向 — 优先并列卡片、对比、矩阵，少用连续纵向文字。
- 每 3–4 页变换节奏 — 穿插章节页、金句页、大字判断页或轻内容页。
- 先判内容形态，再选版式 — 见「内容类型 → 组件选择」表。
- 标题区固定 — 所有内容页标题区位置一致，不因正文密度漂移。
- SVG 优先 — 数量对比、趋势、占比、流程优先用内联 SVG；禁止纯数字+文字句子描述可视化数据。
- 视觉效果分层 — 重点卡片叠加渐变背景 + 顶部色条 + pill 标签；径向渐变光圈作点缀，不要每张卡都加。
- 组件库是起点，不是边界 —
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、 |
组件约束：
- 先选骨架，再选骨架内组件；强结构页（
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 个主创意 — 可以有辅助组件，但主视觉语言必须单一，避免一页内同时出现时间轴 + 地图 + 大表格 + 多层卡片。
- 可扫读优先于炫技 — 新组件必须让读者 3 秒内看懂主结论，不能为了“新”而牺牲信息获取速度。
- 结构先于装饰 — 先确定信息区块、阅读顺序、锚点和对齐关系，再加渐变、阴影、纹理、印章、边框等装饰。
- 允许为主题定制组件 — 历史类可用编年轴、文物注释卡、古今对照图；战略类可用战区图、优先级棋盘；产品类可用分镜、界面放大镜、漏斗剧场；教育类可用黑板式推演、题眼拆解图。
- 复用已有设计语言 — 即便新建组件，也要继续使用现有颜色变量、圆角、阴影、字号层级和 reveal 动画，不要做成另一个完全割裂的系统。
- 能抽象再抽象 — 如果某个新组件在 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 前必须执行以下自检：
- 统计各类型布局的页数（多列卡片、流程、bullet、纯视觉）
- 检查局部连续约束：
three-col / info-card ≥ 4 连续 → 中间插入过渡页或大字判断页step-card ≥ 3 连续 → 第 4 页换其他骨架styled-list ≥ 4 连续 → 至少 1 页改为卡片或图表
- 检查全局约束：
- 多列卡片页占内容页 > 55% → 替换超出部分
- 总页数 > 10 且无纯视觉页 → 插入至少 1 页（建议放中段）
- 有调整则在规划清单中用
[调整] 标注改动位置
文字润色（自动执行）
- 去冗余 — 删除"我们认为""需要指出的是"等无信息量前缀。
- 名词化 — "进行分析"→"分析"，"做出决策"→"决策"。
- 数字化 — 只润色原文已有数字的表达（"百分之三十七"→"37%"）；禁止编造原文无源的具体数字。
- ✅ 原文含"50+"→ 保留"50+ 轮测试"；原文含"故障率""下降"→ 可补"故障率下降 40%"
- ❌ 原文"取得成果"→ 不可杜撰"节省 200 万元"；原文"反馈不错"→ 不可杜撰"满意度 92%"
- 动词有力 — 用"推进""落地""打通""提升"替代"做""进行""开展"。
- 层级清晰 — 主标题是结论/判断，副标题是补充说明，内容是支撑。
- 引用克制 — 只保留最有代表性的 1 句；同页不出现多段长引用。
Phase 2 完成后通知：规划完成，共 N 张，开始生成…
Phase 3：生成 HTML
Step 3.1：准备文件
① 复制模板
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
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 技术架构现状（序号补零到总数位数）
封面页
<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">[副标题]</>
[姓名｜角色/Title]
[日期]
内容页（白色）
<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>
章节过渡页
<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>
结尾页
<section class="slide slide-qa" id="slide-N">
<h2 class="qa-title reveal">Q&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 写入。此步骤仅处理其他外部图片遗漏的边缘情况：
python3 scripts/inline-images.py [文件名].html
Step 4.3：Smoke Test（必须执行，不得跳过）
生成完成后立即运行静态检查；失败时必须修复后重跑，不得跳过也不得仅凭”看起来没问题”省略：
./scripts/smoke-test.sh [文件名].html
执行后在回复中明确写出： smoke-test: passed（N 张幻灯片） 或 smoke-test: FAILED — [原因]。未写出视为未执行。
Step 4.4：用浏览器直接打开文件（必须执行，不得跳过）
open [文件名].html
执行后在回复中明确写出： 已用 open 打开浏览器 或 受环境限制无法打开 — [原因]。未写出视为未执行。
成功标准：浏览器直接打开本地 HTML 文件，且不依赖本地 HTTP 服务。
Step 4.5：最终交付摘要（必须输出，格式固定）
在回复的最后输出以下固定格式的摘要块，所有字段必填，缺任何一项视为未完成：
📦 交付摘要
文件路径：[绝对路径或相对路径]
文件大小：[X KB]
幻灯片数：[N] 张
主题：[theme-id]
smoke-test：通过 / 失败（[原因]）
浏览器：已打开 / 无法打开（[原因]）
导航：方向键 / 空格翻页 · 右侧圆点 · F 全屏
Phase 4 完成门槛（硬性约束）
在以下全部条件满足前，禁止输出”完成””Done””已生成”或任何等价的结束表述。
如果任一步未完成，最终答复必须改为“当前进度 + 阻塞原因”，不能伪装成完整交付。
附录 A：支持文件
附录 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
Phase 1
Phase 2
Phase 3
Phase 4
最终答复模板（必须对照）
禁止项
- ❌ 在
<section> 内写 logo 代码
- ❌
max-width 写死 px
- ❌ 直接编辑
template.html
- ❌ 编造原文无源的具体数字
- ❌ 演讲稿逐段照搬
- ❌ info-card 不加图标
- ❌ 少量卡片在全宽容器里偏左留白
非目标
- 不生成 .pptx，只输出单个 HTML
- 不自动抓取互联网内容，除非用户提供素材
- 不伪造演讲者身份、职位、部门
- 不擅自修改未被点名的现有页面
- 不保证所有品牌主题与官方品牌规范完全一致
Source: FeeiCN/slide-writer — distributed by TomeVault.
