用途
这是一个多智能体拉取请求(PR)审查工作流,适用于用户请求“审查我的 PR”“合并前检查我的代码”“运行 PR 审查”“分析这个拉取请求”等场景。它的目标是在合并前从多个维度检查代码质量,并将各专项代理的发现汇总为一份可执行的审查摘要。
主要能力
技能内置六个专项审查代理,各自聚焦代码质量的不同方面:
- code-reviewer:对照项目 CLAUDE.md 中的规范检查代码,进行基于置信度的过滤(仅报告置信度不低于 80 的问题),检查 CLAUDE.md 合规性、缺陷检测与代码质量,并按严重程度分组(Critical:90-100,Important:80-89)。始终适用。
- pr-test-analyzer:关注行为覆盖而非行覆盖,识别必须测试的关键代码路径、边界情况和错误条件。对关键性按 1-10 打分并映射严重程度(9-10 为 CRITICAL,7-8 为 HIGH,5-6 为 MEDIUM,1-4 为 LOW)。测试文件变更时适用。
- silent-failure-hunter:分析静默失败、空 catch 块、过宽的异常捕获、不充分的错误信息以及无正当理由的回退行为。检查日志质量、用户反馈、catch 块的具体性和错误传播。错误处理变更时适用。
- type-design-analyzer:从四个维度评估新增类型(每项 1-10 分):封装、不变量表达、不变量有用性、不变量强制。标记贫血领域模型、暴露可变内部状态、缺少构造校验等反模式。类型新增或修改时适用。
- comment-analyzer:对照代码验证注释的事实准确性,评估完整性,评判长期价值,并识别误导性内容。将发现归类为关键问题、改进机会和建议移除项。注释或文档新增时适用。
- code-simplifier:在不改变功能的前提下简化代码,提升清晰度与可维护性。应用项目规范,减少不必要的复杂度,消除冗余代码,改进命名。避免嵌套三元表达式和过度紧凑的写法。通常在通过审查后使用。
使用方式
工作流分为四步。
第一步:确定审查范围
- 检查 git 状态以识别变更文件:git diff --name-only
- 检查是否已存在 PR:gh pr view
- 解析用户指定的审查方面
- 默认:运行所有适用的审查
第二步:识别适用审查
根据变更内容判断:
- 始终适用:code-reviewer(整体质量)
- 测试文件变更:pr-test-analyzer
- 注释/文档新增:comment-analyzer
- 错误处理变更:silent-failure-hunter
- 类型新增/修改:type-design-analyzer
- 通过审查后:code-simplifier(打磨与精简)
第三步:启动审查代理
- 顺序方式(默认):一次一个代理,更易理解和执行,每份报告完成后再进行下一个,适合交互式审查。
- 并行方式(用户要求时):同时启动所有代理,全面审查更快,结果一起返回。
第四步:汇总结果
代理完成后,按如下结构组织发现:
PR 审查摘要
Critical Issues(X found)
- [agent-name]:问题描述 [file:line]
Important Issues(X found)
- [agent-name]:问题描述 [file:line]
Suggestions(X found)
- [agent-name]:建议 [file:line]
Strengths
- 此 PR 中做得好的地方
Recommended Action
- 先修复关键问题
- 处理重要问题
- 考虑建议项
- 修复后重新运行审查
使用模式
- 完整审查(默认):根据变更文件运行所有适用的审查代理。
- 针对性审查:指定关注的方面,如 tests、errors、comments、types、code、simplify。
- 并行审查:要求所有代理同时运行以获得更快结果。
工作流集成
- 提交前:编写代码 → 运行代码与错误审查 → 修复关键问题 → 提交。
- 创建 PR 前:暂存所有变更 → 运行所有审查 → 处理关键与重要问题 → 重新运行特定审查以验证 → 创建 PR。
- 收到 PR 反馈后:按请求修改 → 根据反馈运行针对性审查 → 验证问题已解决 → 推送更新。
提示
- 尽早在创建 PR 之前运行审查。
- 代理默认分析 git diff。
- 优先处理关键问题,再处理较低优先级问题。
- 修复后重新运行审查以验证问题已解决。
- 当已知关注领域时,使用针对性审查。
- 所有代理都会返回带具体 file:line 引用的可执行结果。
限制
本技能的具体安装方式、支持的平台、收费情况以及实际效果,资料中暂未提供。