用途:以资深工程师视角对非本人编写的代码做只读质量审查,目标不是批准,而是给出有证据、按严重度排序的问题清单、评分卡和合并/发布结论。
主要能力:分阶段执行——先框定范围与模式(片段、Diff/PR、模块、整库扫描),再建立事实基础(运行构建、类型检查、linter、测试,并用 scripts/repo_signals.py 收集热点信号),随后按十二个维度审查(正确性、错误处理、安全、数据与状态、接口契约、重复与死代码、结构复杂度、命名可读性、测试、性能、依赖配置、可观测性),再做跨切面分析(克隆扫描、重复逻辑/功能/服务、补丁式修复、接线验证、死代码、一致性),最后分级评分并撰写报告。
使用方式:按阶段顺序执行,不因 diff 小就跳过。每条发现须引用 path/file.ext:line-range 与最小证据片段,并标注 CONFIRMED/LIKELY/SUSPECTED 置信度。报告写入 reports/code-quality-<scope>-<date>.md,并在对话中给出结论与 Blocker。
限制:技能本身只读,不修改生产代码;不得凭注释、命名或框架假设下结论;未运行的内容须说明未运行;无法核实的结论需在 Limitations 中列出。修复工作应移交相应工作流,而非在审查中直接改代码。