企业官网建设流程全解析

W2 收官：误报率低于 5% 的审查规则库开源

经过第二周（W2）对“误报分类学”、“上下文四层投喂模型”、“AST 触发前置守卫”、“Generator-Critic 双模型对抗反思”、以及“开发者一键申诉回流闭环”的全方位工程化攻坚，我们正式发布并开源内部打磨成熟的《AI 前端代码审查规则库 v0.2（AI 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) 驱动，严禁挑刺硬编码样式除非违反设计规范。"

精选高价值生产级规则全文

规则 1：Vue 3defineProps解构丢失响应式（CORR-001）

rule_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-002）

rule_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-threshold=0.05

W2 规则治理收官成果

至此，在第二周（W2）的深水区实战中：

• 我们建立起了从Manifest 先验 $\longrightarrow$ AST 前置守卫 $\longrightarrow$ Critic 双模型反思 $\longrightarrow$ 申诉回流测试集的全生命周期规则演进体系；
• 规则库 v0.2 正式成为团队工程质量基建中最坚实、最可靠的“AI 守门员”。