用途：该技能是 Klaviyo API 常见错误的快速参考，帮助从原始异常定位到具体修复。Klaviyo 返回 JSON:API 错误（状态码加结构化 errors[] 数组），流程为提取状态码、匹配目录、应用修复。
主要能力：按状态码给出根因与补救，包括 400（字段缺失、非 E.164 电话、snake_case 应为 camelCase）、401（缺少 KLAVIYO_PRIVATE_KEY 或误用公钥）、403（密钥缺少 profiles:write 等 scope）、404（资源 ID 错误或失效的 /api/v2/ 路径）、409（重复，改用 createOrUpdateProfile upsert）、429（超出 75/s 突发或 700/min 稳定速率，需遵守 Retry-After）、500/503（Klaviyo 侧问题，查状态页并退避重试）。完整逐状态码目录与 SDK 失败表位于 references/。
使用方式：需安装 klaviyo-api SDK（npm install klaviyo-api，注意不是 @klaviyo/sdk），将私钥 pk_* 导出为 KLAVIYO_PRIVATE_KEY，并能访问失败请求日志。先读取日志或包裹调用以查看结构化载荷，再按状态码匹配修复。示例：捕获异常后打印 error.status 与 error.body?.errors；仅有原始日志时用 grep -E "40[0-9]|429|50[0-9]" 定位。400 常见为大小写不匹配，SDK 期望 camelCase，如 { firstName: 'Jane' }。429 时读取 Retry-After 秒数后退避重试。
适用场景：调试 Klaviyo 集成中的失败请求、排查 SDK 异常、处理限流与权限问题。
限制：输出为诊断与修复建议，而非生成产物；若异常缺少状态码，说明是客户端问题，需查 SDK 级错误表；401 持续存在需确认密钥以 pk_ 开头；429 响应可能不含 RateLimit-Remaining，只返回 Retry-After；修复无效时可用 klaviyo-debug-bundle 收集证据、查 status.klaviyo.com 并提交支持工单。具体价格、平台支持范围等资料暂未提供。