SuperAPI AI 工具集

implement-review

编程与开发

查看项目

更新于 10-15 21:40

技能介绍

用途:对代码变更(git diff)做只读审查,检查规格符合性、代码质量与安全性,适合提交前或创建 PR 前的自审,触发语如“审查变更”“做代码审查”。

主要能力:分两阶段审查。①规格符合性:是否满足对应 Issue/PR 的需求与验收条件、是否混入 out-of-scope 实现、是否偏离计划。②代码质量与安全:架构符合性、命名规则、Import 规则、前端(如 React)不必要的重渲染风险与 props 最小化、测试覆盖率;安全项含 OWASP Top 10(XSS、CSRF、注入等)、API 密钥与机密硬编码、输入校验、认证授权、敏感数据处理。

使用方式:先执行 git diff main...HEAD --stat 与 git diff main...HEAD(基线分支按仓库约定,如 main/develop),或针对指定文件/目录。随后通过 Agent 工具委派完成两阶段审查,最后按固定格式输出报告,分“①规格符合性”“②代码质量/安全”两节,标注 ✅ 无问题、⚠️ 需确认/需改进(非阻塞)、❌ 需修正(阻塞),安全问题标注 HIGH/MEDIUM/LOW 与推荐修复。

out-of-scope 处理:审查中发现的当前范围外事项需记录到报告的“排除项”节,经用户批准后才可写操作。查找既有 Issue 用 gh issue list --state open --search "${KEYWORD}";有则用 gh issue comment "${ISSUE_NUMBER}" --body "$(cat <<'EOF' ... EOF)" 追加评论,无则用 create-issue-tree(可加 --root <根issue编号>)或 create-issue 新建,标题用 Conventional Commits 格式。报告时 Issue 编号记为 TBD,起票后另行通知。

限制:原则上只读、不自动修复,仅 out-of-scope 追踪在批准后允许 Issue 写入。存在 HIGH 安全问题时不宣告完成。Step 1〜4 可在 sandbox 执行,需本地存在 base ref;git fetch 与 Issue 操作需网络,须按命令单独关闭 sandbox。向 gh 传参须用 "${var}" 引号与 HEREDOC 防注入。