用途：本技能用于在不扩大设计文件访问权限、不泄露令牌的前提下，诊断设计转代码（design-to-code）失败。建议从可复现的文件/节点/设置组合出发，使用最小权限的开发凭据进行验证。
前置条件：需要一份脱敏的错误记录，包含设计文件标识、节点标识、所选生成设置、时间戳及请求 ID（如有）；Anima 与 Figma 凭据应存放在密钥库中，切勿将个人访问令牌粘贴到工单、源文件或共享诊断日志；准备一个暂存或一次性设计夹具，以便在不改动生产设计文件的情况下复现修复。
主要能力：将失败归类为认证、文件/节点解析、生成器配置、超时/限流或渲染输出质量；用最小获批的 frame/component 复现并仅捕获脱敏结果；修正对应的设计输入、权限或生成配置后仅重跑该夹具；在更新更大组件集前验证生成文件位置、lint/build 结果与视觉审查。
错误参考：认证类包括 Invalid Anima token（令牌未配置或过期，向 Anima 团队申请新令牌）、Invalid Figma token（PAT 过期或撤销，在 Figma > Settings > Access Tokens 生成新 PAT）、Unauthorized（令牌缺少文件访问权限，确保 Figma PAT 具有文件读取权限）。文件与节点类包括 File not found（文件 key 错误，从 Figma URL figma.com/file/{KEY}/... 提取）、Node not found（节点 ID 无效，在 Figma 右键 > Copy link 复制节点链接）、No renderable content（选中了页面或组，应选择 frame、component 或 component set）、Empty files record（节点为空或隐藏，取消隐藏图层并确保节点有可见内容）。
输出质量：布局混乱多因 Figma 无 auto-layout，应转为 auto-layout；颜色错误多因硬编码 hex 而非 Figma 变量，应使用 Figma 颜色变量/样式；文本缺失多因文本位于遮罩组内，生成前应展平遮罩；多余包裹层多因组嵌套过深，应展平组层级；组件名错误多因图层未命名，应使用描述性命名。
有效设置组合：react 支持 typescript、javascript，样式支持 plain_css、tailwind、inline_styles，UI 库支持 omit、mui、antd、radix、shadcn、clean_react、custom_design_system；html 支持 typescript、javascript，样式支持 plain_css、tailwind、inline_styles，UI 库仅 omit。
诊断命令：验证 Figma 令牌 curl -s "https://api.figma.com/v1/me" -H "X-Figma-Token: ${FIGMA_TOKEN}" | jq '.handle // .err'；验证文件访问 curl -s "https://api.figma.com/v1/files/${FIGMA_FILE_KEY}" -H "X-Figma-Token: ${FIGMA_TOKEN}" | jq '.name // .err'。
工具纪律：改动前用 Read 和 Grep 检查现有集成与生成差异；仅在获批的生成代码、测试或配置路径内使用 Write 或 Edit；Bash 命令仅用于本工作流明确的安装、验证或诊断步骤；绝不打印令牌、源设计、生成源码或私有网站截图。
限制与处理：令牌无效、过期或权限过大时应停止诊断，通过受管密钥轮换替换，避免记录其值；文件或节点无法解析时，先与设计负责人核实获批链接与可见性再重试；生成器超时或限流时使用有界退避或简化夹具，不要无控制地重试；生成输出不安全或错误时，不要合入主分支，修正源设计/设置后重跑针对性验证。