用途：指导升级 groq-sdk（或 Python groq 包）并迁移已弃用的 Groq 模型 ID，走安全升级路径——建分支、升版本、扫描弃用模型引用、改写、对照实时模型端点验证后再合并。
主要能力：读取当前 SDK 版本并与 npm view groq-sdk version 对比；用 grep 扫描 src/ 中的模型字符串；通过 MODEL_MIGRATIONS 解析映射在运行时改写弃用 ID；扫描旧 @groq/sdk 导入与已移除方法调用；运行 npm test 与 SDK 集成冒烟测试；必要时回滚。
必要用法：需 Node 项目依赖 groq-sdk（或 Python groq 包），PATH 中有 npm、git、curl、jq，并导出 GROQ_API_KEY（SDK 构造器 new Groq() 自动读取，实时检查用 Authorization: Bearer $GROQ_API_KEY）。密钥获取见 https://console.groq.com/keys。步骤：git checkout -b chore/upgrade-groq-sdk；npm install groq-sdk@latest；将解析映射并入客户端模块或新建 groq-migrations.ts；运行扫描；npm test 并对照 GET https://api.groq.com/openai/v1/models 验证；回滚用 npm install groq-sdk@0.11.0 --save-exact。
弃用与替代：mixtral-8x7b-32768（2025-03-05）→ llama-3.3-70b-versatile 或 llama-3.1-8b-instant；gemma2-9b-it（2025-08-08）→ llama-3.1-8b-instant；llama-3.1-70b-versatile 与 llama-3.1-70b-specdec（2024-12-06）→ 对应 3.3 版本；playai-tts 与 playai-tts-arabic（2025-12-23）→ Orpheus TTS；distil-whisper-large-v3-en → whisper-large-v3-turbo。
适用场景：SDK 版本升级、模型弃用清理、迁移到新模型。限制：需自行提供 API 密钥与项目环境；具体命令细节见 references/implementation.md，示例见 references/examples.md；CI 集成参见 groq-ci-integration 技能。