SuperAPI AI 工具集

code-review

测试与质量

查看项目

更新于 10-15 20:32

技能介绍

用途:在代码写完后、提交之前进行校验,或在用户要求代码审查或安全检查时使用。该技能运行在隔离的 code-reviewer 上下文中,并预加载相关标准。

主要能力:审查覆盖安全、正确性与代码质量。按严重程度分级输出结构化结果:CRITICAL(安全类,如 SQL 注入、XSS、命令注入、硬编码凭据、路径遍历、鉴权绕过)、HIGH(正确性,如缺少错误处理、类型不匹配、空值/未定义缺口、逻辑错误、竞态条件)、MEDIUM(可维护性,如命名违规、重复代码、组织混乱)、LOW(性能优化、文档改进等建议)。每条发现包含问题、风险与带代码差异的修复建议,并给出总体建议:APPROVE、REQUEST CHANGES 或 COMMENT。

使用方式:先由主智能体预加载标准文件(.opencode/context/core/standards/code-quality.md 与 .opencode/context/core/standards/security-patterns.md),再调用审查,例如:/code-review path/to/file.ts、/code-review src/auth/*.ts、/code-review $(git diff --name-only HEAD~1)。随后分析报告并采取行动:存在 CRITICAL 或 HIGH 时停止提交,按建议差异修复后重新审查;仅 MEDIUM 或 LOW 时自行评估是否修复;无问题时提交并记录良好模式。调用时需声明:“I'm using the code-review skill to validate [files/feature].”

适用场景:提交前校验、按文件或模式批量审查、对最近一次提交的改动文件进行审查。

限制:该审查不修改代码,仅提出建议;不运行测试,测试由 test-generation 处理。审查失败时需确认上下文文件已预加载;发现过多时先修复 CRITICAL 再复审;发现不明确时在报告中请求澄清。若出现“代码看起来没问题,审查多余”“是我写的所以我知道正确”“时间紧可以稍后再审”“改动小没有安全风险”等想法,应立即停止并重读该技能说明。