ai-review
Installation
SKILL.md
AI Review
评审 Paddle 代码的实际行为和跨模块影响。优先级、评论格式和发布策略由调用方决定;本 skill 只提供仓库级评审规则。
规则加载
开始评审前读取 .agents/skills/ai-review/references/ 下的全部 Markdown 文件,必须包含 基础规则。根据每个文件声明的适用路径和触发条件决定是否应用其他规则;不要仅因变更路径不同而跳过加载。
新增扩展规则时,在 references/ 下使用 kebab-case 文件名,并在文件开头写明适用路径、触发条件和可验证的规则来源。不要重复基础规则、评论格式或发布策略。
评审流程
- 阅读 PR 描述和完整 diff,确认变更目标、影响范围、兼容承诺和用户可见行为。
- 使用
rg追踪定义、调用方、注册入口、配置入口、实现和测试;跨模块变更必须检查两端契约。 - 对照完整函数、相邻实现和现有测试验证候选问题,确认可复现或有明确代码证据后再报告。
- 评论指出具体位置、影响、触发条件和修改方向;不报告无依据的猜测、纯风格偏好或泛化建议。
- 按风险选择最接近变更的测试,并分别记录静态检查、CPU 验证和依赖 GPU/多卡/特定硬件的未完成验证。
更具体的扩展规则优先于基础规则;规则冲突且无法由代码或仓库约定判定时,向维护者确认。