跳转到使用指南
pptx-reference-deck-analysis作者 Seth Hobson

PPTX Reference Deck Analysis Skill.

一个 Claude Code 和 Codex skill,用于 PPT 和幻灯片:分析参考 PPTX 的主题、排版、布局节奏和诊断信息。

  • Presentations
  • 审查报告
wshobson/agents · plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.mdSKILL.md
--- name: pptx-reference-deck-analysis description: Use when analyzing a reference PPTX for read-only structure, theme, typography, layout rhythm, diagnostics, derived template catalogs, or safe OOXML package inspection. --- ## Contract ## Rules ## OOXML package inspection
前置信息和章节标题读取自上游文件,时间为 2026-09-14 · 完整内容 2,755 字符

01 功能说明

pptx-reference-deck-analysis Skill 在 Claude Code 和 Codex 中的作用

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

将参考 PPTX 作为设计证据来检查,并刻意从不复制、克隆或修改它。一个任务本地的 python-pptx 脚本会按需执行所需的提取,涵盖精简的 prompt 上下文(幻灯片数量和尺寸、形状数量、品牌信号、布局节奏)、带只读 layout_tree 证据的完整提取、文件夹诊断、样式母版分析,以及带零基源索引的派生模板目录。

内置的 OOXML 工具处理原始主题、关系、备注、注释、动画、媒体、母版和布局,脚本 inspect.py、validate_package.py 和 unpack.py 分别提供 JSON 报告、包验证和可选的原始包提取。每个被检查的部件和解析异常都会记录在分析清单中,在没有许可证证据的情况下,提取的资源不会进入新的演示文稿。

它产出什么

  • 精简的 prompt 上下文:幻灯片数量和尺寸、文本摘要、形状数量、样式、品牌信号、模板使用情况和布局节奏。
  • 包含摘要、幻灯片和只读 layout_tree 证据的完整提取。
  • 涵盖颜色、字体、尺寸分布、母版/布局使用和流程模式的样式母版分析。
  • 带零基源索引、布局角色、可用区域、占位符、视觉结构和约束的派生模板目录。
查看示例提示词 ↗

工作方式

  1. 01
    编写任务本地的 Extractor

    所需的提取是通过一个小型 python-pptx 脚本按需实现的,而非固定流水线,因此只会捕获新演示文稿所需的信息。

  2. 02
    运行精简检查

    scripts/inspect.py 接收演示文稿路径,返回一份涵盖幻灯片顺序、文本、主题 token、关系、备注、注释、动画和媒体的 JSON 报告。

  3. 03
    升级到 OOXML 工具

    内置工具是高层提取无法看到的原始主题、关系、备注、注释、动画、媒体、母版和布局的回退路径。

  4. 04
    将关系锚定到 .rels 所有者

    关系目标是相对于拥有 .rels 文件的部件来解析的,幻灯片顺序绝不会从文件名推断得出。

02 找到适合场景

何时使用 pptx-reference-deck-analysis Skill

在 Claude Code 或 Codex 中,当工作是此类 PPT 和幻灯片文档时,使用 pptx-reference-deck-analysis skill。以下适用范围和限制取自该 skill 自己的文件。

适合场景

  • 您希望将参考演示文稿作为设计证据来读取,用于新的演示文稿,而不是将其复制进去。
  • 您正在对一个文件夹中的多个演示文稿进行诊断,希望每个文稿得到一个结果,并附带一份清单。
  • 您需要关于输出形态和仅供参考的文档模式的内置参考文档。

了解边界

  • 任何克隆或修改源演示文稿的操作,而不是仅仅读取它。

需要提供的信息

  • 参考演示文稿路径内置脚本将 .pptx 作为第一个参数;这是唯一必需的输入。
  • 用于原始包证据的输出目录unpack.py 会将提取的部件写入您提供的目录,仅在需要原始包证据时才运行。
  • 来自 requirements.txt 的 defusedxml在使用任何内置 OOXML 工具之前安装。

03 Skill 内部

pptx-reference-deck-analysis Skill 为 Claude Code 和 Codex 设定的规则

SKILL.md 为 Agent 设定的 6 条具体指令、默认值与边界——文件中真正改变结果的那部分。

  1. 保持源文件为只读

    参考演示文稿永不被编辑,新目标幻灯片中的每个坐标都是独立创作的,而不是继承而来的。

  2. 记录所检查的内容

    每个被检查的部分和每个解析异常都必须记录在分析清单(manifest)中。

  3. 没有许可证证据不得复用

    提取的内容、字体、图像和专有资产,未经明确许可和许可证证据,不得出现在生成的演示文稿中。

  4. 在受信任的工作区中运行

    这些脚本会拒绝路径穿越、符号链接、超大成员以及压缩包炸弹,因此它们假定运行环境是受信任的工作目录。

  5. 使用 Defusedxml 解析 XML

    不受信任的 XML 必须通过 defusedxml 处理,且实体扩展、DTD 加载和网络访问都必须关闭。

  6. 将主题颜色视为 Token

    主题颜色在未完全根据配色方案解析之前,始终保持为一个 token。

04 投入使用

在 Claude Code 或 Codex 中安装 pptx-reference-deck-analysis

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 pptx-reference-deck-analysis 添加到 Claude Code、Codex 或您的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

针对 plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.md 的通用 skills CLI 形式;该仓库可能会记录其自己的路径。

为 Skill 提供首个 PPT 和幻灯片任务

按 skill 自身的术语撰写;把括号中的部分换成你的内容。

Starter prompt
I have a reference deck at [path/to/reference.pptx]. Inspect it as design evidence and give me the compact prompt context, a style-master analysis of colors, fonts and flow patterns, and a derived template catalog with layout roles, usable regions and placeholders. Validate the package and record inspected parts and parsing exceptions in the manifest, keeping the source read-only.

来源:依据 SKILL.md,按 skill 自身的术语撰写。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 运行 validate_package.py 并加上 --output,然后阅读报告中关于格式错误的 XML、损坏的内部关系、内容类型缺口、重复的布局链接以及孤立部分的信息。

在 OpenDesign 中通过其 SKILL.md 链接导入 pptx-reference-deck-analysis:Plugins → Add → Skill → Import from link,然后在顶部栏中选择它。

05 开源、可追溯

来源、许可与验证

本页面事实的来源,以及最后检查时间。

Repository
github.com/wshobson/agents 分支 main
Skill 文件
plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.md 验证时记录的内容校验和;提交 4236bb9
License
MIT 来自 LICENSE。
仓库星标数
39,635 GitHub 快照拍摄于 2026-09-14,针对整个 wshobson/agents 仓库,该仓库在此目录中包含 18 个 skills。不是 pptx-reference-deck-analysis 的评分或使用计数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 约定五种提取输出:提示上下文、完整提取、文件夹诊断、样式母版分析、模板目录。
  2. 规则源文件只读、坐标独立创作、清单记录、复用前需有许可证证据。
  3. OOXML 包检查安装 defusedxml,然后运行 inspect.py、validate_package.py 和 unpack.py;解析 .rels 目标。
  4. 安全性受信任的工作区、拒绝路径穿越和压缩包炸弹、defusedxml 解析、将主题颜色视为 token。
Skill 自身的描述
"在分析参考 PPTX 的只读结构、主题、排版、布局节奏、诊断、派生模板目录或安全 OOXML 包检查时使用。"

来自 SKILL.md 的前置描述。完整文件约 2,755 字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 pptx-reference-deck-analysis Skill 的常见问题

以下回答来自 2026-09-14 读取到的 SKILL.md,而非某次实际运行的记录。

分析我的参考演示文稿会更改该文件吗?

不会。该 skill 从不修改提供的演示文稿,也从不盲目地将包内部分复制到新演示文稿中;源文件保持只读,新幻灯片是独立创作的。

PPTX Reference Deck Analysis

在真实 PPT 和幻灯片任务上运行 pptx-reference-deck-analysis。

下载 OpenDesign,从 SKILL.md 链接导入 pptx-reference-deck-analysis,粘贴上方的提示词,并在查看结果之前阅读计划。

终端
npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows