PR代码审查与评审报告生成
读取本地检出的代码差异与PR描述文件,从正确性、安全漏洞和测试规范维度进行审查,并输出供自动化流水线发布的结构化 review.json 文件。
功能与用途
该能力专为代码仓库流水线或本地代码审查设计。它直接读取本地检出的 PR 差异文件(如 pr_diff.txt)与描述信息,基于差异行号标注系统严格比对变更内容,重点检查代码逻辑正确性、安全缺陷、错误处理边界以及测试和注释规范。审查产物不直接推送到 GitHub,而是按照规范格式生成包含行级建议代码块(suggestion block)和总体判决(APPROVE 或 REJECT)的 review.json 文件,并提供内置脚本进行格式合法性校验。
适用场景
- CI/CD 流水线自动化代码审查:在自动化工作流拉取 PR 差异后,执行自动代码扫描与行级审查,生成供评论机器人统一推送到 GitHub 的结构化 review.json 结果。
- 本地代码提交前预检:开发者在提交或合并分支前,通过比对差异文件识别逻辑漏洞、未覆盖的异常分支或缺少测试的新增路径,快速修正代码。
- 需求规格与实现一致性审查:结合 spec_context.md 规格文档比对代码变更,确认代码实现是否与设计规范保持一致,标记规格偏离与破坏性变更。
适用人群
- 软件工程师
- 开源项目维护者
- DevOps 与 CI/CD 流程工程师
- 敏捷研发团队负责人
使用步骤
- 确保 PR 分支代码已检出,并已导出带有行号标注的 pr_diff.txt 与 pr_description.txt。
- 触发审查指令,根据代码正确性、安全性、测试覆盖及项目规范对差异代码逐行分析。
- 按照规范格式生成包含总体结论与精准行级行号的 review.json 文件。
- 运行 validate_review_json.py 校验脚本验证 review.json 的合法性与行号对应关系,确保满足发布标准。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Review a pull request diff and write structured feedback to review.json for the workflow to publish. Use when reviewing a checked-out PR from local artifacts like pr_diff.txt and pr_description.txt and producing machine-readable review output instead of posting directly to GitHub.
依赖与权限
- 读取用户主动提供的内容