跳转到使用指南
pptx-quality-gates作者 Seth Hobson

PPTX Quality Gates Skill.

一个 Claude Code 和 Codex skill,用于 PPT 和幻灯片:验证和修复可编辑 PPTX 文件的几何结构、无障碍访问性和包完整性。

  • Presentations
  • PPTX
wshobson/agents · plugins/pptx-deck-creation/skills/pptx-quality-gates/SKILL.mdSKILL.md
--- name: pptx-quality-gates description: Use when validating or repairing an editable PPTX deck for geometry, accessibility, native editability, source lineage, and OOXML package integrity. --- ## Workflow ## Required artifacts ## Pass criteria
前置信息和章节标题读取自上游文件,时间为 2026-09-14 · 完整内容 1,635 字符

01 功能说明

pptx-quality-gates Skill 在 Claude Code 和 Codex 中的作用

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

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

以 skill 自身的术语

该 skill 在交付前验证并修复可编辑的 PPTX 幻灯片,检查几何坐标契约、无障碍合规性以及 OOXML 包完整性。它应用审计清单来验证幻灯片数量、实际边界、隐藏幻灯片、文本溢出、内容碰撞以及原生可编辑性。

对于生产版幻灯片,它会运行一个 Python 验证脚本并保存 JSON 报告。当验证失败时,它会修复 spec 或 builder,重新构建幻灯片,并重新运行相同的检查,直到零错误为止。所有产物——spec、PPTX、构建记录、几何审计、无障碍审计、包报告和源清单——都被一起保存。

PPTX
查看示例提示词 ↗

工作方式

  1. 01
    确认文件路径与产物

    在验证开始之前,该 skill 会确认 spec、builder、PPTX 文件、源清单和审计路径的位置,以确保所有所需材料均可用。

  2. 02
    在构建前应用坐标契约审计

    该 skill 在幻灯片构建之前,将 references/audit-checklist.md 中的审计清单应用于坐标契约,从而及早发现几何问题。

  3. 03
    将重新打开的 PPTX 与布局树进行比较

    构建完成后,该 skill 会重新打开 PPTX,并将幻灯片数量、实际边界、隐藏幻灯片以及所请求的几何信息与布局树进行比较,以发现差异。

  4. 04
    为生产环境运行包验证脚本

    对于生产版幻灯片,该 skill 会运行来自 pptx-reference-deck-analysis 的 validate_package.py 脚本,并保存生成的 JSON 报告。

  5. 05
    检查无障碍合规性

    该 skill 会验证文档语言、幻灯片标题、有意义图片的替代文本、阅读顺序、表格标题以及来源引用,以确保符合无障碍标准。

  6. 06
    失败时修复并重新构建

    当验证发现错误时,该 skill 会修复 spec 或任务本地的 builder,重新构建幻灯片,并重新运行所有检查,直到幻灯片通过为止。

02 找到适合场景

何时使用 pptx-quality-gates Skill

当任务是这类 PPT 和幻灯片时,在 Claude Code 或 Codex 中使用 pptx-quality-gates skill。适用范围和限制取自该 skill 本身的文件。

适合场景

  • 用于验证或修复可编辑 PPTX 文档的几何结构、可访问性、原生可编辑性、来源谱系和 OOXML 包完整性时

    03 Skill 内部

    pptx-quality-gates Skill 为 Claude Code 和 Codex 提供的规则

    SKILL.md 为 Agent 设定的 7 条具体指令、默认值与限制——正是文件中真正改变结果的部分。

    1. 交付前使用

      在交付任何生成的 PPTX 之前,必须应用此 skill 以确保满足质量门槛。

    2. 将失败视为修复工作

      确定性验证失败被视为修复机会,而不是记录后即忽略的异常。

    3. 绝不添加渲染器依赖

      在检查预览图中的裁切、字体回退、对比度、裁剪和层级问题时,该 skill 仅在已有兼容渲染器可用的情况下才会继续,绝不会将其新增为依赖。

    4. 保持所有产物完整一致

      规格文档、PPTX、构建记录、几何审计、无障碍审计、打包报告和源清单必须作为完整的一套加以维护。

    5. 用完整元数据记录所有例外情况

      任何记录的例外情况都必须包含幻灯片 ID、对象 ID、负责人、原因和审查日期,以便追溯。

    6. 零容忍通过标准

      演示文稿必须实现零内容碰撞、零文字溢出、零不安全内容边界、零无效正几何以及零打包完整性错误,方能通过。

    7. 保留原生可编辑性

      有实际意义的幻灯片内容必须保持为原生可编辑对象;图片用于辅助内容,而非取代内容。

    04 投入使用

    在 Claude Code 或 Codex 中安装 pptx-quality-gates

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

    将 pptx-quality-gates 添加到 Claude Code、Codex 或您的 Agent

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

    Terminal
    npx skills add https://github.com/wshobson/agents --skill pptx-quality-gates

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

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

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

    Starter prompt
    Validate the generated deck [output.pptx] using the spec [deck-spec.yaml] and builder [builder.py] before client delivery. Run the full quality gate workflow including coordinate contract audit from references/audit-checklist.md, package integrity validation with validate_package.py, and accessibility checks for alt text and reading order. Keep all artifacts together and repair any failures until zero errors remain.

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

    检查首次结果

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

    • 当渲染器可用时,检查预览图中的裁切、字体回退、对比度、裁剪和层级问题

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

    05 开源、可追溯

    来源、许可与验证

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

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

    SKILL.md 内部

    1. 工作流从确认路径到修复并重新构建失败的演示文稿的七步验证流程
    2. 所需产物规格文档、PPTX、构建记录、审计、打包报告和源清单一并保存,并记录相关例外情况
    3. 通过标准对碰撞、溢出、边界错误、几何问题和打包错误零容忍;保留原生可编辑性
    Skill 自身的描述
    "用于验证或修复可编辑 PPTX 文档的几何结构、可访问性、原生可编辑性、来源谱系和 OOXML 包完整性。"

    来自 SKILL.md 的前言描述。完整文件约 1,635 字符。在 GitHub 上阅读完整文件。

    06 安装之前

    关于 pptx-quality-gates Skill 的常见问题

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

    这个 skill 会验证 PPTX 演示文稿中的哪些内容?

    该 skill 通过坐标契约和布局树比较验证几何结构,通过检查文档语言、幻灯片标题、替代文本、阅读顺序、表格标题和来源引用来验证无障碍性,并通过为正式演示文稿运行 validate_package.py 来验证打包完整性。它确保零内容碰撞、零文字溢出、零不安全内容边界、零无效正几何以及零打包完整性错误。

    PPTX Quality Gates

    在真实的 PPT 和幻灯片文档任务中运行 pptx-quality-gates。

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

    终端
    npx skills add https://github.com/wshobson/agents --skill pptx-quality-gates

    OpenDesign 桌面客户端

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

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

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

    支持 macOS 与 Windows