用途:在声称任何构建或评审完成之前,运行一键质量门禁并报告真实的 N/N 结果,避免凭记忆或推断报数。
使用前检查套件是否就绪: 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 或插件安装方式后停止;不要猜测无法打开文件的内容。
运行完整门禁: node ${CLAUDE_SKILL_DIR}/../../../scripts/accuracy_report.mjs 检查项包括 tokens、contrast、spec、no-hardcode、theme-refs、no-emoji、real-render WCAG、state-aware(明暗),全有或全无。需报告其打印出的确切 N/N 行。若未全绿,逐字列出每项失败检查、修复原因(不得屏蔽检查)、重复运行直至全绿;失败期间不得宣布成功。
对本次会话触及的已渲染 HTML,还需运行门禁无法证明的像素真值检查: node ${CLAUDE_SKILL_DIR}/../../../scripts/verify_states.mjs <file> [--dark] node ${CLAUDE_SKILL_DIR}/../../../scripts/verify_responsive.mjs <file> 并执行 RENDER-AND-LOOK:截图测试台、将指针移开、检查每个状态、点击每个控件确认状态变化。
限制与诚实范围:这些门禁只能证明客观正确性(令牌、无障碍、无漂移),不能证明品味;需配合 node ${CLAUDE_SKILL_DIR}/../../../scripts/taste_audit.mjs 与人工评审,绝不可声称美学自动 100% 通过。