Structured PR Review
分层PR代码审查,三级严重度+寻址模式
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Structured PR Review。 它的用途是:分层PR代码审查,三级严重度+寻址模式 完整的 Skill 内容见:https://321skill.com/skills/structured-pr-review-x-6/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请使用 Structured PR Review 工具审查这个 PR,按照 MUST FIX、SHOULD FIX、SUGGESTION 三个层级输出结果,并标注寻址模式。' 它会自动拉取当前 PR 的代码变更,逐条分析并生成结构化报告,例如在 MUST FIX 下指出硬编码密钥,在 SHOULD FIX 下建议提取公共方法。
介绍
在代码审查过程中,团队成员常常面临缺乏统一标准、优先级混乱、反馈难以落地的问题。Structured PR Review 提供了一套结构化的分层审查方案,通过 MUST FIX(必须修复)、SHOULD FIX(建议修复)、SUGGESTION(仅供参考)三个严重级别,结合寻址模式(addressing-mode),让每条审查意见都清晰可执行,避免无意义的争吵和遗漏。
使用方式极为简单:默认基于 GitHub CLI(gh)运行,无需安装额外服务。你只需在终端执行一条命令,工具会自动拉取当前 PR 的变更内容,按照预设规则分析,并输出分层审查报告。可选集成 Lobster pipeline,实现更复杂的自定义规则和自动化流程,适合团队统一规范。
本工具主要面向需要频繁进行代码审查的研发团队,包括后端开发、前端开发、测试工程师和项目经理。特别适合中大型项目,其中 PR 数量多、参与者众,需要一套可复用的质量门禁。对于个人开发者或小型项目,也能帮你养成结构化审查的习惯,提升代码质量。
建议在团队中统一配置严重级别阈值和寻址模式规则,并集成到 CI/CD 流程中自动触发审查。注意工具默认仅支持 GitHub 平台,若使用其他代码托管平台需通过 Lobster pipeline 扩展。初次使用时,建议先在小范围 PR 上试用,逐步调整规则以匹配团队风格。
核心特点
与普通 PR 审查工具不同,Structured PR Review 明确将每条意见划分为 MUST FIX / SHOULD FIX / SUGGESTION 三级,并附带寻址模式(addressing-mode),让审查结果不仅指出问题,还给出优先级和修复方向,极大减少沟通成本。
注意事项
目前仅支持 GitHub CLI 原生运行,如需支持 GitLab 等平台必须通过 Lobster pipeline 扩展,且暂时不支持可视化界面。
常见问题
如何自定义 MUST FIX 的判定规则?
可以通过配置文件(如 .structured-pr-review.yml)定义规则,包括代码规范、安全漏洞、性能问题等不同维度的严重级别映射。
是否支持 GitLab 或其他平台?
默认仅支持 GitHub CLI,但可通过 Lobster pipeline 集成其他平台,或自行编写适配器。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/structured-pr-review-x-6/raw/index.md 读取 Structured PR Review 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/structured-pr-review-x-6/raw/index.md(查看排版版本)