SuperAPI AI 工具集

slides-audit

办公与效率

查看项目

更新于 10-16 01:28

技能介绍

用途:作为演示文稿质量工程师,对现有 deck 做技术缺陷排查与修复,不改写内容、不重构叙事,只关注像素、对比度、字体一致性与布局合规。

使用时机:在 /slides-build 之后捕获技术问题;对外分享前检查;当 deck“看起来不对”但说不清原因时。

前置条件:output.pptx(待审计的 deck)、design-profile.json(用于 lint 的设计约束)。

流程:先定位项目目录,可运行 find . -name "design-profile.json" -maxdepth 3。随后并行收集诊断: uvx --from agent-slides slides lint output.pptx --profile design-profile.json --out lint.json --compact uvx --from agent-slides slides inspect output.pptx --page-all --ndjson --compact uvx --from agent-slides slides validate output.pptx --compact uvx --from agent-slides slides inspect output.pptx --summary --compact 分析阶段把问题分为可自动修复(边界越界、形状重叠、缺少视觉元素,通过 ops patch 处理)与需人工判断(字号越界、非允许字体、非调色板颜色)。注意 edit 的 --query 只替换文本内容而非格式属性,改字号或颜色需用 apply 配合包含新 add_text 的 ops patch 并清除原文。

额外检查:对比度(避免白字配浅底 F2F2F2/FFFFFF/F0EDE6,深字配深底 203430/29BA74);重叠时调整位置优先移动内容形状而非模板占位符。修复写入 audit-fixes.json 后执行: uvx --from agent-slides slides apply output.pptx --ops-json @audit-fixes.json --output output.pptx --compact 再运行 qa 并输出结构化审计报告(分 Critical/Major/Minor,列出修复前后 lint 数量与 QA 状态)。

限制与反模式:不要给标题、免责声明或结束页添加视觉元素;不要改分节页字号;不要“修复”有意的 36pt+ 大号标注数字;不要移动模板布局形状;不要重写内容(属 /slides-critique);不要添加演讲者备注或元数据(属 /slides-polish)。