用途
pdfjs-agents-review 是一个专门用于审查和验证 PDF.js 代码的 Claude 技能。当需要检查生成的 PDF.js 代码是否正确、是否符合最佳实践、是否存在常见错误时,可以使用该技能。其目标是防止将存在缺陷的代码(如缺少 Worker 设置、内存泄漏、API 不兼容等)发布到生产环境。
主要能力
该技能提供了一份详细的审查清单,共包含 10 项检查,每项检查都定义了 PASS/FAIL 条件、严重程度(Critical、High、Medium、Low)以及修复建议。检查项包括:
- Worker 设置:确保在调用
getDocument()之前配置GlobalWorkerOptions.workerSrc。 - Worker 版本匹配:确保 Worker 版本与安装的
pdfjs-dist包版本一致,推荐使用version动态插值。 - 渲染任务取消:确保在开始新的
page.render()之前取消之前的RenderTask。 - 设备像素比处理:确保 Canvas 像素尺寸按
devicePixelRatio缩放,并单独设置 CSS 尺寸。 - 图层堆叠顺序:确保 Canvas、TextLayer、AnnotationLayer 的 z-index 顺序正确,且使用绝对定位。
- 内存管理:确保文档销毁、页面清理、Canvas 尺寸归零、RenderTask 引用清除等。
- 懒加载:确保页面按需渲染(如使用 IntersectionObserver),而非一次性加载所有页面。
- v5 API 合规性:确保使用 pdfjs-dist 5.x 的 API,如
TextLayer类而非renderTextLayer()函数。 - 导入正确性:确保导入路径和命名导入符合 pdfjs-dist 5.x 的要求。
- 错误处理:确保异常被捕获并处理,包括密码保护 PDF、版本不匹配、渲染取消等。
此外,技能还提供了决策树式的审查工作流、审查输出格式([FAIL] 或 [PASS] 报告)以及参考链接。
使用方式
该技能通常由 AI 助手在代码审查过程中调用。审查者可以按照清单逐项检查代码,或参考决策树按步骤进行审查。输出格式建议为每个发现的问题提供检查编号、严重程度、位置、问题描述和修复建议。当所有检查通过时,输出 [PASS] All 10 checks passed. No anti-patterns detected.
适用场景
适用于前端开发中集成 PDF.js 5.x 的项目,特别是在使用 AI 生成 PDF.js 代码后需要进行质量把关的场景。也适用于代码审查、技术债务清理、性能优化等环节。
限制
该技能专注于 PDF.js 5.x 版本的代码审查,不适用于旧版本或其他 PDF 库。审查清单基于最佳实践和常见错误,但可能无法覆盖所有边缘情况。具体实施时需结合项目实际环境和需求。