用途：在遇到 Groq API 持续性问题、准备支持工单或收集诊断证据时，收集并打包所有必要的诊断信息，生成一个脱敏的支持包（.tar.gz）。
主要能力：支持包由六步 shell 脚本组装，每步向带时间戳的 $BUNDLE_DIR 内文件追加内容，最后打包并删除工作副本。内容包括：环境信息（操作系统、Node/Python 版本、已安装的 Groq SDK 版本、仅含长度与 4 字符前缀的密钥指纹）；连通性（请求 GET /openai/v1/models 确认鉴权并统计可用模型数）；速率限制（发送 1 token 补全并抓取 x-ratelimit-、retry-after、x-request-id 响应头）；延迟（对每个目标模型计时最小补全）；日志提取（从 logs/.log 中 grep 近期 Groq/429/rate-limit 错误并掩码 gsk_ 密钥与 .env 值）；打包（tar -czf 后删除工作副本并打印复查提醒）。
使用方式：需在环境中设置 GROQ_API_KEY，并具备 curl 和 jq；应用日志可选，若 logs/ 不存在则跳过日志步骤。按顺序在同一 shell 中运行六步，或粘贴为脚本。输出为 groq-debug-TIMESTAMP.tar.gz，内含 environment.txt、connectivity.txt、rate-limits.txt、latency.txt、app-logs.txt、config-redacted.txt。另有 TypeScript 诊断可打印含 auth、modelsAvailable、completion、latencyMs、model、usage 的 JSON 报告。
适用场景：排查 Groq API 鉴权失败、429 限流、延迟异常等问题，或为支持工程师提供完整证据。
限制与注意：分享前必须脱敏 API 密钥（gsk_ 开头）、Bearer token、PII、内部主机名与 IP。GROQ_API_KEY 未设置时 environment.txt 记录 NOT SET 且 curl 返回 401；401 表示密钥错误或已撤销；缺少 jq 时连通性/模型计数行为空；无 logs/ 目录时静默跳过日志步骤。429 在延迟/限流步骤中属预期现象。更深入的 429 处理可参考 groq-rate-limits 技能。完整六步脚本见 references/implementation.md，示例见 references/examples.md。