用途：该技能是一份 Groq API 错误码参考，帮助从原始错误字符串定位根因并给出修复方案，覆盖标准 HTTP 状态码、结构化错误体和速率限制响应头。
主要能力：Groq 错误体统一为 error.message、error.type、error.code 结构，可先读 code 与 type 判断路径。技能提供按状态码映射的排查表：401 为密钥无效或缺失，确认 GROQ_API_KEY 以 gsk_ 开头并用 /models 测试；429 为 RPM/TPM/RPD 超限，读取 retry-after 后退避并单次重试；400 为模型弃用或参数错误，列出可用模型并替换过期 ID；413 为请求超出上下文窗口，需裁剪提示（Llama 模型上限 128K tokens）；500/503 为 Groq 侧故障或过载，退避重试、切换模型并查看状态页。
使用方式：需在环境中导出 GROQ_API_KEY，并具备 curl 与 jq。可先验证密钥：curl -s https://api.groq.com/openai/v1/models -H "Authorization: Bearer $GROQ_API_KEY" | jq '.data | length'；再列出可用模型排查过期 ID。SDK 集成可依据类型化异常分支处理，参考 references/sdk-error-handling.md；完整逐状态参考见 references/error-reference.md。
适用场景：调试 Groq 请求失败、区分瞬时错误与结构性错误、编写重试逻辑。限制：瞬时错误（429/500/503）应退避重试并遵守 retry-after，结构性错误（401/400/413）重试无效，需修正请求。更全面的调试可参考 groq-debug-bundle 技能。