用途:审查代码变更,发现原作者可能遗漏的问题,在不制造无谓摩擦的前提下改进代码库;强调真实风险优先于风格噪音。
主要能力:先确定审查范围(查看 git status、相关 diff、用户指定文件或 PR 上下文),判断变更属于前端、后端、库、CLI、基础设施、文档或混合类型,并保留与本次无关的用户改动(除非用户要求修复,否则不修改代码)。审查前先了解项目上下文:框架与语言、测试工具与 CI 覆盖、lint/格式化/类型检查/构建脚本、依赖管理与锁文件,涉及 UI 时还包括可访问性、本地化与设计系统工具。
审查维度:正确性(错误行为、边界情况、数据丢失、错误处理、回归);安全(注入风险、不安全的认证、密钥处理、依赖风险、权限范围);性能与资源(CPU、内存、网络浪费、泄漏、竞态、死锁、异步协调、缺少背压或限流);可访问性(语义 HTML、标签、键盘支持、焦点管理、ARIA 误用、对比度);可维护性(命名、结构、类型安全、可读性、重复、与本地模式契合);测试与文档(新行为缺覆盖、回归测试不足、公开文档过时);依赖(新增包、包体/运行时影响、维护状态、安全状况、是否已有内置或现有工具可替代);设计系统与品牌(token 使用、组件复用、主题一致性与偏离理由);本地化(硬编码 UI 字符串、日期/数字格式、翻译 key、未来翻译流程)。
反馈方式:先列发现并按严重程度排序,仓库内问题给出文件与行号,说明影响并给出具体修复,同一根因的重复问题合并,非阻塞重构标为后续建议而非合并阻塞;无问题则明确说明,并提示残余测试或工具缺口。相关技能仅在 diff 涉及时加载,大型或高风险 diff 可考虑专门子代理,但需把专家反馈整合为一份统一的分级审查。若缺少关键审查基础设施(无可运行测试或 CI 未跑测试、无 lint/格式化/类型检查/构建校验、缺锁文件或依赖未锁定、无可访问性检查、无 i18n 框架等),先作为主要发现报告,再只给出最高置信度的代码发现。
反馈标准:直接、具体、尊重,只针对代码与影响;避免格式化工具或 linter 能处理的吹毛求疵;优先使用项目既有辅助、组件、模式与样式系统;标记与现有实现重复的代码;对晦涩代码提出质疑,偏好可读控制流与命名良好的辅助函数;注释只用于不明显决策与权衡;发现之后可给出真实优点。严重程度:P0 须立即修复(安全漏洞、数据丢失、严重故障、核心行为破坏阻塞合并);P1 合并前应修复(可能 bug、严重回归、可访问性阻塞、不安全依赖/认证、关键测试缺失);P2 重要但可后续(可维护性、边界覆盖不全、性能、重复实现、设计系统漂移);P3 可选改进。输出顺序:按严重程度的发现(含 file:line)、开放问题或假设、简短正面说明、已做或未做的验证;摘要保持简短,发现是审查主体。限制:具体安装命令、平台与价格资料未提供。