现场低可见度移动界面审计
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-low-visibility-fix。
技能介绍
要解决什么问题
户外或车间里的移动端界面,问题往往不是「有没有做无障碍」,而是现场可读性:弱光、逆光眩光、戴手套点按、湿手滑动、设备振动时,文字和控件是否还能被快速辨认。本技能面向已有 H5 或小程序页面,在这些现场环境 + 物理操作条件下做可见性审计,并生成给实现方(或另一个 Agent)用的交接文档;不覆盖通用无障碍(a11y)人群场景,遇到应引导到专门流程。
技能如何工作
协议是 分析 → 文档 → 交接,且绝不修改被审计工程。
- 划定范围:确认是对现有移动 UI 的现场低可见度审计;新设计、纯 a11y、泛泛改 CSS 均不在范围内。按
--pages、--selector缩小面,无参数时做有上限的默认扫描。 - 预检与静态分析:在范围内定位
.html/.css或.wxml/.wxss,用scripts/audit.py结合references/design-tokens.json阈值产出确定性结论。 - 有界视觉复核:在移动视口渲染目标页,处理
needs_judgment长尾;视觉结论标为估计值,不编造对比度等数值。 - 产出文档集:默认写入
/.lv-audit/(可配置--out),包含audit.json与report.md;即使零问题也会生成完整「干净」文档。修复建议写在文档里,引用assets/fix-snippets.html等模式,不落地改代码。
边界与注意点
- 输出只能进 out 目录;要求写入目标源码树会拒绝(
OUTPUT_ONLY)。 - 除渲染被审计页面外不发起额外网络。
- 对现场关键控件,不会建议把对比度压到现场阈值以下;会给出合规替代方案。
- 无可用视觉通道时可降级,仍应交付文档;严重级别与交接格式见
rules/audit-protocol.md、rules/handoff-docs.md。
使用场景
- 仓库或户外场景的小程序上线前,对指定 `--pages` 页面做弱光、眩光下的可见性扫描,只生成 `audit.json` 供他人改样式。
- 现场测试反馈某几屏按钮在戴手套时难辨认,用 `--selector` 缩小组件范围跑第二轮审计并更新 out 目录报告。
- 多 Agent 流水线里先跑本技能产出 `report.md` 与修复建议,再由实现 Agent 按文档改 `.wxss`/`.css`,源仓库不被本技能写入。
- 移动 H5 在振动、湿手滑动场景下的表单控件,需要做有界默认扫描并对 `needs_judgment` 项做视觉估计后写入交接文档。
适合人员
- 维护工业或户外小程序的前端,要把弱光与眩光问题整理成可验证文档,且禁止审计流程直接改生产分支里的 WXSS。
- 现场运维类产品的产品经理,需对照 `design-tokens.json` 判断关键控件在手套、湿手操作下是否仍达现场阈值。
- 搭建 Agent 编排的同学,希望审计与实现职责分离:本技能固定只写 `/.lv-audit/`,实现方按 `handoff-docs` 规范接手。
- 负责移动端 H5 发布的 Tech Lead,要在不触发 OUTPUT_ONLY 的前提下把对比度与触控可见性问题交给外包或同事按 snippet 建议修改。