ai-pr-analysis-companion

Polar Sponsor
爱发电 赞助
.NET 9.0

AI 智能代码变更分析助手 — 自动分析 GitHub PR 改动范围、技术债务、测试覆盖风险,生成结构化评审报告

AI 智能代码变更分析助手

功能概述

AI 智能代码变更分析助手是一项面向实际任务的技能,主要用于GitHub PR 链接 → 自动抓取代码变更 → AI 结构化分析 → 技术债务识别 + 风险评估 + 评审建议 → 飞书报告输出;🎯 解决痛点;

核心要点

  • ❌ PR 代码量大时,人工 review 精力有限,容易遗漏关键问题;
  • ❌ 改动涉及多个模块,不知道哪些地方需要重点关注;
  • ❌ 新人 review 不熟悉代码库,很难判断改动的影响范围;

使用与执行

❌ 评审没有结构性,全凭个人经验。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

结果检查与注意事项

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。

AI 智能代码变更分析助手

GitHub PR 链接 → 自动抓取代码变更 → AI 结构化分析 → 技术债务识别 + 风险评估 + 评审建议 → 飞书报告输出

🎯 解决痛点

  • ❌ PR 代码量大时,人工 review 精力有限,容易遗漏关键问题
  • ❌ 改动涉及多个模块,不知道哪些地方需要重点关注
  • ❌ 新人 review 不熟悉代码库,很难判断改动的影响范围
  • ❌ 评审没有结构性,全凭个人经验,结果参差不齐
  • ❌ 技术债务无法量化,项目越来越难维护

💡 解决方案

[GitHub PR URL]
          ↓
┌──────────────────────┐
│  github             │ → 抓取 PR diff、文件列表、评论历史
└────────┬─────────────┘
         │ PR 元数据 + 变更摘要
   ┌─────▼──────────┐
   │  summarize     │ → AI 结构化分析:改动类型/影响范围/风险点
   └─────┬──────────┘
         │ 分析结果
   ┌─────▼──────────────────┐
   │  code-review-skill      │ → 聚焦代码质量问题、测试覆盖、潜在 Bug
   └─────┬──────────────────┘
         │ 评审结论
   ┌─────▼──────────┐
   │  feishu_doc    │ → 生成结构化报告,发布至飞书文档
   └───────────────┘

📦 包含 Skills

Skill 作用 调用时机
github 抓取 PR diff、文件列表、评论历史 Step 1
summarize AI 结构化分析:改动类型、影响范围、风险点识别 Step 2
code-review-skill 聚焦代码质量、测试覆盖、潜在 Bug 检测 Step 3
feishu_doc 生成结构化报告并发布至飞书文档 Step 4

🔧 前置要求

  1. github CLI:已配置 gh auth login
  2. 飞书机器人:已配置 feishu_doc 写入权限

📝 使用方法

触发方式

分析PR 
代码变更分析 
PR评审 

完整示例

输入:

分析PR https://github.com/owner/repo/pull/123

执行流程:

  1. Step 1 PR 数据抓取(github)

    • gh pr view 123 --repo owner/repo --json title,body,files,additions,deletions,changedFiles
    • gh pr diff 123 --repo owner/repo 获取完整 diff
    • gh api repos/owner/repo/pulls/123/comments 抓取历史评论
  2. Step 2 结构化分析(summarize)

    • 分析改动的模块和文件,识别影响范围
    • 识别高风险改动:数据库迁移、认证逻辑、并发处理、API 契约变更
    • 量化改动规模:文件数、行数增删、涉及语言/框架
  3. Step 3 代码质量评审(code-review-skill)

    • 分析代码风格、命名规范、安全隐患
    • 评估测试覆盖是否充分
    • 指出潜在 Bug、性能问题、边界 case 遗漏
    • 识别技术债务:重复代码、硬编码、缺少注释
  4. Step 4 报告生成与发布(feishu_doc)

    • 生成结构化评审报告,包含:
      • PR 基本信息摘要
      • 改动范围量化
      • 风险评级(高/中/低)
      • 问题清单与修复建议
      • 技术债务评估
    • 发布至飞书文档,支持团队协作评论

📊 报告模板

# PR 评审报告

## 基本信息
- **PR 标题**:xxx
- **作者**:xxx
- **改动规模**:+xxx/-xxx 行,xx 个文件
- **评审时间**:yyyy-mm-dd

## 改动范围摘要
[AI 提取的核心改动说明]

## 风险评级
🟡 中等风险
- 涉及认证模块改动
- 缺少新增功能的单元测试

## 问题清单
1. **[高]** xxx 文件第 xx 行:潜在空指针风险
2. **[中]** xxx 文件:硬编码配置应抽取至配置文件

## 技术债务
- 发现 2 处重复代码,建议抽取为公共方法
- xxx 模块缺少注释,建议补充文档

## 总结建议
[综合评价与合并建议]

风险评级标准

级别 说明 触发条件
🔴 高风险 需重点审查,可能影响线上稳定性 涉及 DB 迁移、认证/鉴权、支付、并发
🟡 中风险 建议关注,可能存在隐藏问题 涉及核心业务逻辑、公共模块改动
🟢 低风险 改动较小或仅有文档/测试更新 仅文档修改、测试补充、依赖更新

⚙️ 配置说明

如需分析私有仓库 PR,需确保:

gh auth login --hostname github.com
gh auth status

相关专题

更多
OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

0

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

0

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

0

10

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

0

15

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

2026.10.16

0

15

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

2026.10.16

0

15

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

2026.10.15

0

20

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

2026.10.15

0

18

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

2026.10.15

0

20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.7万人学习