SuperAPI AI 工具集

pdfjs-agents-review

编程与开发

查看项目

更新于 11-11 10:55

技能介绍

用途

pdfjs-agents-review 是一个专门用于审查和验证 PDF.js 代码的 Claude 技能。当需要检查生成的 PDF.js 代码是否正确、是否符合最佳实践、是否存在常见错误时,可以使用该技能。其目标是防止将存在缺陷的代码(如缺少 Worker 设置、内存泄漏、API 不兼容等)发布到生产环境。

主要能力

该技能提供了一份详细的审查清单,共包含 10 项检查,每项检查都定义了 PASS/FAIL 条件、严重程度(Critical、High、Medium、Low)以及修复建议。检查项包括:

  1. Worker 设置:确保在调用 getDocument() 之前配置 GlobalWorkerOptions.workerSrc。
  2. Worker 版本匹配:确保 Worker 版本与安装的 pdfjs-dist 包版本一致,推荐使用 version 动态插值。
  3. 渲染任务取消:确保在开始新的 page.render() 之前取消之前的 RenderTask。
  4. 设备像素比处理:确保 Canvas 像素尺寸按 devicePixelRatio 缩放,并单独设置 CSS 尺寸。
  5. 图层堆叠顺序:确保 Canvas、TextLayer、AnnotationLayer 的 z-index 顺序正确,且使用绝对定位。
  6. 内存管理:确保文档销毁、页面清理、Canvas 尺寸归零、RenderTask 引用清除等。
  7. 懒加载:确保页面按需渲染(如使用 IntersectionObserver),而非一次性加载所有页面。
  8. v5 API 合规性:确保使用 pdfjs-dist 5.x 的 API,如 TextLayer 类而非 renderTextLayer() 函数。
  9. 导入正确性:确保导入路径和命名导入符合 pdfjs-dist 5.x 的要求。
  10. 错误处理:确保异常被捕获并处理,包括密码保护 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 库。审查清单基于最佳实践和常见错误,但可能无法覆盖所有边缘情况。具体实施时需结合项目实际环境和需求。