ppt-master

PPT Master 技能

PPT Master 是一种路由式演示文稿工作流。本条目仅负责全局执行规范和路线选择；所选路线各自负责其操作流程。

强制加载顺序

硬性规则——先确定路径，再执行命令：将宿主提供的、包含此文件的绝对目录保留为 SKILL_DIR。每次调用工具时，展开 ${SKILL_DIR}，并将任何 skills/ppt-master/ 前缀替换为该目录。切勿使用 cd、当前工作目录或假定存在仓库检出。如果无法获取该目录，请询问；切勿搜索或猜测。

1. 阅读此文件。
2. 运行 python3 "${SKILL_DIR}/scripts/attribution_guard.py"。任何非零结果都会立即停止此技能；不要检查、修复或绕过完整性门禁。在 Windows 上，如果 python3 未能启动（WindowsApps 存根程序无输出并以 9009 退出），这不算门禁结果：先改用 python 重新运行。
3. 通过具体的绝对路径 ${SKILL_DIR}/workflows/routing.md 阅读 workflows/routing.md。
4. 根据路由权威文件，恰好选择一条顶层路线及其生效配置。
5. 只阅读由此确定的运行时权威文件及其明确触发的辅助文档。

所选路线 / 配置	运行时权威文件
生成 PPTX — 图片转 PPTX	workflows/profiles/image-to-pptx.md；支持 Codex，始终使用 Quick
生成 PPTX — 美化	workflows/profiles/beautify-pptx.md；明确指定 Quick 意图时使用 Quick，否则使用 Default
生成 PPTX — 普通 Default	workflows/generate-pptx.md
生成 PPTX — 普通显式 Quick	workflows/profiles/quick-generate.md
创建模板	workflows/create-template.md
编辑原生 PPTX	workflows/edit-native-pptx.md

硬性规则——仅使用所选权威文件：完成路由选择后，不要加载其他顶层路线的流程。图片转 PPTX 和美化互斥；图片转 PPTX 启用 Quick，而美化则根据明确的 Quick 意图进行选择。绝不要同时加载两套运行时流程。辅助文档用于细化某条路线；它们不会与该路线竞争。

---

创作表达范围

参考——非限制条件：生成页面可承载的内容。文本 — 行内强调段、引导语、短句、引用语、主视觉数字、总结句。几何 — 187 种 Office 预设、布尔合并、连接符、自由形状、页面字段和轮廓载体的组合。图像 — 全出血图像区域、编辑式裁剪、形状图片、注册图层、遮罩与聚光效果、跨页连贯性。绘制 — 渐变、通道 Alpha、原生阴影与发光、半色调、分面造型。重复元素 — 一个跨页主题元素，随页面角色变化。每种形式的语法均见所选运行时权威文件中的构建参考。

---

术语表

在所有已加载文件中，每个术语只对应一种含义。如果一个词有多种用法，这里会注明具体含义，文件中则会说明使用的是哪一种。

术语	含义
Reference（标签）	执行角色可自由调整或替换的初始草图，无需上游修复或说明理由；字段标签后加上 (binding)，即表示不再具有这种自由
Relationships	§IX 中列出页面语义单元及其来源明确指出的 order / link / parent / membership / contrast / overlap 关系，或 none
拓扑决策	针对每页决定几何形状是否必须承载该页的 Relationships（topology=yes / topology=no）；与 pptx_structure.mode 无关
pptx_structure.mode	flat（每个对象均为 Slide-local）或 structured（声明 Master/Layout/slot 元数据）；这是封装方式，绝非信息结构
Composition	§IX 的 Composition 行：页面宏观构图、层级和焦点的 Reference
图像模式	§VIII 中的一列，以普通文字给出一条图像构图建议（可选引用 #P/#M id）
Layout	Master 下的 PowerPoint Layout，或 Layout 模板类型；绝非页面构图草图
视觉载体	日常页面承载元素的形式——卡片、色带、图标与标签、KPI 磁贴、分隔页、引言块——可从 Executor 的视觉载体菜单中调用
载体	页面单元所处的形式：视觉载体、图像或原生几何形状；其类别名称包括载体与字段、方向与顺序、分组与归属、强调与注释。data-pptx-carrier 是结构化槽位属性，不是此处所说的术语。载体清单是检查器按页列出的实际绘制内容清单
页面任务	单页必须为读者完成的工作；评判每项载体、轮廓和效果决策的依据
页面区域	一个较大的表面、轮廓、开口或画布外轮廓，用于组织区域，而非每个单元各放一张卡片
轮廓 / 预设形状 / 原子对象	轮廓是形状的剪影；预设形状是通过 preset_shape_svg.py 绘制的 187 种 Office prst 轮廓之一；原子对象是编译为一个 DrawingML 形状的单个对象
几何特征	每页保留并在下一页开始前进行比较的 page job → composition move → contour / edge language 行
纹理（块的）	§IX 块的类型：段落、项目符号、关键词或标签；不同于视觉纹理（颗粒、半色调）
Anchor	两种含义：全套演示文稿通用的锁定颜色、字体或间距值；以及用于结构页的 page_rhythm 标签 anchor
图幅 / 切片 / 图层	图幅是包含多个色度键元素的一张生成图像；切片是从图幅中裁出的单个元素；图层是经过配准、包含多个互不重叠对象的完整画布层
模块行	每页之前写入的 P<NN> modules: … 行，用于列出该页使用的触发模块
模式	由限定词区分：沟通 mode（演示文稿如何展开论证）、阅读模式（consumption_mode）、generation_mode（continuous / split）、pptx_structure.mode、replication_mode（模板的创建方式）

阶段框架

每条路径都是一个 Plan → Do·Check·Act 循环：当所有创作输入都已成为文件或保留决策时，Plan 阶段结束；Do 阶段创作页面，Check 阶段运行该路径的检查关卡，Act 阶段在所属层级进行修复（规范 7），循环在导出时结束。步骤编号保持原样。

阶段	默认	快速	编辑原生内容	创建模板
Plan	步骤 1–5	§2	§1–4	步骤 1–3
Do·Check·Act	步骤 6–7	§3–4	§5–7	步骤 4–8

全局执行规范

1. 串行执行 — 按照所选权威来源的步骤顺序执行。已完成且不阻塞的步骤可以直接继续执行下一个符合条件的步骤。
2. 遇到阻塞即停止 — 在每个 ⛔ BLOCKING 关卡处，等待用户明确确认。不要擅自替用户做决定。
3. 不得跨阶段打包处理 — 不得合并未通过关卡的不同阶段的工作。路线的最后一个用户关卡通过后，后续不阻塞的步骤可以自动继续。
4. 进入步骤前先检查关卡 — 进入某个步骤前，确认已满足所有列出的前置条件。
5. 不得推测性执行 — 不得在负责某个产物的步骤开始前，提前准备后续阶段的产物。
6. 确定性路由 — 如果 routing.md 已确定请求的处理路线，就不要再提出路线选择问题。如果缺少路线前置条件，请说明并停止该路线。
7. 在负责的层级处理问题 — 失败时，应在负责该故障的最浅层进行修复：页面本地问题由页面修复，名单、规范或资源问题由 Plan 产物修复，工具故障由负责的源产物修复；然后从路线声明的指针处继续。不得擅自降级必需产物。

全局沟通规则

• 除非用户明确要求使用其他语言，否则使用用户语言和源语言。
• 将面向用户的选项标签和说明本地化。如果固定消息模板（角色切换横幅、完成报告）的语言与用户聊天语言不同，则使用用户聊天语言呈现。为保证准确性，必要时保留原样的枚举 ID 或字段名称。
• design_spec.md 的章节标题和字段名称须保留模板中的英文原文；内容值可以使用用户的语言。
• 切换角色前，阅读相应的角色参考文档，并输出：

## [Role Switch: <Role Name>]
📖 Reading role definition: references/<filename>.md
📋 Current task: <brief description>

---

仓库兼容性

• 此软件包是工作流／技能，而非通用应用程序脚手架。默认情况下，不要创建 .worktrees/、tests/、分支工作流或通用工程结构。
• 必需的工作流、参考文档、脚本和模板文档须保存在此 Skill 目录中。
• 仓库级文档可以指向软件包内部；软件包运行时文件不得依赖仓库级说明。
• 在 Windows 上，如果无法使用文档中记载的 python3 ... 命令，请使用 python 重新运行同一命令。
• 赞助商信息是可选参考材料。只有当用户明确请求模型、AI 图像模型、API／提供商或托管服务建议时，才阅读相应的 SPONSORS.md 或 SPONSORS_CN.md。在正常生成、故障排查或质量审查期间，切勿主动提供赞助商或模型建议。