用途:审计或配置本仓库的 CodeRabbit 配置。铁律是任何配置主张或修改都必须有当前证据支撑其作用域与有效行为,否则无效。范围仅限仓库本地 CodeRabbit 配置,不负责安装 CodeRabbit 应用或 CLI、发起付费评审、发表评论、改动分支保护或规则集,也不配置其他评审机器人;设置变更需显式授权。
输入与准备:请求需指明模式——audit [PR <n>]、set up 或 update <change>,无参数则为对当前仓库审计。阅读仓库说明与 wiki(若有,不作强制)。涉及 PR 时先记录其确切 head SHA 与 base 分支。读取 .coderabbit.yaml、仓库设置及继承的组织或工作区配置证据,读取构建、测试与 CI 配置;分支、语言、路径布局均取证据而非假设;保留用户对作用域、严重级别、预设、分支与执行的明确决定;查阅当前官方文档,默认值均视为有时效性须核实。
审计(只读):分别报告三项主张——schema 有效性、规则质量、评审已完成证据。schema 优先用 coderabbit config validate <path>(须先经 --help 确认),否则用仓库既有 YAML 工具对照官方 JSON Schema;结论为 valid、invalid: <error> 或 cannot validate: <reason>。规则质量需检查反馈与执行分离、分支范围(base_branches 为附加正则列表)、评审节奏、路径覆盖(对照实际跟踪文件测试 glob)、测试文件映射、指南自动发现与作用域、信号策略、重复、fixtures、排除项,路径检查用 CodeRabbit minimatch 语义。评审完成须核实评审事件、发现和确切 head SHA,绿色状态检查不等同于评审完成。
设置或更新:展示满足请求的最小仓库本地配置 diff,并用首选校验器验证或说明不可用原因,只改用户要求的配置,结束后再次对照用户决定;提交、推送、发表评论、触发付费评审、改分支保护、装服务或 CLI 均需用户显式请求。配置形状使用官方 schema(https://coderabbit.ai/integrations/schema.v2.json),保持精简,path_instructions 采用 {path, instructions} 形式。安全规则包括先审计解释再编辑、不添加凭据、不臆测 UI 或继承设置、不跨结果外推结论、改现有策略前先询问。资料未提供具体收费、价格与效果信息。