用途：该技能是 Figma REST API 与 Plugin API 常见错误的快速参考，帮助定位并修复 HTTP 错误、插件沙箱崩溃或异常 API 响应。
主要能力：按错误类别整理状态码、错误信息、原因与解决方案。REST 侧覆盖 400（请求格式或节点 ID 无效，节点 ID 形如 pageId:nodeId，如 0:1）、403（令牌无效、作用域错误、无文件访问权限）、404（文件 key 错误、文件已删除、端点错误）、429（请求过多，需读取 Retry-After 头并退避）、500（Figma 服务端问题，指数退避重试并查看 status.figma.com）。还包含图片端点返回 null 的排查（节点不可见、透明度为 0、节点 ID 不存在、无视觉内容）。插件侧覆盖 figma is not defined（在沙箱外运行）、访问已删除节点引用、插件超时、节点配额超限（约 5000 节点/操作）、manifest.json 缺少权限等。
使用方式：先判断错误类别，再按具体错误诊断。可用 curl 验证令牌：curl -s -o /dev/null -w "%{http_code}" -H "X-Figma-Token: ${FIGMA_PAT}" https://api.figma.com/v1/me，200 表示有效，403 表示无效或过期。作用域对应关系：file_content:read 对应 GET /v1/files/:key，file_comments:read 对应评论端点，file_variables:read 对应变量端点，webhooks:write 对应 POST /v2/webhooks。429 时读取 Retry-After、X-Figma-Rate-Limit-Type、X-Figma-Plan-Tier 头并实现退避。文件 key 位于 URL 中 /design/ 与下一个 / 之间。资料还提供诊断脚本思路：检查 Figma 服务状态、验证令牌、检查文件访问、确认环境变量。
适用场景：调试 Figma API 集成、排查插件运行错误、处理限流与鉴权问题。
限制：PAT 最长 90 天；PAT 使用 X-Figma-Token 头，OAuth 使用 Authorization: Bearer；插件代码仅在 Figma 桌面应用内运行；诊断请求建议加超时（如 curl --max-time 15）；错误不在目录中时应先查插件错误与状态页。具体收费、价格与平台支持等资料未提供。