代码审核助手

解决什么问题

普通代码审核容易停留在风格检查，缺少对业务逻辑、安全上下文和测试覆盖的持续判断；直接靠人肉读 PR 又难在安全、性能、错误处理、测试、文档之间保持同一标准。code-reviewer 面向 PR/diff、现有代码库审计和合并前检查，把确定性脚本结果与模型上下文推理结合，输出带 Critical 到 Info 分级的可执行问题列表。

工作方式

它按四阶段推进：

• 范围与计划：识别单文件、目录、git diff 或 PR，判断语言和审核深度。
• 自动化分析：当 Python 可用时，运行 analyze_complexity.py 检测过长函数、圈复杂度、深层嵌套；运行 scan_patterns.py 扫描 SQL 注入、命令注入、硬编码密钥、eval、弱哈希、XSS 等反模式。
• 上下文审核：基于 checklist.md、security-rules.md、best-practices.md、severity-guide.md 排除误报，并检查模式匹配难以覆盖的问题，如授权缺失、竞态条件、资源泄漏、错误传播、测试隔离和文档缺口。
• 报告与建议：按严重性分级，生成可选 HTML 报告，并在对话中给出合并前必须修复项和后续跟进项。

适用边界

该技能适合工程团队在 PR 审查、安全审计和质量门禁中使用。它不是编译器或完整 SAST 替代品：脚本不可用时会退化为基于参考文档的人工检查；模式扫描仍可能有误报，需要结合代码上下文确认。对于历史代码库，应优先关注高风险影响面，而不是把所有风格问题都作为合并阻塞项。