用途:当用户要求代码审查、包审查或架构审计时使用。默认只做分析,除非用户明确要求修改代码。目标是高信号、可执行、有证据的发现,而非面面俱到的评论。
主要能力:按严重程度(Critical、High、Medium、Low)排序输出发现,每条包含 Impact、Evidence、Fix,必要时附 Trade-off。审查维度包括架构、可读性、可维护性、正确性与边界情况、性能、安全;性能与安全仅在相关或有具体证据时才作为维度。支持包/组件级审查与应用级审计两种模式。
使用方式:先界定范围,推断目标路径、包、组件或变更文件,范围不清时才询问;明确列出排除项。先读目录结构、入口与支撑文件,再读项目根目录的 CLAUDE.md、AGENTS.md 等约定文件,遵循本地约定优先于框架默认。发现按严重程度与置信度排序,弱点在前,优点可选且简短。报告结构依次为 Scope Reviewed、Findings、Top Architectural Risks(仅广泛审查)、Top Refactor Priorities(仅广泛审查)、Next Sprint Action Plan(仅广泛审查)、Maintainability Risk、Cross-Boundary Coupling Risk。报告保存为应用根目录下的 code-review-{agent}-YYMMDD.md,重名时追加 -2、-3 等,聊天中只返回简短摘要与报告路径。
限制:不报告与项目指引或已记录例外冲突的发现;可疑但可能是有意为之的内容以问题或假设形式提出,而非缺陷;不把偏好差异当作发现;内部方法若无效输入已在调用边界拦截,不标记缺少空值防护;不报告低价值或重复发现;Impact 与 Fix 各限一句,除非 Critical 需要更长说明;不使用内联审查指令,除非用户明确要求;无发现时明确说明,并以散文形式提及残余风险、未审查区域或测试缺口,不用发现格式填充通用最佳实践。