When to Use
Use when the main artifact is a Microsoft PowerPoint presentation or .pptx deck, especially when layouts, templates, placeholders, notes, comments, charts, extraction, editing, or final visual quality matter.
Core Rules
1. Choose the workflow before touching the deck
- - Reading text, editing an existing deck, rebuilding from a template, and creating from scratch are different jobs with different failure modes.
- For text extraction or inspection, read the deck before editing it.
- Text extraction plus thumbnail-style visual inspection is safer than editing from shape assumptions alone.
- For template-driven work, inventory the deck before replacing content.
- For deep edits, remember a
.pptx file is OOXML with separate parts for slides, layouts, masters, media, notes, and comments. - If a template exists, template fidelity beats generic slide-design instincts.
- Reusing or duplicating a good existing slide is often safer than rebuilding it and hoping the theme still matches.
2. Inventory the deck before replacing content
- - Count the reusable layouts, real placeholders, notes, comments, media, and recurring typography or color patterns first.
- Placeholder indexes and layout indexes are not portable assumptions.
- Inspect the actual slide or template before targeting title, body, chart, or image shapes.
- Speaker notes, comments, and linked assets can live outside the visible slide surface.
- A missing or wrong placeholder target can silently land content in the wrong box or wrong layer.
- Master and layout settings can override local slide edits, so the visible problem is not always on the slide you are editing.
3. Match content to the actual placeholders
- - Count the actual content pieces before choosing a layout.
- Pick layouts based on the real number of ideas, columns, images, or charts the slide needs.
- Do not force two ideas into a three-column slide or cram dense text under a chart.
- Category counts and data series lengths must match or charts will break in ugly ways.
- Explicit sizing beats wishful thinking: text boxes, images, and charts need real space, not "it should fit".
- Do not choose a layout with more placeholders than the content can meaningfully fill.
- Quote layouts are for real quotes, and image-led layouts are for slides that actually have images.
- For chart-, table-, or image-heavy slides, full-slide or two-column layouts are usually safer than stacking dense text above the visual.
4. Preserve the deck's visual language
- - Theme, master, and layout files usually decide fonts, colors, and hierarchy more than any one slide does.
- Start from the deck's actual theme, fonts, spacing, and aspect ratio instead of improvising a new style.
- Reuse the deck's own alignment and spacing system instead of inventing a second visual language.
- Use common fonts for portability and strong contrast for readability.
- Preserve the template's visual logic first; originality matters less than not breaking the deck's existing language.
- Combining slides from multiple sources requires normalizing themes, masters, and alignment afterward.
5. Run content QA and visual QA separately
- - Text overflow, bad alignment, clipped shapes, weak contrast, and placeholder leftovers are normal first-pass failures.
- Run both content QA and visual QA; missing text and broken layout are different failure classes.
- Render or inspect the actual deck output before delivery when layout matters.
- Search for leftover template junk, sample labels, and placeholder text before calling the deck finished.
- Check notes, comments, labels, legends, and chart/table semantics separately from the visual pass.
- A deck can pass text extraction and still fail on overlap, clipping, wrong theme inheritance, or broken notes.
- Thumbnail grids and rendered slides usually reveal layout bugs faster than code or text inspection.
- Assume the first render is wrong and do at least one fix-and-verify cycle before calling the deck finished.
- Re-check affected slides after each fix because one spacing change often creates another issue.
6. Keep decks portable and review-safe
- - Template masters can override direct edits in surprising ways.
- Complex effects may degrade across PowerPoint, LibreOffice, and conversion pipelines, so keep important content robust without them.
- Image sizing, font substitution, and placeholder mismatch are common reasons a deck looks good in code and bad on screen.
- Notes, comments, linked media, and merged decks can stay broken even when the visible slide looks fine.
Common Traps
- - Placeholder text and sample charts often survive template reuse if not explicitly replaced.
- Directly editing one slide can fail if the real issue lives in the master or layout.
- Charts, icons, and text boxes need enough space; near-collisions are usually visible only after rendering.
- Layout indexes vary by template, so built-in assumptions from one deck often break in another.
- A missing placeholder or wrong shape target can silently put content in the wrong place.
- Counting the text ideas after choosing the layout usually leads to empty placeholders, weak hierarchy, or leftover template junk.
- Font substitution can move line breaks and wreck careful spacing.
- Speaker notes, comments, and linked media can stay broken even when the visible slide looks fine.
- A deck can pass text inspection and still fail visually because of overlap, contrast, or edge clipping.
- Editing from one slide alone can miss the real source of truth in the theme, master, or layout definitions.
- Choosing a quote, comparison, or multi-column layout without matching content usually makes the deck look templated rather than intentional.
- Combining or duplicating slides without checking masters and themes can create subtle inconsistency slide by slide.
- Aspect-ratio mismatches like
16:9 versus 4:3 can shift every placement decision even when each slide looks locally reasonable.
Related Skills
Install with
clawhub install <slug> if user confirms:
- -
documents — Document workflows that often feed presentation content. - INLINECODE6 — Visual direction and layout decisions.
- INLINECODE7 — Concise business messaging for slide narratives.
Feedback
- - If useful: INLINECODE8
- Stay updated: INLINECODE9
何时使用
当主要交付物是Microsoft PowerPoint演示文稿或.pptx文件时使用,尤其是在布局、模板、占位符、备注、批注、图表、提取、编辑或最终视觉质量至关重要的情况下。
核心规则
1. 在接触文件前先确定工作流程
- - 阅读文本、编辑现有文件、基于模板重建以及从头创建是不同的任务,各有不同的失败模式。
- 如需提取或检查文本,应在编辑前先阅读文件。
- 文本提取配合缩略图式视觉检查,比仅凭形状假设进行编辑更安全。
- 对于模板驱动的工作,在替换内容前应先盘点文件。
- 进行深度编辑时,请记住.pptx文件是OOXML格式,包含幻灯片、版式、母版、媒体、备注和批注等独立部分。
- 如果存在模板,保持模板一致性比凭直觉设计通用幻灯片更重要。
- 重用或复制一张好的现有幻灯片,通常比重建并期望主题仍然匹配更安全。
2. 在替换内容前先盘点文件
- - 首先统计可重用的版式、实际占位符、备注、批注、媒体以及重复出现的排版或颜色模式。
- 占位符索引和版式索引并非可移植的假设。
- 在定位标题、正文、图表或图像形状之前,先检查实际的幻灯片或模板。
- 演讲者备注、批注和链接资源可能存在于可见幻灯片表面之外。
- 缺失或错误的占位符目标可能会悄无声息地将内容放入错误的框或错误的图层。
- 母版和版式设置可以覆盖局部幻灯片编辑,因此可见问题并不总是在你正在编辑的幻灯片上。
3. 将内容匹配到实际占位符
- - 在选择版式前,先统计实际的内容片段数量。
- 根据幻灯片实际需要的观点、列、图像或图表数量来选择版式。
- 不要将两个观点强行塞入三列版式,也不要在图表下方塞入密集的文本。
- 类别数量和数据系列长度必须匹配,否则图表会以丑陋的方式损坏。
- 明确的尺寸设定胜过一厢情愿:文本框、图像和图表需要真实的空间,而不是应该能放下。
- 不要选择占位符数量超过内容能有效填充的版式。
- 引用版式用于真实的引用,图像主导的版式用于实际包含图像的幻灯片。
- 对于图表、表格或图像密集的幻灯片,全屏或两列版式通常比在视觉元素上方堆叠密集文本更安全。
4. 保留文件的视觉语言
- - 主题、母版和版式文件通常比任何单个幻灯片更能决定字体、颜色和层级结构。
- 从文件的实际主题、字体、间距和宽高比开始,而不是即兴创作新的样式。
- 重用文件自身的对齐和间距系统,而不是发明第二套视觉语言。
- 使用通用字体以确保可移植性,使用强对比度以确保可读性。
- 首先保留模板的视觉逻辑;原创性不如不破坏文件现有语言重要。
- 合并来自多个来源的幻灯片后,需要统一主题、母版和对齐方式。
5. 分别进行内容质量检查和视觉质量检查
- - 文本溢出、对齐不良、形状被裁剪、对比度弱以及占位符残留都是常见的初次失败情况。
- 同时进行内容质量检查和视觉质量检查;文本缺失和布局损坏是不同的失败类别。
- 当布局很重要时,在交付前渲染或检查实际的文件输出。
- 在宣布文件完成前,搜索残留的模板垃圾、示例标签和占位符文本。
- 分别检查备注、批注、标签、图例以及图表/表格语义,与视觉检查分开进行。
- 一个文件可能通过文本提取检查,但仍然在重叠、裁剪、错误的主题继承或损坏的备注上失败。
- 缩略图网格和渲染后的幻灯片通常比代码或文本检查更快地揭示布局错误。
- 假设第一次渲染是错误的,并在宣布文件完成前至少执行一次修复和验证循环。
- 每次修复后重新检查受影响的幻灯片,因为一次间距更改通常会产生另一个问题。
6. 保持文件的可移植性和审阅安全性
- - 模板母版可能以令人惊讶的方式覆盖直接编辑。
- 复杂效果可能在PowerPoint、LibreOffice和转换管道中降级,因此保持重要内容在没有这些效果的情况下依然稳健。
- 图像大小调整、字体替换和占位符不匹配是文件在代码中看起来不错但在屏幕上显示不佳的常见原因。
- 备注、批注、链接媒体和合并的文件即使在可见幻灯片看起来正常时也可能保持损坏状态。
常见陷阱
- - 如果未明确替换,占位符文本和示例图表通常会在模板重用后残留。
- 如果真正的问题存在于母版或版式中,直接编辑一张幻灯片可能会失败。
- 图表、图标和文本框需要足够的空间;接近碰撞通常只在渲染后才能看到。
- 版式索引因模板而异,因此从一个文件继承的假设通常会在另一个文件中失效。
- 缺失的占位符或错误的形状目标可能会悄无声息地将内容放在错误的位置。
- 在选择版式后统计文本观点通常会导致空的占位符、薄弱的层级结构或残留的模板垃圾。
- 字体替换可能会移动换行符并破坏精心设计的间距。
- 演讲者备注、批注和链接媒体即使在可见幻灯片看起来正常时也可能保持损坏状态。
- 一个文件可能通过文本检查,但仍然因重叠、对比度或边缘裁剪而在视觉上失败。
- 仅从一张幻灯片进行编辑可能会错过主题、母版或版式定义中的真实来源。
- 选择引用、比较或多列版式而没有匹配的内容,通常会使文件看起来模板化而非有意图。
- 在未检查母版和主题的情况下合并或复制幻灯片,可能会逐张幻灯片产生微妙的视觉不一致。
- 宽高比不匹配(如16:9与4:3)可能会改变每一个布局决策,即使每张幻灯片在局部看起来合理。
相关技能
如果用户确认,使用clawhub install 安装:
- - documents — 通常为演示文稿内容提供输入的文档工作流程。
- design — 视觉方向和布局决策。
- brief — 为幻灯片叙事提供简洁的商业信息传达。
反馈
- - 如果有用:clawhub star powerpoint-pptx
- 保持更新:clawhub sync