SuperAPI AI 工具集

code-review-guide

测试与质量

查看项目

更新于 10-16 06:48

技能介绍

用途:对 Pull Request 或代码 diff 进行结构化代码评审,强调按优先级排序、语气友善、聚焦真正重要的问题,避免只挑风格而漏掉设计缺陷,或堆砌大量未分级的评论。

主要能力:按优先级顺序执行多轮审查,依次检查正确性(是否实现声称功能、边界情况、错误处理、越界、并发)、安全与数据(输入校验、授权、密钥、注入、PII 处理)、设计(方案是否合理、耦合、接缝、更简替代、未来隐患)、测试(是否覆盖行为与边界、能否捕获回归)、可读性(命名、清晰度、死代码、非显而易见处的文档)。评论按严重程度分级:🔴 Blocking、🟡 Should-fix、🔵 Nit/optional,每条包含位置、问题、原因与具体修改建议。最后给出总结、做得好的具体之处,以及明确结论(✅ Approve / 🔁 Request changes / 💬 Comment)并指出阻塞项。

使用方式:需要提供变更(diff/PR 及描述/意图)、上下文(语言/技术栈、约定、涉及系统部分、风险级别),可选提供重点关注项(安全、性能、棘手区域)。若未提供则需先询问。

适用场景:审查代码、给出 PR 反馈、评审某次变更。若只需针对单个变更的检查清单,可用 code-review-checklist;若变更主要由 AI 助手编写,可用 ai-code-review;若变更为 Terraform、CloudFormation 等基础设施代码,可用 infra-as-code-review。

限制:资料未提供具体安装命令、收费方式或平台支持信息。该技能基于资深代码评审实践(Google 工程评审指南),强调先看正确性与设计、分级反馈、保持友善。