用途：在审查 Figma 集成代码、新人上手或审计既有集成时，识别最常见的十类 API 使用错误并给出修正方向。前提是已有可审计的 Figma 集成与代码库访问权限。
主要能力：覆盖十类陷阱——无 depth 拉取整棵文件树（应改用 ?depth=1 或 /nodes?ids=）；忽略限流头导致 429 崩溃（应读取 Retry-After 并批量请求）；长期缓存图片导出 URL（Figma 图片 URL 约 30 天后失效，应短 TTL 或按需重新导出）；将 PAT 硬编码进源码（应使用 process.env.FIGMA_PAT，并立即轮换泄露令牌）；继续使用已弃用的 files:read 作用域（应用 file_content:read、file_comments:read、file_versions:read 等细粒度作用域）；忘记颜色格式转换（Figma 返回 0-1 浮点，需乘 255）；未处理图片渲染返回 null；用轮询代替 Webhook；对 SVG 导出传 scale（SVG 恒为 1x，scale 仅适用 PNG/JPG）；Webhook 未校验 passcode（应用计时安全比较验证）。
使用方式：按逐条陷阱审查集成，每条给出检测命令与修复建议，输出陷阱清单、检测信号对照表与具体代码修正。示例检测方式包括在仓库中搜索 figd_ 定位硬编码令牌，以及查找未带 depth= 或 /nodes 的 api.figma.com/v1/files/ 调用。每个陷阱在 references/ 下有对应深入文档（如 references/pitfall-8-polling-instead-of-webhooks.md）。
限制：资料未提供具体安装命令、依赖、价格或版本要求，这些暂未提供；实际使用需结合自身集成情况判断。