用途:对 PaddlePaddle 仓库的 Pull Request 和全仓库代码变更进行评审,关注实际行为与跨模块影响。优先级、评论格式和发布策略由调用方决定,本技能只提供仓库级评审规则。
规则加载:评审前读取 .agents/skills/ai-review/references/ 下全部 Markdown 文件,必须包含基础规则;再按各文件声明的适用路径和触发条件决定是否应用其他规则,不要仅因变更路径不同而跳过加载。新增扩展规则时在 references/ 下使用 kebab-case 文件名,并在开头写明适用路径、触发条件和可验证的规则来源,不重复基础规则、评论格式或发布策略。
评审流程:阅读 PR 描述和完整 diff,确认变更目标、影响范围、兼容承诺和用户可见行为;使用 rg 追踪定义、调用方、注册入口、配置入口、实现和测试,跨模块变更检查两端契约;对照完整函数、相邻实现和现有测试验证候选问题,确认可复现或有明确代码证据后再报告;评论需指出具体位置、影响、触发条件和修改方向,不报告无依据猜测、纯风格偏好或泛化建议;按风险选择最接近变更的测试,分别记录静态检查、CPU 验证和依赖 GPU/多卡/特定硬件的未完成验证。更具体的扩展规则优先于基础规则;规则冲突且无法由代码或仓库约定判定时,向维护者确认。
相关技能:涉及专门领域时同时读取对应 skill 的 references,并以实际源码为准,如算子开发用 paddle-op-dev,分布式设计用 paddle-design-distributed,编译用 paddle-build,调试用 paddle-debug、paddle-design-compiler、paddle-eager-graph 或 paddle-phi-kernel。
基本原则:正确性、安全和兼容性优先于格式与命名;分布式、算子和数值路径必须同时检查前向/反向、边界条件及回退路径;行为变化必须有与风险匹配的单卡、多卡或设备覆盖,不能用 mock 掉被测逻辑的测试代替真实验证;只依据源码、测试、文档和可复现运行结果下结论,无法验证时明确说明环境限制。