概述
该技能提供针对 Groq API Key 以及经 Groq 推理 API 流转数据的安全实践。资料指出，Groq 使用单一类型的 API Key（前缀为 gsk_），拥有完整访问权限，没有限定范围（scoped）的令牌，因此密钥管理与轮换至关重要。本技能给出六个端到端的加固步骤，核心内容在此，深层代码与完整命令序列提取到 references/ 目录以实现渐进式披露：references/implementation.md 包含服务端代理模式、提示注入防御、审计日志（TypeScript）；references/examples.md 包含可直接复制使用的密钥存储、轮换与 Git 泄漏防护命令。
前提条件
需要 console.groq.com 上的 Groq 账号、对环境变量管理的理解，以及生产环境的密钥管理方案（Vault、AWS Secrets Manager 等）。
关键安全事实
Groq API Key 以 gsk_ 开头并授予完整 API 访问权限；不存在只读或限定范围的密钥，每个密钥可调用所有端点；密钥在 console.groq.com/keys 创建，创建后无法再查看；速率限制按组织而非按密钥计算；Groq 不会为训练存储提示数据（见隐私政策）。
使用方式（六步）
- 按环境安全存储密钥：将密钥排除在源码之外。开发环境使用经 Git 忽略的 .env.local，生产环境使用平台密钥管理器（Vercel / AWS / GCP / GitHub Actions）。资料给出创建 .env.local 与 .gitignore 条目的命令示例。
- 密钥轮换流程：两个密钥可同时生效，因此轮换是零停机的——创建以日期命名的密钥、部署、通过 /v1/models 返回 200 验证、监控 24 小时，然后删除旧密钥。
- Git 泄漏防护：安装预提交钩子，阻止任何暂存区中的 gsk_ 密钥。使用 Read 确认 .gitignore 已排除 .env 文件，再用 Grep 扫描现有文件树和历史记录中已提交的密钥，资料给出 grep 命令。
- 服务端密钥使用模式：绝不将密钥暴露给客户端代码，通过后端代理推理请求，使密钥保留在服务端，并在调用 Groq 前验证/限制用户输入。完整 Next.js 路由处理器见 implementation.md。
- 提示注入防御：清理用户输入，剥离覆盖性短语（ignore previous instructions、you are now、system: 等），并搭配一个拒绝角色变更的加固系统提示词。完整代码见 implementation.md。
- 审计日志：记录每次补全的 token 数量、延迟与状态，以便将滥用与成本激增追溯到具体用户。完整 auditedCompletion 实现见 implementation.md。
产出
应用该技能后，可得到加固的 Groq 集成：Git 忽略的 .env.local（开发）与密钥管理器条目（生产）；对暂存 gsk_ 密钥返回非零退出的 .git/hooks/pre-commit 钩子；有文档且经过测试的、以日期命名密钥的轮换运行手册；后端代理路由，使密钥永不触达客户端；输入清理与防注入的加固系统提示词；每次补全的结构化审计日志条目（GroqAuditEntry）；以及下方完成的安全检查清单。
错误处理
- /v1/models 返回 401 未授权：轮换后的密钥错误或尚未传播到密钥管理器，删除旧密钥前先核对 Authorization: Bearer 值。
- 预提交钩子未触发：确认文件可执行（chmod +x .git/hooks/pre-commit）；钩子不会被 git clone 复制，需按检出重新安装。
- Grep 发现密钥已在历史记录中：立即轮换密钥（第 2 步）；仅清理历史不够，因为密钥已暴露。
- 客户端出现 GROQ_API_KEY 引用：任何会内联密钥的打包器（如 NEXT_PUBLIC_ 前缀）都会泄漏密钥；将调用移至服务端（第 4 步）。
- 意外触发速率限制：限制按组织而非按密钥计算，泄漏的密钥会共享配额；429 突然激增可能表明滥用。
安全检查清单
API 密钥位于环境变量而非源码中；.env 文件在 .gitignore 中；存在用于密钥泄漏检测的预提交钩子；开发/预发/生产使用不同密钥（不同 Groq 组织）；密钥轮换有文档且经过测试；Groq 调用经后端代理（绝不在客户端）；发送给 Groq 前清理用户输入；系统提示词已加固防注入；所有补全均有审计日志；在 Groq Console 设置支出限额。
限制与后续
本技能聚焦安全基线，生产部署可继续使用 groq-prod-checklist 技能，涵盖部署门禁、监控与支出控制。产品价格、平台支持等细节资料未提供。