oil-oil oil-ppt
oil-ppt 只维护一条创作路径：弱模型从 starter 和组件开始，强模型可以继续修改单页 DOM 与局部 CSS。每次只创作或修复一张真实页面；程序负责状态、检查和交付，不覆盖已经写好的页面。
开始前
将下列 CLI 解析为相对本 SKILL.md 的绝对路径，后续命令都使用同一个路径：
scripts/oil-ppt
创建或改写标题、正文、图注和结尾时，同时使用 oil-tone。oil-tone 是事实边界、叙述身份、用词、句子和结尾的唯一文案规范；oil-ppt 只负责演示叙事、跨页拆合、页面容量、素材角色和版面表达。拆页或压缩只能删除冗余，不能删除材料中的事实、原因、影响或处理步骤。
页面事实来源固定为：
slides/<id>.html：单页文案、DOM、局部 CSS 和素材。deck.json：页面顺序和全局主题。outline.md：创作参考，不是页面合同。
不要直接修改 预览.html 或 演示文稿.html，不要替用户确认。
最短执行路径
新建演示
- 用户没有给出材料或方向时询问：“先一起梳理创作大纲，还是根据现有材料直接整理第一版参考？”已经有答案时不重复询问。
- 初始化并立即读取状态：
scripts/oil-ppt init <项目>
scripts/oil-ppt status <项目> --json
- 只处理返回的顶层
next。完成该动作后执行其中的rerun、command_on_confirm、command_when_ready或command，再读取新的状态。
续做或修改现有演示
先检查用户明确指定的项目或父目录：
scripts/oil-ppt batch <项目或父目录> [更多项目或父目录]
然后对要处理的单个项目运行：
scripts/oil-ppt status <项目> --json
用户指定某页时使用：
scripts/oil-ppt status <项目> --json --intent edit --slide <页码或ID>
只编辑返回的 next.path，完成后执行 next.rerun。修改可见文案时使用 oil-tone；只修布局、样式或媒体时不需要改写文案。
只执行 next
next.action 是以下封闭集合：
ask_user_to_confirm_outline：展示next.artifact并停止。用户确认后原样执行next.command_on_confirm；用户要求修改时运行status <项目> --json --intent edit，只编辑返回的next.path，再执行next.rerun。ask_user_to_confirm_preview：展示next.artifact并停止。用户确认后原样执行next.command_on_confirm；用户提出页面反馈时使用status <项目> --json --intent edit --slide <页码或ID>。author_slides：依据next.brief逐页创作或调整。每次只读写一张slides/*.html；完成一张后重新运行status。complete：停止，演示已经完成。edit_outline：只编辑next.path，完成后执行next.rerun。edit_slide：只编辑next.path，依据next.issues修复真实 HTML，完成后执行next.rerun。fix_media：只处理next.path、next.issues和项目内相关素材，完成后执行next.rerun。run_command：原样执行next.command。
不要凭记忆拼接状态机内部命令，不跳过确认，不同时处理两个 next。
author_slides 的逐页循环
第一次进入 author_slides 时完整读取 references/components.md。它是视觉层级、版式节奏、构图家族、网格、字号、纵向占满、分栏、表面纹理和媒体组件的唯一设计规范；主 Skill 不重复这些数值和 API。
查看 24 个真实独立 starter 的紧凑目录，只在当前页面需要时读取一个具体 starter：
scripts/oil-ppt starter list --json
scripts/oil-ppt starter show <名称>
scripts/oil-ppt starter catalog [--output <离线HTML路径>]
写页面前先写清四件事：本页展示的具体对象；观众看完要记住的事实或关系；哪张图、哪个数字、哪段引文或哪组步骤能够直接说明它；材料没有提供什么。最后一项不能自行补全。
介绍产品或流程时，再补充三个答案：观众在哪里看到它；观众或系统执行什么动作；结果出现在哪里。材料只提供内部名称时，按照含义改写：
内部界面标识 → 观众看到的位置名称
工具或函数名称 → 实际执行的动作
配置字段或文件路径 → 设置用途或产物名称
页面专门解释接口、代码或文件结构时可以保留原始名称。其他页面把这些内容放到附录、来源或讲者备注。
不要使用只表达好坏、范围或价值的概括。这些句子没有提供可以展示的事实。改成包含具体对象和变化的句子：
[对象] 在 [位置] 显示 [内容]
[角色] 执行 [动作] 后，[文件或状态] 发生变化
[指标] 从 [数值] 变为 [数值]
写清这些内容后，用一句话确定页面判断，再选择 starter：聚焦、比较、顺序、汇聚、关系、证据或数据。这句话用于指导构图，不要求原样写进标题；证据页和界面展示页优先使用简短、平铺直叙的内容标签。优先按照 next.slide_add_usage 创建页面；完整语法是：
scripts/oil-ppt slide add <项目> <页面ID> --title "<标题>" [--starter <名称>] [--after <页面ID>]
页面ID 只使用小写字母、数字和连字符。命令会返回真实页面路径；只编辑该文件。需要调整页面时使用：
scripts/oil-ppt slide duplicate <项目> <原页面ID> <新页面ID> [--title "<标题>"]
scripts/oil-ppt slide move <项目> <页面ID> --to <位置>
scripts/oil-ppt slide remove <项目> <页面ID>
完成一张页面必须同时满足：
- 已处理 starter 的示例文案、数值、来源和占位视觉：需要的内容替换，不需要的可选元素直接删除；不要为了填满模板保留说明段。
- 页面只有一个主要判断，构图服务该判断，而不是先生成卡片再填内容。
- 标题、引导段、图注和主视觉不重复表达同一件事；媒体已经说明清楚时，页面只保留短标题和必要标注。
- 必要术语第一次出现时已经说明实际用途；普通介绍页没有把内部名称直接当成功能名称。
- 页面没有停留在抽象概括；已经写清具体对象、动作、数字、文件或状态。
- 真实截图、数据、引文和界面保持保真；概念视觉不能伪装成事实证据。
- 页面不依赖自定义 JavaScript、远程资源、绝对本地路径或跨页全局 CSS。
- 运行
status后没有该页的阻塞问题。
完成当前页后重新运行 status。如果仍返回 author_slides，继续下一张真实页面或调整叙事；不要一次生成全部页面再统一修复。
进入正式预览的条件
只有同时满足以下条件，才执行 next.command_when_ready：
- 核心判断、必要原因、影响、过程和证据已经在整套页面中完整覆盖。
- 所有计划中的页面都已创建或明确删除，没有示例内容、虚构来源或占位视觉。
- 每页只有一个主要判断，所有阻塞问题已经修复。
- 正常 8–10 页至少使用 4 类构图，缩略轮廓没有连续重复同一种等权卡片墙。
- 已逐条处理
style_advice：修复不需要的模式；有意保留时记录原因。 - 逐页检查带点号、下划线、路径或命令格式的词；除非本页专门讲实现，否则改成观众能识别的位置、动作、用途或产物。
正式预览读取真实页面，不重新生成页面。用户确认后继续处理状态机返回的动作，直到 complete。
质量门禁
以下问题会阻塞预览或构建：HTML 结构损坏、路径越界、远程资源、自定义脚本、跨页 CSS 污染、素材损坏、文字溢出、内容越界、页面滚动、字号低于门槛，以及可确定纯色背景上的文字对比度不足。
只有短编号或辅助元数据的文字元素自身可以使用 data-microcopy="index" 或 data-microcopy="meta"。可见文字使用真实换行；只有确实讲解转义字符时才使用 data-literal-escape="true"。
style_advice 是必须判断的非阻塞设计提醒，不自动决定页面修改。详细设计规范以 references/components.md 为准。
参考资料路由
- 视觉层级、版式节奏、构图家族、网格、字号、组件、表面纹理和媒体框架：
references/components.md - 外部素材选择：
references/media.md - 概念插画：
references/illustration.md - HTML/CSS/SVG 流程、关系、UI 和图表：
references/programmatic-visuals.md - 构建或导出故障：
references/troubleshooting.md - 修改本 Skill 的程序、组件或设计系统：
references/evolution.md
只读取当前任务需要的参考资料。
主题与交付
全局配色、字体和圆角通过主题命令调整，不逐页复制主题色：
scripts/oil-ppt theme list --json
scripts/oil-ppt theme catalog [--output <离线HTML路径>]
scripts/oil-ppt theme set <项目> --direction <方向> [--palette <名称>] [--typography <名称>] [--shape <名称>]
最终 HTML 固定为项目根目录的 演示文稿.html。只有用户明确需要 PowerPoint，并且正式预览已经确认后，才运行：
scripts/oil-ppt export-pptx <项目>
HTML 是规范成品；PPTX 是混合可编辑交付物。pptx-editability.json 必须逐页说明原生文字、原生媒体、栅格背景和不支持结构。