iter(f01): 组件数漂移纳入 verify 门禁并修正文档

packages/tools/cli/bin/ua.js

@@ -593,6 +593,23 @@ function checkReadme(pkgs) {
   return issues;
 }
 
+/*** 组件数漂移校验：AGENTS.md / ARCHITECTURE.md 中的「N 个组件」必须与 skin-dom 清单实际总数一致 ***/
+function checkCountDocs(actual) {
+  const issues = [];
+  const re = /(\d+)\s*个(?:\s*DOM\s*)?组件/;
+  for (const name of ['AGENTS.md', 'ARCHITECTURE.md']) {
+    const file = path.join(ROOT, name);
+    if (!fs.existsSync(file)) continue; // 卫语句：文档缺失不校验
+    fs.readFileSync(file, 'utf8').split(/\r?\n/).forEach((line, i) => {
+      const m = line.match(re);
+      if (m && Number(m[1]) !== actual) {
+        issues.push(`${name}:${i + 1} 组件数「${m[1]}」与清单实际 ${actual} 不一致，请同步`);
+      }
+    });
+  }
+  return issues;
+}
+
 /*** 清单一致性校验：组件文档块的 id / props 说明 / demo 锚点必须与代码和演示产物对齐 ***/
 function cmdVerify() {
   const issues = [];
@@ -628,6 +645,10 @@ function cmdVerify() {
     }
   }
 
+  const skinTotal = pkgs // skin-dom 清单组件总数，供文档数字漂移校验
+    .filter((p) => p.type === 'skin-dom')
+    .flatMap((p) => p.docs?.components ?? []).length;
+  issues.push(...checkCountDocs(skinTotal));
   issues.push(...checkReadme(pkgs));
 
   if (issues.length) {