> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ultra Review 智能体

Ultra Review 是 Qoder 全新一代的代码评审能力。相比单次通览式的评审，它将审查拆解为多个相互独立的维度并行执行，再对结果进行合并与去重，输出一份信噪比更高、定位更精确的结构化报告。

## 核心能力

* **多维度并行审查**：需求完整度、编码正确性、变更影响面三个维度同时执行，单次评审即可覆盖
* **严格的发现门槛**：每条发现需同时满足"问题确定（非推测）、由本次变更引入、有可引用的证据"，过滤推测性与无关问题
* **精确代码定位**：每个问题都锚定到具体文件与行号，附带证据片段与可执行的修复建议
* **按严重度分级**：Critical（必须修复）/ Warning（建议修复）/ Suggestion（可考虑）三档分类输出
* **单点容错**：当某个维度因目标范围特殊而无产出时，其他维度的结论仍会正常返回，并在报告中标注缺失项

## 三视角并行

Ultra Review 把审查拆成三个相互独立的维度并行执行，每个维度只盯一件事，避免维度间互相干扰、深度被稀释：

* **Completeness（需求完整度）**：变更是否真正落地了需求意图？验收点、API 契约、状态分支是否都已覆盖，有没有遗漏或只实现一半的逻辑。
* **Correctness（编码正确性）**：逻辑漏洞、空指针与越界、错误处理与边界条件、并发与资源泄漏，以及明显的安全或性能风险。
* **Impact（变更影响面）**：本次改动引入的副作用（全局状态、IO、并发、生命周期 hooks），以及对既有契约的破坏（API、默认值、schema、配置向后兼容）。

三个维度的发现会经过统一的合并与去重——命中同一处代码的问题会被归并为一条，保留证据最充分的那一份。

## 审查范围

`/ultra-review` 会默认审查以下范围：

1. 优先审查未提交的代码变更（包括 staged 与 unstaged）
2. 若没有未提交变更，自动回退到最近一次 commit
3. 也可以显式指定目标，比如某个 commit hash、文件路径、Pull Request 或一段代码片段

## 如何使用

Ultra Review 已内置于 Qoder 中，无需额外配置。在输入框中使用斜杠命令 `/ultra-review` 并按需补充审查范围即可。

<Note>
  Ultra Review 目前在 Quest 视窗的智能体模式下不可用。
</Note>

## 最佳实践

对于大型变更，建议按模块或按提交分批审查，能获得更精细的反馈。

如果改动涉及特定业务背景或非显性约束，在请求里简要说明上下文，会让评审结论更贴合实际场景。