ppt-agent
Verified专业 PPT 演示文稿全流程 AI 生成助手。模拟顶级 PPT 设计公司的完整工作流(需求调研 -> 资料搜集 -> 大纲策划 -> 策划稿 -> 设计稿),输出高质量 HTML 格式演示文稿。当用户提到制作 PPT、做演示文稿、做 slides、做幻灯片、做汇报材料、做培训课件、做路演 deck、做产品介绍页面时触发此技能。即使用户只说"帮我做个关于 X 的介绍"或"我要给老板汇报 Y",只要暗示需要结构化的多页演示内容,都应该触发。也适用于用户说"帮我把这篇文档做成 PPT"、"把这个主题做成演示"等需要将内容转化为演示格式的场景。
references/principles/failure-modes.md
View on GitHub# 失败模式目录
> 本文件沉淀 Step 4-5 单页生产链路的失败模式。**它定义合同违约和修复顺序,不定义某种审美风格、不压制创新**。
>
> 分类法来自 [sunbigfly/ppt-agent-skills](https://github.com/sunbigfly/ppt-agent-skills) 的 runtime-failure-modes。
---
## 1. 内容未完成类(4 种)
### 1.1 underfill(信息密度过低)
- **触发条件**:页面视觉成立,但 payload 明显不足。
- **失败征兆**:单页信息密度过低,装饰远多于有效信息;卡片留白过多但没有解释性内容。
- **允许创新区**:可以改变构图,但不可以拿留白代替内容合同。
- **修复**:从原始资料里补充数据/案例/解读,填充至策划稿要求的 40-100 字主卡片密度。
### 1.2 support_collapse(支撑卡片塌陷)
- **触发条件**:支撑卡片没有承担解释、比较、证据或上下文。
- **失败征兆**:页面只剩主标题和一两个大数字,缺承托层。
- **允许创新区**:可以改变支撑形式(list / data / process / quote),但必须补足支撑任务。
- **修复**:每个内容页 ≥ 3 张卡片 + ≥ 2 种 card_type + ≥ 1 张 data 卡片。
### 1.3 payload_missing(关键信息缺失)
- **触发条件**:planning 或 HTML 没有完整执行本页应交付的信息。
- **失败征兆**:关键 claim 没有证据、步骤、条件或来源承接。
- **允许创新区**:可以重排内容,但不可以省略必要字段。
- **修复**:对照策划稿 JSON 的 `cards[]` 字段,逐条补齐。
### 1.4 source_overclaim(论断超出资料支持)
- **触发条件**:页面结论强于资料支持力度。
- **失败征兆**:论断看起来完整,但 Step 2 的搜索资料包没有足够证据。
- **允许创新区**:可以强化表达节奏,但不可以夸大事实边界。
- **修复**:弱化结论措辞或补搜索(如"有望成为"改"在 X 行业初见端倪")。
---
## 2. 视觉失真类(4 种)
### 2.1 launch_drift(开场风格漂移)
- **触发条件**:封面或章节页把整套 deck 拉向与内容不匹配的发布会语气。
- **失败征兆**:后续信息页难以承接,风格偏置持续放大。
- **允许创新区**:可以做强开场,但必须服从 scene mode(现场/自阅/培训)和受众。
- **修复**:核对 Step 1 的演示场景;如是"自阅文档",封面应低调而非舞台感。
### 2.2 anchor_overexpansion(锚点过度膨胀)
- **触发条件**:锚点(大数据/大标题)占据全部注意力,支撑内容失去存在空间。
- **失败征兆**:页面单看有冲击,但论证不完整。
- **允许创新区**:可以放大锚点,但不可以吞掉支撑层。
- **修复**:缩小锚点占比至 ≤ 50%;增加支撑卡片或留出阅读路径。
### 2.3 deck_rhythm_clone(节奏克隆)
- **触发条件**:多页使用同构布局、同构装饰、同构锚点关系。
- **失败征兆**:整套 deck 有统一性但没有节奏推进。
- **允许创新区**:可以重复系统,但不可以复制结果。
- **修复**:参考 SKILL.md 的"密度交替"原则——高密度页(混合网格)后跟低密度页(章节封面),形成张弛有度的节奏。
### 2.4 decorative_substitution(装饰替代内容)
- **触发条件**:用材质、光效、分隔线替代真实信息组织。
- **失败征兆**:页面看起来复杂,实际信息承载能力下降。
- **允许创新区**:可以强化材质,但不可以让材质接管结构任务。
- **修复**:删除"为装饰而装饰"的元素;问自己"如果删掉这个装饰,页面信息会损失吗?",如果不会,删掉。
---
## 3. 修复顺序铁律
任何修复都按以下顺序执行,**不得跳过前两步**:
1. **先补 payload**(内容是地基)
2. **再补 support 与 context**(卡片是承托)
3. **再校正 anchor 的比例与位置**(视觉是叙事)
4. **最后调材质、装饰和局部表现**(装饰是收尾)
不能用装饰调整掩盖内容合同缺失。
---
## 4. 创新自由区
- 创新允许发生在:构图、节奏、装饰组合、锚点表现、材质层次。
- failure mode 只约束违约,不约束风格实验。
- 只要内容合同完整、阅读路径清晰、风格系统稳定,允许页面做高差异化探索。
---
## 5. 哪些能被脚本拦下
| 失败模式 | 检测方式 |
|---------|---------|
| support_collapse | `validate.py planning`:内容页卡片数低于版式容量、card_type 只有一种、没有数据卡片 |
| deck_rhythm_clone | `validate.py planning`:连续 3 个内容页使用同一版式 |
| underfill | `validate.py visual`:截图内容量过低(只能发现接近空白的页面) |
其余模式(payload_missing、source_overclaim、launch_drift、anchor_overexpansion、decorative_substitution)要靠看图判断,清单见 [`../strict-mode.md`](../strict-mode.md) 第 4 节。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |