Agent Skills
返回列表
现场低可见度移动界面审计

现场低可见度移动界面审计

设计多媒体 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-low-visibility-fix。

技能介绍

要解决什么问题

户外或车间里的移动端界面,问题往往不是「有没有做无障碍」,而是现场可读性:弱光、逆光眩光、戴手套点按、湿手滑动、设备振动时,文字和控件是否还能被快速辨认。本技能面向已有 H5 或小程序页面,在这些现场环境 + 物理操作条件下做可见性审计,并生成给实现方(或另一个 Agent)用的交接文档;不覆盖通用无障碍(a11y)人群场景,遇到应引导到专门流程。

技能如何工作

协议是 分析 → 文档 → 交接,且绝不修改被审计工程。

  1. 划定范围:确认是对现有移动 UI 的现场低可见度审计;新设计、纯 a11y、泛泛改 CSS 均不在范围内。按 --pages、--selector 缩小面,无参数时做有上限的默认扫描。
  2. 预检与静态分析:在范围内定位 .html/.css 或 .wxml/.wxss,用 scripts/audit.py 结合 references/design-tokens.json 阈值产出确定性结论。
  3. 有界视觉复核:在移动视口渲染目标页,处理 needs_judgment 长尾;视觉结论标为估计值,不编造对比度等数值。
  4. 产出文档集:默认写入 /.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 建议修改。