用途
该技能面向 CodeRabbit 配置升级与迁移场景，将托管 SaaS 的升级视为配置与授权（entitlement）变更，而不是 SDK 版本变更。它用于分析并升级配置、计划启用的功能、工具或平台集成，通过 schema 校验和可回滚的灰度发布（canary）流程推进变更。由于合同条款会演进，执行前需要重新核对官方文档。
主要能力
- 捕获已解析的配置、schema 有效性、计划、提供商、功能、指标与回滚信息。
- 识别新增、移除、重命名、默认化或受门控（gated）的行为。
- 应用最小化的功能分支变更，并测试符合条件与排除条件的用例。
- 通过灰度发布、对比证据，然后推进或回滚。
- 输出合同差异（contract diff）、经验证的补丁、授权检查、灰度证据、回滚与记录，并包含来源日期、未知项以及观察事实与建议之间的确切边界。
使用方式
前置条件：识别 CodeRabbit 组织、Git 提供商、仓库、计划与责任人；阅读 references/official-docs.md，并在执行前重新核对任何时效性合同；在满足批准边界前使用合成或只读证据；保留仓库独立的 CI、安全与人工审查要求。
当前合同：当前 schema URL 为 https://coderabbit.ai/integrations/schema.v2.json；配置参考由该 schema 生成；YAML 校验器检查提议的配置；计划、提供商、早期访问与自托管变更相互独立。
认证：将 Git 提供商会话、CodeRabbit Web 会话、CLI 凭据与 CodeRabbit API 密钥视为独立凭据。仅使用已批准的会话或密钥管理器引用，绝不打印密钥，也不得将凭据放入 .coderabbit.yaml、源文件、日志或交付物中。
工具纪律：使用 Glob 在不扩大范围的前提下定位候选配置与证据文件；使用 Grep 查找相关字段、命令、标识符与过时声明；使用 Read 检查最小必要文件与权威证据；仅在获得批准的新本地草稿或证据产物时使用 Write；仅在回滚已知且获得批准的有界变更时使用 Edit。不得将这些文件工具用作已认证 CodeRabbit 或提供商操作的替代。
批准边界：计划、早期访问、自托管、覆盖或生产变更需要责任人批准。在明确批准前保持分析与草稿在本地，并记录批准人及其范围。
适用场景
- 在 schema 校验后采用自动审查选项。
- 移除过时字段并证明已解析行为。
- 需要以可回滚、可审计方式推进 CodeRabbit 配置或集成变更的场景。
限制
- 当前合同不清晰或文档不一致时：停止变更，引用两个来源，并请求责任人解决。
- 缺少所需访问权限或批准时：仅产出草稿与证据计划。
- 校验或试点行为与预期不符时：恢复先前状态并保留失败证据。
- 输出包含密钥或私有代码时：停止、隔离产物、脱敏并通知数据所有者。
- 验证要求：对照 references/official-docs.md 中带日期的来源确认每项声明；核实请求范围、责任人、批准、正常路径、失败路径与回滚；任何获批变更后重新读取生效配置或提供商状态；将不支持的字段、未记录的端点与未经验证的假设报告为失败。
- 官方文档与合同说明需在任何实时操作前重新核对；未解决或已变更的供应商行为视为停止条件。