用途
该技能用于把目标代码仓库或运行环境接入 Cohere：选择并安装当前 v2 客户端、将凭据保存在源码控制之外，并通过一次只读的 Models API 请求证明访问可用，而不产生推理费用。
主要能力
- 选择当前 v2 客户端：TypeScript 使用 CohereClientV2，Python 使用 cohere.ClientV2。
- 凭据管理：使用 CO_API_KEY 作为本地注入约定，或显式传入已批准的密钥引用；不打印、不持久化、不提交密钥，也不把 CO_API_KEY 放入示例。
- 版本固定：固定兼容的 SDK 版本范围并提交解析后的锁文件，不把无界安装命令复制进 CI。
- 认证验证：通过列出可访问模型来验证认证，而不是生成计费输出。
- 错误处理：针对 401、无模型、SDK 形态不匹配、密钥泄露等情况给出对应处置。
使用方式
- 检查清单文件、锁文件、现有提供商适配器和密钥加载约定。
- 选择 TypeScript、Python 或 REST，并固定当前兼容的 SDK 主版本。
- 记录 CO_API_KEY 的用法但不写入其值，如使用本地环境文件则更新忽略规则。
- 用注入的密钥和显式超时初始化 v2 客户端。
- 运行一次只读的模型列表探测，仅记录 SDK 版本、状态和模型数量。
- 为密钥创建、轮换、撤销和环境隔离指定负责人。
工具使用上，用 Read、Glob、Grep 检查代码、配置和证据；WebFetch 仅用于获取 Cohere 官方最新文档；仅当用户要求实现且确切目标文件已知时才使用 Write 或 Edit，且绝不写入凭据或客户内容。
适用场景
- 将仓库或运行时连接到 Cohere 并配置认证。
- 验证 Cohere 访问权限而不消耗推理 token。
- 排查 401、无可用模型、SDK 形态不匹配或密钥暴露等问题。
限制与审批边界
未经负责人批准，不得暴露或轮换密钥、更改 Cohere 团队角色、接受商业条款、启用敏感生产数据、增加支出或容量、切换生产模型、发送支持包，或执行模型提议的副作用。除非被要求实现，诊断应保持只读。输出需返回解析后的 API 与模型契约、检查过的文件或设置、收集的证据、验证结果、剩余风险、负责人以及回滚或下一步操作，并对密钥、授权头、提示、检索文档、嵌入、客户标识符和不受限的环境输出进行脱敏。
前置条件
目标仓库、运行时、环境和责任负责人；用于实时验证的已批准 Cohere 团队和密钥；当前的质量、安全、隐私、容量和变更控制要求。
错误处理
- 401：确认运行时注入和密钥状态，但不打印凭据。
- 无模型：在更改代码前检查团队成员资格和部署可用性。
- SDK 形态不匹配：将已安装主版本与官方生成的 SDK 参考进行比较。
- 密钥暴露：立即轮换或撤销，并清理保留的日志。
示例交接格式
输入：runtime=typescript; environment=ci; probe=models.list; secret=approved-reference
预期交接：client=v2; sdk=cohere-ai@resolved; auth=pass; key-value=redacted
资源
技能专属官方文档、创建 v2 客户端、Models API。