用途
Review Delta 用于代码审查场景,目标是只审查自上次提交以来发生变化的代码,以及这些变化所波及的范围(blast radius)。它强调 token 效率,避免在审查时加载无关或未改动的代码,适合在提交前检查或代码评审流程中快速聚焦高风险改动。
主要能力
- 增量变更检测:变更来自 git diff 对比 HEAD~1,只关注最近一次提交引入的改动。
- 风险评分:detect_changes_tool 会返回带风险评分的变更函数、测试缺口以及受影响的流程。
- 影响范围分析:自动识别 blast radius,即受改动影响的文件和函数。
- 审查上下文:get_review_context_tool 可提供变更区域的源码片段和 review_guidance,包括未测试函数、过大的影响范围、继承关系变化等提示。
- 测试确认:对每个未测试的高风险函数,可用 query_graph_tool 以 pattern="tests_for"、target="<function>" 确认其测试情况。
- 分级细节:支持 detail_level="minimal" 与 detail_level="standard",默认使用最小输出,仅在最小输出无法说明高风险项时才升级细节。
使用方式
- 调用 get_minimal_context_tool(task="review changes")。如果返回 status: not_ready,则调用 build_or_update_graph_tool() 并继续。
- 调用 detect_changes_tool(detail_level="minimal"),获取带风险评分的变更函数、测试缺口和受影响流程。变更来自 git diff 对比 HEAD~1;如果参数指定了某个文件,则将其传入 changed_files。
- 当需要变更区域的源码片段和 review_guidance(未测试函数、过大的影响范围、继承变化)时,调用 get_review_context_tool(detail_level="minimal")。
- 对每个未测试的高风险函数,用 query_graph_tool(pattern="tests_for", target="<function>") 进行确认。
- 仅对最小输出仍不清楚的高风险项使用 detail_level="standard"。除非片段不足,否则不要加载整个文件。
报告结构
审查结果按以下结构输出:
- Summary:一行摘要
- Risk:根据影响范围给出 low、medium 或 high
- Issues:bug、缺失测试、风格问题
- Blast radius:受影响的文件和函数
- Recommendations:建议
适用场景
- 提交前快速自查最近一次提交的改动风险。
- 代码评审中聚焦高风险、未测试的函数。
- 需要控制上下文长度、节省 token 的增量审查任务。
限制
- 变更范围限定为 git diff 对比 HEAD~1,即最近一次提交,不覆盖更早的历史改动。
- 依赖代码图:若上下文未就绪,需要先构建或更新代码图。
- 默认使用最小细节输出,完整文件内容不会主动加载,仅在片段不足时才考虑更细粒度。
- 关于收费、价格、平台支持等具体信息,资料中暂未提供。