用途:对代码进行综合审查,覆盖质量、安全、可维护性,并校验是否符合架构决策(ADR)与规格(SPEC)。
主要能力:静态分析(pylint、ruff、flake8、mypy、pyright,检查 PEP 8、复杂度、代码坏味);安全扫描(bandit、safety、semgrep,检测 SQL 注入、XSS、CSRF、硬编码密钥、OWASP Top 10、CWE);最佳实践(SOLID、DRY、错误处理、资源管理);覆盖率分析;ADR/SPEC 合规;性能分析(N+1 查询、低效算法);文档质量;自动修复建议。
使用方式:命令行调用,如 code-review analyze --file src/auth/service.py、--module src/auth、--diff HEAD~1..HEAD、--auto-fix。可集成 CI/CD,示例工作流在 pull_request 时运行 code-review analyze --diff origin/main..HEAD,并按评分阈值(如低于 70 退出失败)设置质量门禁。
适用场景:提交前审查、模块审查、Git 变更审查、CI 质量门禁。
限制:无法理解业务逻辑意图;可能误报,需人工复核;不能检测所有安全漏洞;性能分析限于明显模式;ADR/SPEC 合规需手动定义规则;需安装配置相关工具。评分权重与阈值、报告保存路径等细节以资料为准。