W2 收官误报率低于 5% 的审查规则库开源经过第二周W2对“误报分类学”、“上下文四层投喂模型”、“AST 触发前置守卫”、“Generator-Critic 双模型对抗反思”、以及“开发者一键申诉回流闭环”的全方位工程化攻坚我们正式发布并开源内部打磨成熟的《AI 前端代码审查规则库 v0.2AI Review Guard Rules v0.2》完整规范与核心规则集。很多团队在尝试自建 AI 代码审查时最大的痛点就是缺乏一套被真实业务打磨过的“低误报规则模板”。直接使用大模型裸奔误报率通常高达 30%50%导致系统迅速荒废。本文全文公开经过数万次真实生产 MR 实测检验、综合误报率严格控制在 4.6% 以下、正样本采纳率高达 94.8%的生产级 AI 审查规则库架构与精选规则 YAML。规则库目录分层架构拓扑在设计这套规则库时我们按照“破坏性严重程度”与“业务关注领域”将规则严格解耦为 5 个核心大类.ai-rules/ ├── manifest.yaml # 全局基础设施底座先验 (Global Manifest) ├── 01-correctness/ # 致命运行时与正确性防线 (Blocker) │ ├── CORR-001-vue-props-destructure.yaml │ ├── CORR-002-async-floating-promise.yaml │ └── CORR-003-stale-closure-hook.yaml ├── 02-security/ # 安全合规与防注入防线 (Blocker) │ ├── SEC-001-xss-v-html-danger.yaml │ └── SEC-002-sensitive-token-leak.yaml ├── 03-performance/ # 渲染与异步性能防线 (Warn) │ ├── PERF-001-forced-reflow-loop.yaml │ └── PERF-002-unbound-observer-leak.yaml ├── 04-architecture/ # 分层架构与依赖守卫 (Blocker/Warn) │ └── ARCH-001-cross-domain-coupling.yaml └── 05-accessibility/ # WCAG 可访问性无障碍防线 (Warn) └── A11Y-001-button-keyboard-focus.yaml核心基石全局底座先验manifest.yaml这是消灭 45% 上下文饥渴型误报的灵魂文件# .ai-rules/manifest.yaml version: 0.2.0 project_context: framework: Vue 3.4 / TypeScript 5.3 (SFC script setup) build_tool: Vite 5.x state_management: Pinia 2.x (Strictly No Vuex) # 全局已有的不可被模型质疑的基础设施约定 invariants: error_handling: description: 全局统一在 /api/client 中配置了 Axios 拦截器与顶层 ErrorBoundary拦截所有网络 4xx/5xx 与超时并自动 Toast。业务函数中严禁强制要求无脑包裹 try-catch auto_imports: description: 全仓开启了 unplugin-auto-import 与 unplugin-vue-components。Vue 核心响应式 (ref, computed, watch)、路由 (useRoute, useRouter) 与 Pinia Store 均已全局自动导入严禁误报未定义 design_system: description: 统一采用自研 design-system/ui。暗黑模式由 CSS 变量 var(--bg-primary) 驱动严禁挑刺硬编码样式除非违反设计规范。精选高价值生产级规则全文规则 1Vue 3defineProps解构丢失响应式CORR-001rule_id: CORR-001-vue-props-destructure category: correctness severity: blocker title: Vue 3 defineProps 解构导致响应式追踪断裂 # AST 前置初筛条件仅当源码包含 defineProps 时才激活模型推理 trigger_guard: contains_keywords: [defineProps] file_pattern: **/*.vue instruction: | 审查代码中是否存在对 defineProps() 返回值进行直接顶层解构赋值的行为。 【必须报警的违规特征】 - const { user, count } defineProps{ user: User, count: number }(); - const { id } props; (在 setup 顶层作用域内直接解构) 【申诉回流沉淀的合法豁免场景 (严禁误报)】 1. 如果代码顶部显式声明了 // vue-reactivity-transform 宏注释属于合法宏解构严禁报错 2. 如果解构出的变量仅在单次 console.log 调试语句中使用后续未在模板或 computed 中引用降级为 info 提醒。 【标准修复代码模板】 使用 toRefs 或 computed 包装 typescript import { toRefs } from vue; const props defineProps{ user: User }(); const { user } toRefs(props);--- ### 规则 2循环内强制同步回流性能黑洞PERF-001 yaml rule_id: PERF-001-forced-reflow-loop category: performance severity: warn title: 循环内连续读写 DOM 几何属性触发 Forced Synchronous Layout trigger_guard: contains_keywords: [offsetWidth, offsetHeight, clientWidth, clientHeight, getBoundingClientRect] instruction: | 审查在循环for, forEach, map, while或频繁触发的高频事件scroll, mousemove中是否存在交替“读取 DOM 几何属性”并紧接着“写入 DOM 样式”的代码模式。 【典型违规特征】 - 在遍历子节点时const h el.offsetHeight; el.style.height h 10 px; 【标准修复策略】 必须实施“读写分离Read-Write Separation” 1. 第一阶段通过 map 批量读取所有 DOM 几何尺寸 2. 第二阶段统一批量写入样式将多次回流合并为 1 次规则 3未清理的全局事件监听与 Observer 内存泄漏PERF-002rule_id: PERF-002-unbound-observer-leak category: performance severity: blocker title: 外部监听器或 Observer 在作用域销毁时未正确注销 trigger_guard: contains_keywords: [addEventListener, ResizeObserver, IntersectionObserver, MutationObserver, setInterval] instruction: | 检查在组件、自定义 Composable 或全局单例中创建的 DOM 事件监听、定时器或 Observer是否在当前生命周期结束时提供了完整的注销清理逻辑。 【必须报警的违规特征】 - 在 onMounted 或 Composable 内部调用了 window.addEventListener(resize, fn)但在 onUnmounted / onScopeDispose 中未执行 removeEventListener - 创建了 new ResizeObserver(...) 但未在组件卸载时调用 observer.disconnect()。 【合法豁免场景】 - 使用了已内置自动清理能力的工具函数如 VueUse 的 useEventListener, useResizeObserver。规则库的工程化接入与执行命令在 CI 门禁脚本中通过轻量级执行器一键调用# 本地 / CI 审查命令 pnpm ai-review --rules-dir .ai-rules/ --diff-only --max-fpr-threshold0.05W2 规则治理收官成果至此在第二周W2的深水区实战中我们建立起了从Manifest 先验 $\longrightarrow$ AST 前置守卫 $\longrightarrow$ Critic 双模型反思 $\longrightarrow$ 申诉回流测试集的全生命周期规则演进体系规则库 v0.2 正式成为团队工程质量基建中最坚实、最可靠的“AI 守门员”。