Pptx Quality Gates

作者 wshobson46891e7e60da無授權條款收錄於 2026年10月8日更新於 2026年10月8日

Use when validating or repairing an editable PPTX deck for geometry, accessibility, native editability, source lineage, and OOXML package integrity.

僅含說明Documents & Office
AI 產生的概覽

驗證並修復可編輯 PPTX 簡報的幾何、無障礙、可編輯性、來源與套件完整性。

功能
此技能在交付前對產生的 PPTX 簡報執行品質閘門。它先依座標契約在建置前檢查,再重新開啟檔案,將投影片數量、實際邊界、隱藏投影片與要求的幾何和版面樹比對。它也會檢查文件語言、投影片標題、有意義圖片的替代文字、閱讀順序、表格標題與來源參照,並在已有相容渲染器時檢查預覽中的裁切、字型回退、對比、裁切與階層。它會產出稽核成品,並指示修復規格或建置器,然後重新建置並重跑相同檢查。
適用情境
適用於交付或修復可編輯 PPTX 簡報之前,尤其是需要驗證幾何、無障礙、原生可編輯性、來源脈絡或 OOXML 套件完整性時。它適合需要確定性通過標準而非例外處理的正式簡報。
執行需求
僅含指示,不附指令碼。它參照一份檢查清單檔案,並針對正式簡報參照另一技能的驗證指令碼。僅在已有相容渲染器時使用,不新增渲染器相依性。需要規格、建置器、PPTX、來源清單與稽核路徑。

PPTX Quality Gates

Use this skill before delivering a generated PPTX. Treat deterministic failures as repair work, not exceptions.

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.

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.

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.

來源與署名

來源:wshobson/agents位於plugins/pptx-deck-creation/skills/pptx-quality-gates提交46891e7

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架