质量工程 Demo

自动化代码审查 Agent

一个质量工程审查 Agent:先分诊 PR 文件,再加载团队规范,按复杂度路由审查深度,最后输出带门控的评论。

可运行 demo · 仓库路径: workshops/workshop1-code-review

结构蓝图

自动化代码审查 Agent blueprint

可点、可跑、可观察

交互式浏览器 Demo

这个模拟器不替代命令行运行,但可以直接在网页里观察每一步的状态、执行日志、质量门和最终输出。

实时流水线

状态检查器

执行日志

当前输出

一步一步看设计

01

加载 PR 对象

先按质量影响给变更文件分层,再进入推理。

上下文分诊
02

附加团队规范

把编码规则和项目约定固定进上下文。

分层记忆
03

路由审查深度

Lint 类问题走快路径,风险变更走深度审查。

复杂度路由
04

生成评论

输出包含文件、级别和理由的简洁 review comment。

提示链
05

应用质量门

只有当质量或发布风险越过阈值时才阻断。

审批门控
06

暴露证据链

展示文件路由、规则来源、评分和门控理由。

可观测性 Harness

截图

命令行输出:PR 分诊、审查路由、评论和发布门控。
命令行输出:PR 分诊、审查路由、评论和发布门控。

模式映射

模式设计作用
上下文分诊大 PR 需要先做文件优先级,而不是直接审。
分层记忆团队规范应当是稳定上下文,不该每次临时拼 prompt。
复杂度路由不同审查问题需要不同模型深度。
审批门控系统可以积极评论,但要谨慎阻断。

设计洞察

注意力是第一道质量控制

很多代码审查 Agent 不是推理差,而是错误文件先进了上下文。

记忆让风格变成政策

团队规范要像 pinned memory 一样工作,否则每个 PR 都从零开始。

门控定义自治边界

Review Agent 不拥有 merge 权限,也可以非常有价值。

运行路径

cd workshops/workshop1-code-review python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt python src/main.py open visual/index.html
READMEworkshops/workshop1-code-review/README.md
Blueprintimages/training/visual/workshop1-code-review-blueprint.png