Bugbot 配置文件与评审力度

配置 base branch 上的 YAML，选择增量评审、摘要位置和 effort。

This page has not been translated into English yet. The original Chinese version is shown below.

Bugbot 可读取仓库根目录下的 .cursor/config/bugbot.yaml。配置必须已提交并推送到 PR base branch；不读 PR head 版本，避免 PR 自己放宽本次评审要求。

配置示例

version: 1
triggers:
  drafts: false
  frequency: everyPush
review:
  effort: default
  smartPrompt: ""
  incremental: true
prSummary:
  mode: comment
  riskScore: true
autofix:
  mode: disabled

全部字段可选。缺少文件沿用原行为，字段缺失或无效时忽略该字段并回退到下一层；超过 64 KB 的文件整体忽略。示例值是一次具体配置，不代表所有产品默认值。

配置优先级

个人对自己 PR 的 overrides 优先，其次 YAML，最后 dashboard 团队/组织设置。用 CODEOWNERS 和代码评审控制谁能修改配置。

autofix.mode 只能降低 dashboard 模式，不能提高。例如 existingBranch 可降为 newBranch 或 disabled，dashboard 已关闭时文件不能开启。

触发、增量与摘要

frequency 取 everyPush 或 oncePerPr，drafts 控制草稿。增量评审默认开启，仅看上次 Bugbot review 以来的变化；关闭 Incremental Review 后每次 push 检查完整 PR diff。

PR 摘要产品默认写入 description，并随评审更新；可改为更新一条 comment 或关闭。YAML prSummary.mode 对应 description、comment、disabled。个人 PR Summaries 可选 On、Off 或 Use Installation Default。

Effort

级别	官方说明
Low	优化成本，质量接近 Default，较便宜但更慢
Default	优化效率和速度，可能发现较少问题
High	更多推理，成本与耗时更高，可能发现更多问题
Smart	按自定义指令动态选 Low/Default/High

effort 仅对 usage-based Bugbot 方案提供。不要从名称推断 Low 必然最快；Smart 可用 smartPrompt 表达选择条件。