aliang-ppt-skill

name	aliang-ppt-skill
description	阿亮 PPT 生成器。内容引擎驱动的 HTML 演示文稿：先提炼核心论点、选叙事骨架、One-Message 大纲确认后才生成；8 套锁死美学模板看图选型、交付自带调色+密度面板、生成后 Puppeteer 自动渲染自检。当用户要做 PPT、幻灯片、演示文稿、路演材料、分享材料、课件时使用。

aliang-ppt-skill

核心信念：好 PPT 的本质是好内容被正确切分。先内容，后视觉。 四个差异点：① 内容引擎（先论点后排版）② 机器自检（不靠肉眼） ③ 交付后可调（调色+密度面板）④ 锁死美学（8 套模板禁改色，不翻车）。 大纲未经用户确认，绝不进入生成阶段。

文件地图

文件	用途	何时读
references/content-engine.md	内容引擎：提问→消化→骨架→大纲→文案→逐字稿全部规则	每次必读，先读它
references/templates.md	模板索引：选型表 + 8 套一览 + 节奏规则	阶段 2 读
references/contract.md	模板契约：变量/八件套/密度/禁忌（造新模板照它做）	新增模板时读
templates/01…08-*.html	8 套模板参考稿（单一真相源：配方注释+骨架+示意内容）	只读选中的那一套
assets/deck-stage.js	共享翻页引擎（缩放/缩略图栏/键盘导航/打印PDF）	不读，生成时复制
assets/tweaks-panel.html	调色+密度面板组件	不读，生成时注入

---

总流程

阶段 0   入口判断（新建 / 转换 / 增强）
阶段 1   内容引擎（见 content-engine.md，大纲确认是硬门槛）
阶段 2   模板选型（推荐 2-3 套 + 截图看图选）
阶段 3   生成 deck（复制模板骨架，替换全部示意内容）
阶段 3.5 注入调色+密度面板 / 复制 deck-stage.js
阶段 4   渲染自检（Puppeteer 自动，不通过不交付）
阶段 5   可选配图（百炼 API，明确告知收费，绝不默认开启）
阶段 6   交付（浏览器打开 + 操作说明 + 可选导出）

阶段 0：入口判断

用户输入	模式	动作
提供 .pptx 文件	转换	按 content-engine.md 第七步提取内容，照常过内容引擎
提供文章/笔记/大纲	精炼	先完整读素材，进内容引擎第二步（素材消化）
只有一个想法/话题	创作	进内容引擎第一步（意图收集）
指向已生成的 deck 要改	增强	读现有文件改动，仍受密度上限约束，超限拆页并告知

阶段 1：内容引擎

完整规则在 references/content-engine.md，必须先读再执行。 硬约束：

1. 先读素材再提问，素材能回答的不许问；提问一轮问完（AskUserQuestion 单次调用）
2. 提炼核心论点：一句话说清"观众必须记住的那件事"
3. 叙事骨架五选一（钩子式/SCQA/黄金圈/对比式/清单式），按场合推荐并说明理由
4. 每页先写 message，message 写不出的页删掉
5. 骨架页规则：封面必有；≥7 页必有目录；有目录必有章节页且编号三处一致；尾页禁止只写"谢谢"
6. 大纲展示给用户确认后，才能进入阶段 2
7. 演讲场景逐字稿与内容同步生成，写入 <aside class="notes">
8. 禁止虚构数据；缺证据的论点明确告知用户

阶段 2：模板选型（看图选）

1. 读 references/templates.md，按内容特征推荐 2-3 套候选，说明推荐理由
2. 看图选：起本地服务器（见阶段 4 的服务器命令），Puppeteer 打开每套候选 goTo(0) 截首页图展示给用户 —— 人对视觉的反应比对形容词准确
3. 用户选定后，只读选中的那一个 templates/NN-*.html： 头部注释是配方（锁死色/字体/八件套类名/特有的坑），正文是可直接复用的骨架与版式

阶段 3：生成 deck

方式：复制选中模板的骨架与版式块，替换全部示意内容。 不从零写样式。

• 输出 = 输出目录下两个文件：{主题}-slides.html + deck-stage.js（从 assets/ 复制）
• <style> 整块原样保留（锁死美学）；幻灯片按大纲从八件套取用， 同类页复制多份换内容（3 个章节 = section 版式 × 3）
• 示意内容必须全部替换，咖啡课的字一个不留
• 密度上限见 contract.md 第 4 节，超限拆页；同一版式不连续出现 2 次以上
• 深浅页节奏照 templates.md"深浅页节奏"一节
• 标题/正文文案规则、反 AI 腔清单照 content-engine.md 第五步
• 图片用相对路径；概念图示用 CSS/SVG 画

生成时的高频陷阱（实测踩过的坑）

1. <section> 上禁写 position/inset/宽高 —— deck-stage 自己管定位，写了会翻页空白
2. 大字多行层叠 line-height ≥ 0.98，低于 0.9 实色行与描边行糊成一团
3. 大号中文句号在部分字体栈渲染异常，标题结尾慎用
4. 背景装饰层（网格/辉光）选择器保持原样的具体度，别简化（会被通用规则挤掉 absolute）
5. 任何颜色走 var()，不写死 hex —— 否则面板调色时该元素不联动

阶段 3.5：注入面板

1. 把 assets/tweaks-panel.html 整段（<style>+按钮+面板+<script>）原样粘到 生成文件 </body> 之前，无需改动——面板自动读取模板默认色
2. 面板功能：主色（6 预设+拾色）/ 背景色（6 预设+拾色，文字按明暗自动黑白翻转）/ 密度（简洁 1.15 · 标准 1 · 满格 0.8）
3. 模板已全部遵守 contract.md 变量契约，面板开箱即用； 失效征兆＝调主色某元素不变色（写死了 hex）→ 回阶段 3 改成 var()

阶段 4：渲染自检（自动执行，不通过不交付）

# 服务器（deck-stage.js 走 script src，必须 HTTP，不能 file://）
python3 -m http.server 4311 --directory <输出目录的绝对路径>

Puppeteer 打开 http://localhost:4311/{文件名}.html 后执行：

(function(){
  var ds=document.querySelector('deck-stage');
  if(!ds) return 'FAIL: no deck-stage';
  var secs=[...ds.children], issues=[];
  secs.forEach(function(s,i){
    var f=s.querySelector('.frame');
    if(!f){issues.push((i+1)+':no-frame');return;}
    if(f.scrollHeight>f.clientHeight+2)issues.push((i+1)+':v-overflow');
    if(f.scrollWidth>f.clientWidth+2)issues.push((i+1)+':h-overflow');
    if(s.textContent.trim().length===0)issues.push((i+1)+':empty');  // 注意用 textContent，
  });                                  // innerText 对隐藏页恒为空，会全是误报
  var cs=getComputedStyle(secs[0]);
  return JSON.stringify({:secs.,
    :cs.().(),   
    :cs.().(),
    :issues.?:});
})();

任何 issue → 回阶段 3 修复重测。通过后 goTo(0)、goTo(1) 截图肉眼复核 （文字重叠/贴边/对比度），再用 goTo(n) 抽查 1-2 个内容密集页。

内容自检（同时执行）

• 每页 message 连读通顺，故事线成立
• 反 AI 腔通过（content-engine.md 5.3 禁用词清单）
• 标题无连续雷同句式；数据均有来源，无虚构
• 示意内容零残留（搜"咖啡"应无结果，除非主题真是咖啡）
• 逐字稿（如有）每页 150-300 字、口语化
• 目录编号 = 章节页编号 = 页眉标记

阶段 5：可选配图（百炼）

deck 已生成、自检通过后才询问（一次性、可拒绝）：

需要 AI 生成配图吗？使用阿里百炼 API，按张计费。也可以跳过，图片位保持占位样式。

同意后：检查 bl CLI 可用性（参考 bailian-cli skill）→ 按每页 message + 模板气质写 prompt（全 deck 统一艺术风格）→ 存 assets/ 相对路径引用 → 重跑阶段 4。

阶段 6：交付

1. open http://localhost:4311/{文件名}.html 浏览器打开（强调：发给别人时两个文件一起发）
2. 告知操作：←/→/空格翻页、左侧缩略图跳页与拖拽重排、R 回首页、 右上"🎨 调色"自调主色/背景/密度、浏览器打印即可存 PDF
3. 报告：页数、模板、文件位置、（如有）逐字稿和配图情况
4. 可选项（不替用户决定）：导出 PDF（打印或 Playwright）/ npx vercel 部署分享 / 改内容走增强模式

---

红线（任何阶段不可违反）

1. 大纲未确认不生成
2. 不虚构数据、不编造引用
3. 模板配色锁死：生成时不改模板的颜色变量值（交付后用户用面板自调是另一回事）
4. 配图不默认开启（收费项必须用户点头）
5. 渲染自检不通过不交付
6. 页内永不滚动，超限内容拆页解决
7. 讲者提示文字永不出现在可见页面上（只进 .notes）
8. 示意内容零残留