ppt-master

PPT Master Skill

基于 AI 驱动的多格式 SVG 内容生成系统。通过多角色协作将源文档转换为高质量 SVG 页面，并导出为 PPTX。

核心流水线：源文档 → 创建项目 → [模板] → Strategist 决策者结构化规划 → [Image_Generator] → Executor 执行器实时预览 → 质量检查 → 后处理 → 导出

SVG 页面设计边界

适用范围	约定约束
所有通过 SVG 编写或重新生成幻灯片视觉效果的路由流程	`svg_output/` 是完整页面设计的唯一源码：最终导出幻灯片上包含的全部可见文本、图片、形状、图表/表格降级回退元素及布局元素，都必须存在于该页面的 SVG 中，或被其明确引用。
模板、`design_spec.md` 与 `spec_lock.md`	属于创作控制输入项。它们用于指导 SVG 生成，但绝对不可在导出时提供任何未包含在已完成 SVG 中的可见幻灯片内容。
语义化 SVG 标记	仅在综合考量现有 Layout/Layer/Placeholder/Native 元数据后才使用的渲染中立型编译器轻量提示符。它们绝不会替换原生 SVG 几何形状、文本、样式、分组或资源引用。
`svg_final/`	强制生成的衍生自包含 SVG 视觉预览文件。可直接打开或作为 SVG 图片插入 PowerPoint，但它并非支持的 PPTX 提取数据源，且不保证手动“转换为形状”的兼容性。
SVG 到 PPTX 导出	唯一支持的 PPTX 生成路径：读取 `svg_output/` 并通过项目转换器将其内容映射为 DrawingML/原生对象。转换过程可将呈现内容重构为 Master/Layout/Slide 结构，但绝对不可凭空捏造新的可见页面内容。
原生 PPTX 编排与演示行为工作流	保持独立隔离。`template-fill-pptx`、`native-enhance-pptx`、动画、切换效果、演讲者备注、旁白及包间关联关系均无需经由 SVG 进行双向转换。

必须遵循 — 页面设计闭包规则：对于 SVG 创作路由，必须通过检查最终生成的页面 SVG 来确定导出幻灯片的外观。切勿将“SVG 是页面设计描述语言”误读为“SVG 是完整的 PPTX 文件包描述语言”。

[!CAUTION]

🚨 全局执行纪律（硬性强制）

本工作流为严格的串行流水线。以下规则具备最高优先级——违反其中任何一条即视为执行失败：

严格串行执行 — 各步骤必须按顺序执行，上一步骤的输出即为下一步骤的输入。满足前提条件后，非卡点（非 ⛔ BLOCKING）的相邻步骤可连续推进，无需等待用户发送“继续”

卡点强制停顿 — 标记为 ⛔ BLOCKING 的步骤要求绝对停顿；AI 必须等待用户明确回复后方可继续，严禁擅自替用户做决定

禁止跨阶段打包 — 严禁跨阶段合并合并执行。（注：步骤 4 中的 Strategist 决策者确认阶段为 ⛔ BLOCKING — AI 必须展示建议并等待用户明确确认后方可继续。一旦用户确认，后续所有非卡点步骤——设计规范输出、SVG 生成、演讲者备注及后处理——均可自动连续推进，无需再次等待用户确认）

前置门槛校验 — 每一个步骤顶部均列有前提条件（🚧 GATE）；在启动该步骤前必须完成校验

严禁推测性预先执行 — 严禁为后续步骤“预先准备”内容（例如：在 Strategist 决策阶段编写 SVG 代码）

禁止子 Agent 生成 SVG — Executor 执行器步骤 6 的 SVG 生成强依赖上下文，必须由当前主 Agent 一气呵成独立完成。严禁将页面 SVG 生成工作下发分包给子 Agent

仅限单页顺序生成 — 在 Executor 步骤 6 中，确认全局设计上下文后，必须逐页连续生成 SVG 页面。严禁按批次分组生成（例如一次生成 5 页）

每页生成前重读 SPEC_LOCK — 在生成每一页 SVG 之前，Executor 必须调用 read_file <project_path>/spec_lock.md。所有配色/字体/图标/图片资源必须严格取自该文件，绝不能凭记忆或临时捏造。Executor 还必须读取 pptx_structure.mode、当前页面的 page_rhythm（anchor 锚点 / dense 密集 / breathing 呼吸感）以及 page_charts。只有演示文稿/布局模板路由（mode: structured）才会查找 page_layouts（输入模板 SVG）、page_pptx_layouts（页面分配）、pptx_masters、pptx_layouts（唯一可复用名册）和 template_adherence；自由设计与仅品牌路由使用 mode: flat 并忽略这些章节。本规则旨在防止长 PPT 制作过程中的上下文压缩漂移，打破“页页都是卡片网格”的呆板套路

SVG 必须手写，严禁脚本批量生成 — 每一页 SVG 都由主 Agent 亲自直接编写，一次一页（参见规则 6 和 7）。严禁编写或运行 Python / Node / Shell 脚本来批量生成 SVG 文件——无论是循环遍历页面、通过数据套用模板，还是调用生成器统一输出，即使打着“节省 Token”、“快速草稿”或“用户赶时间”的旗号也绝不允许。脚本生成路径曾试图在特性分支中尝试但已被废弃：跨页面视觉一致性极度依赖带有完整上游上下文的单页创作，这是生成器脚本无法复现的。极窄例外情况：在主 Agent 选定其语义角色、外框和绘制样式后，preset_shape_svg.py 可向 stdout 输出一个确定性的 PowerPoint 原生预置形状片段。该脚本不得写入 svg_output/、不得挑选布局、不得批量处理形状或生成页面；主 Agent 读取该片段并通过正常手写页面方式插入

遵循确定性路由规则 — 当本 Skill 已明确路由时，切勿添加阻塞性的路由询问。若用户请求违反了路由前提，请直接指出所需的前置条件并停止该路由，而不是让用户繞过规则做选择。普通的有限选项、风格偏好和可恢复细节，应在下一个既有的确认卡点展示，并附上推荐值和替代方案。

[!IMPORTANT]

🌐 语言与沟通规范

回复语言：匹配用户的输入语言和源文档语言。用户有明确指定时（如“请用英文回答”）优先遵从。

面向用户的选项标签：在展示确认信息、简短提案、选项或有限选项集时，标签与说明文字必须使用用户的语言。为了精确表达，可在括号内附带英文枚举 ID 或文件字段名，但决不能直接使用未经本地化解释的纯英文标签（如 deck、layout、mirror 或 fidelity）。

模板格式：无论对话使用何种语言，design_spec.md 必须保持其原本的英文模板结构（章节标题、字段名称）。具体填入的内容值可以使用用户的语言。

[!IMPORTANT]

🔌 与通用代码类 Skill 的兼容性

ppt-master 是针对特定仓库的工作流，而非通用的应用程序脚手架

默认不要创建 .worktrees/、tests/、分支工作流或通用的工程化项目结构

若与通用代码类 Skill 发生冲突，除非用户另有明确要求，否则一律优先遵循本 Skill

规则强度标签

标签	含义
`MUST`	强制要求；违反即视为工作流执行失败
`MUST NOT`	严禁行为
`DEFAULT`	用户未指定时的默认行为
`OPTIONAL`	仅在被明确触发或路由要求时执行
`FALLBACK`	主路径失败后的兜底恢复路径
`GATE`	进入下一步骤前必须通过的检查卡点

横切关注点归属权

关注领域	权威规范文件	职责约定
主流水线执行顺序	本 `SKILL.md`	管辖 Step 1-7 顺序、门槛检查、角色切换及强制命令
路由选择	`workflows/routing.md`	管辖主流水线或独立工作流启动前的确定性路由抉择
工作流注册表	`workflows/index.md`	管辖独立工作流的触发条件、前置条件与产物清单
交付物归属	`references/artifact-ownership.md`	管辖事实通道、源/衍生交付物边界及重新生成规则
故障恢复	`workflows/failure-recovery.md`	管辖常见故障时的停顿/继续决策
确认 UI 细节	`scripts/docs/confirm_ui.md`	管辖 Schema 模式、启动器行为、端口策略及聊天备用逻辑

主流水线脚本

脚本	用途
`${SKILL_DIR}/scripts/source_to_md.py`	统一源文件转 Markdown 分发器 — 明确指定文件或 URL 时的 Step 1 默认入口
`${SKILL_DIR}/scripts/pptx_intake.py`	标准 PPTX 解析增强 — 画布 / 标识 / 幻灯片几何构型 / 表格 / 原生图表数据 / SmartArt 结构
`${SKILL_DIR}/scripts/project_manager.py`	项目初始化 / 校验 / 管理
`${SKILL_DIR}/scripts/icon_sync.py`	选中图标时将其从库复制到 `<project>/icons/`；若图标缺失则报错并返回非零状态（重新挑选卡点）
`${SKILL_DIR}/scripts/analyze_images.py`	图片分析
`${SKILL_DIR}/scripts/latex_render.py`	LaTeX 公式渲染（清单驱动的 PNG 资源生成）
`${SKILL_DIR}/scripts/image_gen.py`	AI 绘图生成（支持多服务商）
`${SKILL_DIR}/scripts/slice_images.py`	将一张 AI 合成插图大图切片拆分为独立的点缀插图元素
`${SKILL_DIR}/scripts/svg_authoring_view.py`	为导入的 PPTX SVG 创建轻量无损的检查投影视图；绝不可作为发布源
`${SKILL_DIR}/scripts/svg_quality_checker.py`	SVG 质量检查
`${SKILL_DIR}/scripts/preset_shape_svg.py`	向 stdout 输出一个注册表支持的 PowerPoint 原生预置形状片段，供手写 SVG 插入
`${SKILL_DIR}/scripts/total_md_split.py`	演讲者备注拆分
`${SKILL_DIR}/scripts/finalize_svg.py`	SVG 后处理（统一入口）
`${SKILL_DIR}/scripts/svg_to_pptx.py`	导出为 PPTX
`${SKILL_DIR}/scripts/native_enhance_pptx.py`	现有 PPTX 增强项目的初始化 / 校验 / OOXML 直接补丁导出
`${SKILL_DIR}/scripts/native_narration_pptx.py`	现有 PPTX 备注/旁白增强的向下兼容入口
`${SKILL_DIR}/scripts/update_spec.py`	将 `spec_lock.md` 中修改的颜色/字体族同步应用到所有已生成的 SVG

完整工具文档请参见 ${SKILL_DIR}/scripts/README.md。

Windows 系统提示：若 python3 ... 命令执行失败（常见于从 python.org 安装的环境，仅提供 python.exe 而无 python3.exe），请使用 python 替换 python3 重新运行该命令。

模板索引

索引名称	路径	用途
页面布局模板	`${SKILL_DIR}/templates/layouts/layouts_index.json`	查询可用的页面布局模板
品牌预设	`${SKILL_DIR}/templates/brands/brands_index.json`	查询可用的品牌视觉预设（配色 / 版式 / Logo / 调性）
视觉化模板	`${SKILL_DIR}/templates/charts/charts_index.json`	查询可用的视觉化 SVG 模板（图表、信息图、示意图、框架图）
图标库	`${SKILL_DIR}/templates/icons/`	详见 `${SKILL_DIR}/templates/icons/README.md`；可通过 `ls templates/icons/<library>/ \| grep <keyword>` 按需搜索图标

独立工作流

路由选择权威: 参阅 [`workflows/

你可能还喜欢

gifgrep

386Kresearch-knowledge

Search GIF providers with CLI/TUI, download results, and extract stills/sheets.

openclaw

获取

blucli

385Kresearch-knowledge

BluOS 命令行工具（blu），用于设备发现、播放控制、多房分组与音量调节。

steipete

获取

orch-pipeline

240Kresearch-knowledge

Shared orchestration engine for the orch-* skill family. Defines the gated Research-Plan-TDD-Review-Commit pipeline, the size classifier, the agent map, and the two human gates that the orch-* operation skills delegate to. Not usually invoked directly. Not usually invoked directly; it applies when an orch-* skill delegates its gated Research-Plan-TDD-Review-Commit pipeline.