HVE Core代码审查Agent实战：PR前6视角审查让缺陷无处遁形

HVE Core代码审查Agent实战：PR前6视角审查让缺陷无处遁形

【免费下载链接】hve-coreA refined collection of Hypervelocity Engineering components (instructions, prompts, agents, and skills) to start your project off right, or upgrade your existing projects to get the most out of GitHub Copilot项目地址: https://gitcode.com/GitHub_Trending/hv/hve-core

HVE Core（hve-core）为 GitHub Copilot 提供了一组工程组件，其中最实用的就是它的Code Review 代码审查 Agent：在你打开 PR 之前，在本地分支上以"功能、规范、无障碍、安全、PR、就绪度"6 个视角并行审查代码变更，输出一份带严重程度分级、修复建议和最终裁决（Verdict）的合并报告。代码还没推上去，缺陷就已经无处遁形了。

为什么要在 PR 前审查？

大多数审查意见都在 PR 合并后才到来，此时上下文切换与返工成本最高。HVE Core 的思路很简单：在本地分支上、代码还"新鲜"的时候就把问题找出来。

💡 官方文档建议在首次使用时选择standard深度 + 1~2 个视角，先熟悉输出格式，再逐步增加视角。详见 Code Review 概览文档。

6 个审查视角：谁负责看哪类问题？

Code Review Agent 是一个"人门控（human-gated）"的编排器（orchestrator）：它只负责调度，每个视角都由一个独立的子 Agent 负责。你可以在 Agent 定义文件 中看到完整的 8 个子 Agent 列表。

两个关键设计让这份审查"不会漏、不会重"：

• 视角与深度独立选择：你可以只跑security单视角 +comprehensive深度，也可以full+basic快速过一遍。
• Lane 隔离：每个子 Agent 收到"只守自己车道"的提示，发现归属另一视角的问题时不重复上报，减少合并报告中的重复项。

审查逻辑本身不写死在 Agent 里，而是放在code-review技能中（上下文引导、深度档位、各视角检查清单、严重程度分级、输出格式），这样升级审查规则只需改技能，Agent 保持稳定。

7 步工作流：人机协同的审查过程

整个流程分 7 步，其中 3 步会暂停等待你的输入（gate）：

1. 上下文引导：pr-reference技能生成结构化 diff，起草变更简报、自动检测热点区域
2. 定向讲解 + 调度板（gate）：给出改动区域、控制流、爆炸半径的事实性走查，你确认或编辑
3. 视角 + 深度选择（gate）：按变更范围预选推荐组合，你最终拍板
4. 准备调度状态：写入diff-state.json与dispatch-manifest.json，保证所有子 Agent 基于同一份输入
5. 人工引导的回溯循环（gate）：你书签某个调度板条目并提问——事实性问题交给 Explainer 子 Agent，深度调研问题交给 Walkback 子 Agent
6. 并行派发视角：所选视角的子 Agent 并发运行，各自把结构化 JSON 发现写入磁盘
7. 合并、回溯与持久化：去重、按严重程度排序、标注来源，写出review.md报告与metadata.json

这个流程的巧妙之处在于**"事实"与"判断"分离**：步骤 2 的讲解只回答"这段代码做什么"，不打严重程度；是否安全、是否正确的判断留到后面。你先拿到一张共享的事实地图，再开始下结论。

在 Copilot Chat 的 Agent 选择器中选中Code Review即可启动（它不是斜杠命令）。默认对比origin/main，可用baseBranch=origin/develop指定其他基线分支。

审查输出长什么样？

每个视角的发现都遵循统一结构：标题 + 严重程度（Critical / High / Medium / Low）、文件路径与行范围、问题代码片段、修复建议、分类与来源标签（如[Functional]）。完整的字段契约定义在 审查输出格式模板 中。

裁决规则一目了然

编排器采用最严格裁决：只要任一视角要求修改，合并报告就要求修改；任何 Critical 发现都会强制request_changes。

用 metadata.json 做 CI 拦截

报告会以两个文件持久化到.copilot-tracking/reviews/code-reviews/{分支名}/：

• review.md：完整合并报告
• metadata.json：机器可读摘要，供 CI、pre-commit 钩子消费——当verdict为request_changes时直接阻止提交，确保发现被处理后才允许代码离开本地分支

上手指南：4 步跑通第一次审查

前置条件：VS Code + 开启 Agent 模式的 Copilot Chat、一个领先基线分支的本地 Git 分支、安装 HVE Core 扩展或插件。

1. 打开 Copilot Chat 的 Agent 选择器，选中Code Review；
2. 确认变更范围（Agent 会自动列出热点文件，可增删）；
3. 选择视角组合与深度档位——新手推荐standard深度 +functional/standards双视角；
4. 在调度板上下书签、提问，走一遍回溯循环后让它完整派发，等待review.md落盘。

两个实用技巧：

• 启动时带上工作项引用（如AB#456），Standards 视角会在报告中附上验收标准覆盖表（已实现 / 部分 / 未找到）；
• 变更涉及 UI/文档时选accessibility与readiness，涉及认证/解析/密钥时必选security——Agent 也会按范围给出推荐预选。

如果你搭建了 Copilot 的 OpenTelemetry 监控（参见 OTel 指标文档），还能在 Grafana 里看到每次审查 Agent 的调用次数与 Token 消耗，让"AI 代码审查"这件事本身也可观测、可量化。

用自定义技能扩展审查能力

Standards 与 Accessibility 视角在审查时动态发现技能：读取 diff 中的文件扩展名，通过语义匹配加载最多 8 个相关SKILL.md，逐条应用检查清单。内置的 python-foundational 技能 覆盖可读性、类型安全、错误处理等 9 大类 30+ 项检查。

扩展方式极其简单：在你自己的仓库.github/skills/coding-standards/下放一个SKILL.md，描述中写清目标语言/框架即可——它会与内置技能叠加（比如公司级python-enterprise+ 基础python-foundational同时生效），每条发现都标注来自哪个技能。无需修改 Agent 本身。完整指南见 语言技能文档。

参考文件清单

小结

HVE Core 的 Code Review Agent 把"PR 前审查"做成了三件可组合的事：多视角并行（6 个车道互不重复）、人机协同（事实讲解与深度调查分轨，全程你说了算）、可执行输出（结构化 JSON 发现 + 三档裁决 + CI 可消费的 metadata）。配合技能化扩展，团队的编码规范、无障碍要求和企业标准都能被审查流程原生覆盖。下次开 PR 之前，先让这 6 个视角过一遍——缺陷在合并前就会被拦下。

【免费下载链接】hve-coreA refined collection of Hypervelocity Engineering components (instructions, prompts, agents, and skills) to start your project off right, or upgrade your existing projects to get the most out of GitHub Copilot项目地址: https://gitcode.com/GitHub_Trending/hv/hve-core