SuperAPI AI 工具集

code-review-and-quality

编程与开发

查看项目

更新于 10-16 02:33

技能介绍

用途:在合并任意 PR 或变更前进行多轴代码审查,适用于功能实现完成、评估其他智能体或模型生成的代码、重构、以及修复缺陷(含回归测试)之后。审查覆盖五个维度:正确性(是否符合需求、边界与错误路径、测试有效性)、可读性与简洁性(命名、控制流、抽象是否值得、死代码)、架构(是否遵循既有模式、模块边界、依赖方向、抽象层级)、安全(输入校验、密钥不入代码与日志、鉴权、参数化查询、XSS 编码、依赖可信)、性能(N+1 查询、无界循环、同步阻塞、重复渲染、分页、热点大对象)。

主要能力:给出审批标准(当变更明确改善整体代码健康即可批准,不必完美);变更规模建议(约 100 行可一次评审,约 300 行需为单一逻辑变更,约 1000 行应拆分),并区分文件总行数与改动行数;变更描述规范(首行祈使句、正文说明为何改、避免“Fix bug”等反模式);评审流程(先理解上下文,再读测试,再按五轴审实现,最后归类结论);结论分级(无前缀为必需修改,Critical 阻断合并,Nit 可选,Optional/Consider 建议,FYI 仅告知),并按影响力排序,先正确性与安全。还包含多模型评审模式、死代码清理须先询问、评审响应时限(一个工作日内,理想是当天多轮)、冲突处理层级(技术事实优先于偏好,风格指南为准;不接受“以后再清理”)以及依赖审查(优先标准库,检查体积、维护状态、漏洞与许可证)。

使用方式与限制:资料提供了评审检查清单、提示词示例与结论模板,但明确说明未包含两个外部前置文件:references/security-checklist.md 与 references/performance-checklist.md。这些属于外部依赖,需从声明的上游来源或用户安装处获取,并按安装路径解析、检查内容与许可证;在文件不存在前不得运行相关命令或声称已遵循该流程,也不得伪造缺失脚本。其余独立步骤可在授权范围内执行,依赖步骤应报告为不可用。安装命令、收费与价格等信息资料未提供。