用途
scene-ppt 用于把一篇文章或一个主题做成「场景化讲解 PPT」。这里的 PPT 指的是一页一张 16:9 的图片，不是 .pptx 文件，因此图上的字不能再编辑。当用户说「做成 PPT」「出一套讲解幻灯片」「用 PPT 讲……」时触发。
它采用「一套 PPT 只用一个世界讲完」的思路，也就是换世界而不是换皮。世界里的角色对应要讲的对象，世界里的器物对应概念。以讲 Skill 为例：
- 后厨世界：AI 是新来的学徒，Prompt 是主厨一口气的口头交代，Skill 是一本菜谱加分格备料架。
- 中药铺世界：AI 是新来的小伙计，Prompt 是把药材一股脑倒进一锅，Skill 是一张方子加百子柜。
世界定了，每页的场景从这个世界里自然长出来（前台、后厨、备料间、试菜等），页与页自然不同。
主要能力
- 自带出图脚本和用得到的风格卡，不需要另装别的 skill。
- 内置多个可选世界：classroom 小课堂、kitchen 后厨、rpg RPG 技能书、island 像素小岛、retro 50 年代复古广告、pharmacy 中药铺、captain 机长检查单、bricks 积木说明书、studio 剧组片场、library 森林图书馆、pitstop 赛车维修站。
- 支持默认世界设置：有默认时直接使用并告知用户可更换；没有默认（第一次用）时先自检，再打开世界选择页让用户看样张挑选。用户点名某个世界则不开选择页，直接设置。
- 小课堂世界需要角色档：包含角色ID、角色图（--ref）、中文名、中文外貌短语、英文名/物种/英文外貌、系列名等字段。若没有角色，可从漫画小课堂导入，或用用户提供的 IP 图添加，也可先用漫画小课堂生成。
- 数据存放在 ~/.scene-ppt/，升级 skill 不会覆盖；家目录写不进时（Codex 沙盒）自动存到当前项目的 .scene-ppt/，也可用环境变量 SCENE_PPT_HOME 指定。
使用方式
流程分为五步：
- 读物料：提炼要讲的概念（通常 6–15 个），每个标类型（对比 / 流程 / 分层结构 / 误用反例 / 版本迭代 / 本质结论），数字和事实只用原文，产出概念清单。
- 映射 + 大纲（用户拍板一次）：按默认世界写映射表，再按大纲模板写 outline.md，包含封面、目录（6 页以内可省）/ 章节、内容页、结尾，每页写页型、场景一句话、文字清单；同一种场景结构不连续用两次。
- 写每页：按单页模板和当前世界示例写 adapt/<图号>-<风格>.txt，文件必须有【画面与版式】和【必须逐字放入的文字（唯一真值）】两段。
- 出图：运行检查、出图、对比页脚本。第一次用或刚换世界时先出封面加 1 页内容给用户看，用户说可以后再出整套。
- 检查：逐页看图，有问题只改一处重出。
用户说「直接做」「你定」时进入快速模式，跳过第 2 步的拍板直接出图。
常用命令（S 指本 skill 的脚本目录）：
python3 $S/check_prompts.py <任务目录> # 检查：「」只留给要画的字、写了主体占比
python3 $S/render_codex.py <任务目录> --only 01- # 第一次 / 换世界：先出封面
python3 $S/render_codex.py <任务目录> --batch 6 --parallel 4 # 出剩下的 + 核对提示词是否逐字
python3 $S/make_page.py <任务目录> --title "标题" # 对比页
改了某页的 adapt/ 文件，直接重跑 render_codex.py：提示词变了的页，旧图自动移到 _v1/ 再重出。每次出完自动重建 发布/ 目录，文件名序号对应页序（第 3 页就是 03.png，还没出的页留空号）。默认使用 Codex 自己配置的模型，可用 --model / --effort 指定。
每页写作有几条铁律：第一句写明 16:9 横版与页型；标题载体全套统一；每页 1 个标题加 2–9 处短文字，标题不超过 20 字，每条不超过 22 字；文字放在世界原生的载体上；写主体占比；原文没有的效果、数字、结论一个字都不加；角色外貌写细以保证跨页一致。
适用场景
需要把文章、主题或概念讲清楚、且希望以图像化场景呈现的讲解型幻灯片。适合概念数量适中（通常 6–15 个）、可以用一个贯穿设定来类比的题材。
限制
- 产物是图片而非 .pptx，图上的文字不可再编辑。
- 出图交给 Codex 内置 imagegen 按提示词原样生成，不改写；但图上的字是否画对仍需人工逐页核对。
- 脚本报的「提示词逐字」只说明 imagegen 收到的提示词没被改写，不代表图上文字正确。
- 用户自行运行本 skill 时不调用 render_codex.py（会再起一个 Codex），需改为跑 check_prompts.py、build_prompts.py，对 prompts/ 每个文件调内置 imagegen，再跑 verify_log.py 和 make_page.py。
- 小课堂世界需要角色档，没有角色会报错。
- 收费、价格等信息暂未提供。