SuperAPI AI 工具集

code-review-excellence

测试与质量

查看项目

更新于 10-16 07:22

技能介绍

用途:该技能用于系统化地开展代码评审,把评审从“把关”转变为知识共享,通过建设性反馈、结构化分析和协作改进来提升代码质量与团队协作。适用场景包括评审拉取请求与代码变更、为团队建立评审标准、通过评审指导初级开发者、开展架构评审、创建评审清单与指南、缩短评审周期以及维持代码质量标准。

主要能力:提供评审心态与目标界定(发现缺陷与边界情况、保证可维护性、共享知识、执行编码规范、改进设计架构、建设团队文化;而非炫技、纠结格式、无谓阻塞或按个人偏好重写);给出有效反馈原则(具体可执行、有教育意义而非评判、针对代码而非人、褒贬平衡、区分优先级);明确评审范围(逻辑正确性与边界、安全漏洞、性能影响、测试覆盖与质量、错误处理、文档注释、API 设计与命名、架构契合度;格式、导入顺序、lint 违规和简单拼写交由工具处理)。

使用方式:按四阶段流程执行——上下文收集(读 PR 描述与关联 issue、检查 PR 规模、查看 CI/CD 状态、理解业务需求、记录架构决策);高层评审(架构与设计、文件组织、测试策略);逐行评审(逻辑与正确性、安全、性能、可维护性);总结与决策(汇总关键问题、指出亮点、给出批准/评论/请求修改的明确结论,复杂时提出结对)。写反馈前阅读 references/review-techniques.md,做语言、架构、测试质量或安全评审前阅读 references/review-patterns.md。

限制与注意事项:资料未提供具体安装命令、平台支持、收费或价格信息。技能强调评审应在 24 小时内完成、PR 控制在 200–400 行、单次评审不超过 60 分钟、尽量自动化可自动化的检查,并避免完美主义、范围蔓延、标准不一致、拖延评审、请求修改后消失、橡皮图章和琐碎争论等常见问题。