关于 presentation-validation
一项演示文稿项目验证技能,通过只读调度器对指定项目文件夹运行检查。可生成易读或结构化报告,且不会修改项目文件。
主要功能
- 01运行生成或校对验证配置
- 02检查媒体规范中的角色规则
- 03支持结构化 JSON 结果
- 04不更改项目文件或状态
- 05在报告中提供修复指引
适用场景
- 01生成演示文稿后验证项目
- 02检查校对结果
- 03审批前检查媒体规范角色
- 04将结构化结果传递给其他进程
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ ken-guru/ skills --skill presentation-validation安装后在 Claude Code 中输入/presentation-validation确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
evals/presentation-validation.jsonscripts/presentation-validationpresentation-validation.mjstests/diagram-checks.test.mjspresentation-validation.test.mjstests/fixtures/marp-export/PRESENTASJON.htmlPRESENTASJON.mdtests/fixtures/marp-export/media/diagram.svgportrait.svg详细介绍
演示文稿验证
针对明确指定的项目文件夹运行随附的只读调度器:
presentation-validation check all --project-dir <project> --profile generation
presentation-validation check all --project-dir <project> --profile proofread
若要在媒体规范获批前,仅检查媒体规范角色规则(media.diagram-roles),请使用 generation 配置运行 check media-spec。
调度器不会安装工具、获取凭据、更改项目文件或更新 PROJECT.json。验证成功后,负责该阶段的技能仍负责状态更改。
输出语气
对面向用户的验证报告进行轻量润色,使其更自然。说明未通过的检查、受影响的产物以及补救措施,不要夸大其词。保留 JSON 输出、准确路径、命令、错误标识符和机器可读报告约定。演示文稿文案生成必须已完成所需的独立 unslop 处理;验证不能替代这一步。
如果另一个 Agent 或进程需要结构化发现结果,请使用 --format json。只有在明确要求生成持久化报告时,才使用 --report <path>。
完整验证作为完整 Presentation Skill Suite 的一部分受到支持。使用者技能可以说明此技能不可用,但不支持通过单独安装来进行完整验证。
维护
如果解决一个真实的验证失败需要不止一条临时诊断/修复命令,这就是一个信号,而不是个例:要么检查存在误报(因与真实演示文稿内容无关的原因而失败),要么修复应纳入此技能,而不是每次问题重现时都临时针对项目文件夹中的输出文件进行处理。将其纳入技能——修复检测器,或构建修复工具。
示例:Wayfinder:修复 presentation-validation 的误报导出检测器。校对运行后,需要多条手动 grep/node/ghostscript 命令才能绕过问题:exports.parity 的 PDF 页数计数器和 exports.media-parity 的 HTML 引用扫描,都会对 Marp/Bespoke 导出产物产生误报(一个压缩的 PDF 对象流、<script> 内的 JS 字符串字面量)。因此,直接修复了这两个检测器。