mcpField
P
pptx-quality-gates

pptx-quality-gates

github.com/wshobson文档处理41.9k2.7k 次安装2 周前更新
代码仓库

关于 pptx-quality-gates

用于在交付前检查生成的 PowerPoint 幻灯片的技能。它规定几何布局、内容、无障碍性、文件包完整性和预览的重复检查流程,并指导修复后重新验证。

主要功能

  1. 01核对规格与产物路径
  2. 02检查幻灯片边界和几何布局
  3. 03检查无障碍性与阅读顺序
  4. 04为正式演示文稿生成文件包报告
  5. 05渲染器可用时检查预览
  6. 06修复后重建并重新检查

适用场景

  1. 01交付前审核生成的演示文稿
  2. 02查找溢出、裁切或内容重叠
  3. 03检查图片替代文本和阅读顺序
  4. 04记录例外情况及所需审核产物

安装

复制下面的命令,在终端中运行。

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

安装后在 Claude Code 中输入/pptx-quality-gates确认已加载。

附带文件references/audit-checklist.md

详细介绍

PPT 质量门禁

在交付生成的 PPTX 之前使用此技能。将确定性失败视为修复工作,而非例外情况。

工作流

  1. 确认 spec、builder、PPTX、源清单和审计路径。
  2. 在构建之前,将 references/audit-checklist.md 应用于坐标契约。
  3. 重新打开 PPTX,将幻灯片数量、实际边界、隐藏幻灯片和请求的几何信息与布局树进行比对。
  4. 对于生产演示文稿,运行 pptx-reference-deck-analysis/scripts/validate_package.py 并保存 JSON。
  5. 检查语言、幻灯片标题、有意义的图像替代文本、阅读顺序、表格表头和源引用。
  6. 当兼容的渲染器已经可用时,检查预览中的裁剪、字体回退、对比度、裁切和层级。不要添加渲染器依赖。
  7. 修复 spec 或任务本地 builder,重新构建,并重新运行相同的检查。

必需产物

将 spec、PPTX、构建记录、几何审计、无障碍审计、包报告和源清单保存在一起。报告任何已记录的例外情况,并附上幻灯片 ID、对象 ID、负责人、原因和审查日期。

通过标准

零内容碰撞、文本溢出、不安全的内容边界、无效的正向几何信息和包完整性错误。有意义的幻灯片内容必须保持为原生可编辑对象;图像起支持作用,而非替代它。

完整的检查清单见 references/audit-checklist.md。

评论

支持 Markdown