PPT 质量把关审核
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/pptx-quality-gates。
技能介绍
解决什么问题
当程序批量生成 PPTX 时,坐标算错、文本溢出或字体回退通常是隐藏在交付阶段的确定性失败。一个错位的绝对定位可能盖住标题,一次未闭合的表格结构可能直接导致渲染崩溃。这些问题不是创意偏差,而是可度量的工程缺陷,一旦进入下游协作就会放大返工成本。该技能将交付前的审核变成可重复执行的检查项,而不是凭肉眼快速翻页。
核心能力与工作流
它把“排版质量”拆成可验证的几何契约与内容契约:
- 确定性校验:在生成阶段前置
references/audit-checklist.md,把预期坐标、Slide ID、对象边界与版式树对齐,保证越界、重影、无效正数几何这类问题在构建时就被发现。 - 双重审计:重新打开 PPTX 后,不仅对比
slide count、实际边界与隐藏幻灯片,还会逐项检查文档语言、有意义的图片alt文本、阅读顺序、表头和来源标注。 - 可回溯的报告:生产级 deck 可通过
pptx-reference-deck-analysis/scripts/validate_package.py产出 JSON 报告,把每个失败项落到具体的slide_id、object_id和负责人,并记录豁免理由与审查日期。 - 修复闭环:发现失败后不依赖临时补丁,而是修改 spec 或任务本地 builder,重建并重跑同一套检查,直到通过标准归零。
适用边界
这是一个交付前的“闸门”,不负责重写内容风格,也不承诺跨所有渲染器表现完全一致。只要存在兼容的渲染器,它就会检查裁切、对比度、字体回退和层级遮挡;如果环境没有渲染器,它不会主动安装依赖,而是把相关风险留在可记录的人工审查清单里。
该技能不会自动执行下载内容、修改系统权限或创建持久化任务。任何涉及发送、发布、删除或付款的外部写入操作,都会先展示目标和影响范围,待确认后才继续。命令与代码默认仅作参考,只有在你明确要求且目标范围清晰时才会运行。
使用场景
- 程序生成年终汇报 PPT 后,需要确认文本没有溢出、图片 alt 文本可读、隐藏页符合交付范围。
- 批量生成客户方案时,要逐项核对实际坐标与请求的几何边界,避免对象遮挡或超出安全范围。
- 教学课件交付前,需要检查阅读顺序、表头结构和来源引用,确保内容可被屏幕阅读器顺序解析。
- 发布会议 deck 前,运行 validate_package.py 生成 JSON 报告,把失败项定位到具体幻灯片和对象。
适合人员
- 开发 PPTX 生成脚本的工程师,需要一套可重复的坐标、溢出和包完整性校验规则。
- 负责批量出图和发布 deck 的自动化工程师,要把失败项定位到幻灯片与对象并留档。
- 关注课件可访问性的技术作者,希望补齐 alt 文本、阅读顺序和表头标注的检查流程。
- 需要管理生成式文档交付质量的技术负责人,要求每次发布前有确定性闸门和例外记录。