用途:为任何设计或 UI 工作提供统一的“院内规则”,在动手写第一行设计之前先阅读,再按领域加载对应规则文件。它本身是一个技能(skill),会从工具包中读取 tokens 与脚本。
主要能力:验证协议要求“跑门禁、不报未经测量的数字”,任何对比度、WCAG 通过或 100% 结论必须来自门禁的真实输出,未跑则说“尚未验证”。验证覆盖所有状态而非仅静止态,脚本 verify_states.mjs 测量 default、hover、focus;accuracy_report.mjs 给出真实的 N/N 结果;verify_responsive.mjs 检查 280/320/414px 无横向溢出;verify_mobile_first.mjs 移除所有 @media/@container 后在 320px 渲染以判定移动优先;lint_native_select.py、slop_tells.mjs、check_no_emoji.py、lint_intent.mjs 分别检测原生 select、单侧彩色描边、emoji 与令牌意图。
必要用法:首次检查工具包是否就位,运行 ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING;若为 KIT_MISSING(仅安装了技能文件夹,npx skills add 即如此),应直接说明并引导用户使用 npx ux-ui-agent-skills init 或插件安装后停止,不得猜测无法打开文件的内容。渲染门禁在未装浏览器时会打印 SKIPPED 并以 0 退出,可用 DS_REQUIRE_BROWSER=1 使其变为必需并失败,再用 npx playwright install chrome 修复。完成前运行 accuracy_report.mjs 并报告真实 N/N 行,它是全有或全无。
适用场景与限制:适用于设计令牌、组件、编码、评审、可访问性审计、品牌与重设计等设计 UI 工作流,配合 /critique、/gate、/grill-me 等使用。门禁只证明客观正确性,不证明品味;品味需人为判断。规则还规定移动优先、禁止原生 select 与单侧彩色描边、零 emoji、令牌单一来源、八种交互状态、输出完整等;部分脚本细节与具体配置文件未在资料中给出。