# Soia Dev Audit UI

> 只读验收界面，将布局、键盘等技术证据与 UX、视觉判断分开报告。触发：验收这个界面、检查键盘和布局、评审视觉与体验

- Skill: `soia-team/soia-dev-audit-ui` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add soia-team/soia-dev-audit-ui`
- Raw SKILL.md: https://api.skillmd.com/api/skills/soia-team/soia-dev-audit-ui/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: soia-team (https://skillmd.com/u/soia-team)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/soia-team/soia-dev-audit-ui

---


# soia-dev-audit-ui

## 客户可读说明

**能做什么：** 对固定页面、原型或截图做一次聚焦验收，给出可复现的问题和优先修复建议。默认只读，不自动改页面。

**如何使用：** 提供目标、版本/入口、用户任务及已批准设计。按请求选技术验收、UX/视觉判断或两者；两个结果分开，不用 lint、截图或主观观感互相替代。

## 技术验收

在真实可运行页面上走目标路径，按影响检查：

- 布局与状态：目标宽度、缩放、长内容、空/加载/错误/权限状态下的溢出、遮挡与可操作性。
- 键盘与语义：可访问名称、焦点可见和顺序、菜单/对话框进入与退出、Escape、关闭后焦点恢复；不能仅检查 DOM 属性。
- 跨端与主题：同一任务语义、对比度、文字与控件可读性、触控目标和减少动态效果。
- 接缝：真实路由、遮罩/portal、滚动、事件传播及异步反馈。项目指定的自动化门照常执行，测试通过不替代上述运行检查。

只有截图时只判断截图可见内容，键盘、状态和实际交互标为未验证；不据此断言可访问性通过。

## UX / 视觉判断

围绕用户是否能理解当前状态并完成任务，检查信息层级、主次动作、文案、排版节奏、密度、间距、品牌与跨页一致性。区分已批准设计违反、可观察的使用障碍和偏好建议；不要把个人审美包装成缺陷。

## 输出与边界

问题写明位置/状态、复现方式或视觉证据、影响与建议。按影响排序，只报能定位的问题；不固定评分、问题数量、审计面板或多 Agent 对抗。无问题就说明检查范围，不制造工作。

报告分别列实际技术证据、UX/视觉判断和未验项。获准修复是下一项实施，不因发现问题自动修改、提交或发布；无需为纯验收创建文件。

## 使用边界

### 依赖与安装

无强制第三方技能依赖；读取或编辑所选材料的能力由宿主提供。
默认项目单技能：`npx skills add soia-team/soia-open-dev-skills -a <agent> -s soia-dev-audit-ui`，执行前核实当前参数。
整域需明确选择：Claude Code 使用 `claude plugin marketplace add` / `claude plugin install soia-dev@soia`，Codex 使用 `codex plugin marketplace add` / `codex plugin add soia-dev@soia`；市场为 soia-team/soia-open-skills，完整步骤见[官方安装说明](https://github.com/soia-team/soia-open-skills#安装)。
WorkBuddy 使用[专家安装说明](https://github.com/soia-team/soia-open-skills/blob/main/docs/install/workbuddy.md)，不由 npx 代装。上述命令不构成安装或发布授权。

**私密信息与中间数据：** 只使用授权材料并对引用脱敏；不需要凭据、不默认建立配置/state/cache。要求保存的交付物写批准位置，临时数据用 OS 临时目录；不将客户原文写进技能仓库。

**日志与完成回执：** 结果本身是主要交付；说明实际变更或未改动、关键依据与未验证部分，不强制额外报告。