Back to Details

pptx-quality-gates

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

PPTX Quality Gates

PPTX质量检查关卡

Use this skill before delivering a generated PPTX. Treat deterministic failures as repair work, not exceptions.
在交付生成的PPTX之前使用此技能。将确定性故障视为需要修复的问题，而非异常情况。

Workflow

工作流程

  1. Confirm the spec, builder, PPTX, source manifest, and audit paths.
  2. Apply 
    references/audit-checklist.md
    to the coordinate contract before building.
  3. Reopen the PPTX and compare slide count, actual bounds, hidden slides, and requested geometry with the layout tree.
  4. For production decks, run 
    pptx-reference-deck-analysis/scripts/validate_package.py
    and save the JSON report.
  5. Check document language, slide titles, meaningful-image alt text, reading order, table headers, and source references.
  6. When a compatible renderer is already available, inspect previews for clipping, font fallback, contrast, crop, and hierarchy. Do not add a renderer dependency.
  7. Repair the spec or task-local builder, rebuild, and rerun the same checks.
  1. 确认规格说明、构建工具、PPTX文件、来源清单以及审计路径。
  2. 在构建前，将
    references/audit-checklist.md
    应用于坐标约定。
  3. 重新打开PPTX，将幻灯片数量、实际边界、隐藏幻灯片以及要求的几何结构与布局树进行对比。
  4. 对于生产环境的演示文稿，运行
    pptx-reference-deck-analysis/scripts/validate_package.py
    并保存JSON报告。
  5. 检查文档语言、幻灯片标题、有意义图片的替代文本、阅读顺序、表格标题以及来源引用。
  6. 当已有兼容的渲染器时，检查预览中的内容裁剪、字体回退、对比度、裁剪效果以及层级结构。请勿添加渲染器依赖。
  7. 修复规格说明或任务本地构建工具，重新构建并再次运行相同的检查。

Required artifacts

必备工件

Keep the spec, PPTX, build record, geometry audit, accessibility audit, package report, and source manifest together. Report any documented exception with slide ID, object ID, owner, reason, and review date.
将规格说明、PPTX文件、构建记录、几何结构审计报告、可访问性审计报告、包报告以及来源清单保存在一起。记录任何异常情况，需包含幻灯片ID、对象ID、负责人、原因以及审核日期。

Pass criteria

通过标准

Zero content collisions, text overflows, unsafe content bounds, invalid positive geometry, and package-integrity errors. Meaningful slide content must remain native editable objects; images support rather than replace it.
See 
references/audit-checklist.md
for the complete checklist.
无内容冲突、文本溢出、不安全的内容边界、无效的正向几何结构以及包完整性错误。有意义的幻灯片内容必须保持为原生可编辑对象；图片仅作为补充而非替代。
完整检查清单请参阅
references/audit-checklist.md
。