用途:对完整项目或子项目做一次性多维度审查,区别于仅针对 diff 的 review-pull-request 或单领域审查。适用场景包括新代码库上手、持续开发后的周期性健康检查、发布前跨架构/安全/质量/UX 的质量门禁,以及需要将结果直接转为 issue 或迭代计划时。
输入:必填 target_path(待审查代码库或子项目根目录);可选 scope(full 默认、security、architecture、quality、ux)、output_format(findings 仅表格、report 叙述、both 默认)、severity_threshold(LOW 默认、MEDIUM、HIGH、CRITICAL)。
流程分六步:1) 普查,按语言统计文件与行数、识别测试目录、检查依赖与锁文件、记录构建与 CI 状态;2) 架构审查,评估耦合、重复、数据流、分层边界、死代码与约定一致性;3) 安全审计,扫描注入向量(innerHTML、SQL、命令注入)、认证授权、错误处理、依赖 CVE、硬编码密钥、容器安全与本地存储敏感数据;4) 代码质量,检查魔法数字、命名一致性、边界输入校验、错误处理、注释代码与 TODO、测试质量;5) UX 与无障碍(存在前端时),检查 ARIA、键盘导航、焦点管理、响应式断点、WCAG 2.1 AA 对比度与屏幕阅读器兼容;6) 发现汇总,合并为按严重级别排序的表格,含严重级别、阶段、文件、描述与建议修复,并给出考虑依赖关系的修复顺序。
每条发现须标注 CRITICAL/HIGH/MEDIUM/LOW 并引用至少一个文件或目录。阶段间可用 /rest 作为检查点,尤其在第 2 至 5 阶段之间。
限制与注意:大型代码库应聚焦入口点、安全边界与架构接缝,避免逐行审查产生噪声;避免严重级别膨胀,CRITICAL 仅用于可利用漏洞与数据丢失风险;系统性问题应合并为一条架构发现而非多条质量发现;若目标路径为空或不可访问应停止并报告;代码库少于 5 个文件时跳过架构审查;无安全相关代码或无前端时相应阶段标注 N/A;前端无法运行时仅做静态审查并说明未做运行时测试。相关技能包括 security-audit-codebase、review-software-architecture、review-ux-ui、review-pull-request、clean-codebase、create-github-issues。