用途：Design QA 是 UI 代码的结构化质量门禁，在交付任何组件、页面或功能前运行。每项检查都是二元结果——通过或失败，报告只列出失败项，无输出即代表质量合格。
主要能力：包含一个扫描脚本和 12 道检查门。扫描脚本覆盖机械性事实，支持人类可读输出、JSON 输出、仅关键项、允许清单和允许空目录等模式；退出码 0 表示无发现破坏当前模式，1 表示有发现，2 表示不可靠（参数错误、缺依赖、缺目标、零支持文件、工具失败或 JSON 无效）。依赖 rg 和 jq，ast-grep 可选（增加 TSX 结构检查）。词法检查覆盖 tsx jsx ts js css scss html vue svelte astro mdx，结构检查仅限 TSX，不跟随符号链接。
12 道门依次为：反模板化（Critical）、排版、颜色、间距、组件复用、交互状态、无障碍、产品状态与边界情况、性能、响应式、错误韧性、实时验证。扫描器只覆盖机械事实，其静默不代表判断类检查通过，需按顺序运行各门并报告失败项与行号及修复建议。
使用方式：运行 bash "$PI_SKILL_DIR/scripts/design-scan.sh" <target-dir>，可加 --json、--critical-only、--allowlist FILE、--allow-empty。若 $PI_SKILL_DIR 未设置，则相对本 SKILL.md 所在目录解析脚本。允许清单为制表符分隔：CATEGORY<TAB>PATH_REGEX<TAB>REASON，类别可精确或 *，无效行退出 2。
适用场景：组件、页面或功能交付前的 QA、审计、评审与加固；快速 PR 评审可用 6 项 Quick-Check。
限制：扫描器仅覆盖机械事实；结构检查仅 TSX；不跟随符号链接；实时验证门需要存在开发/预览命令或提供 URL，且 agent-browser 可响应，否则记为 N-A，N-A 不算通过。具体命令、探针 JavaScript 与证据模式需先阅读 reference/live-verification.md。