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,完整步骤见官方安装说明。
WorkBuddy 使用专家安装说明,不由 npx 代装。上述命令不构成安装或发布授权。
私密信息与中间数据: 只使用授权材料并对引用脱敏;不需要凭据、不默认建立配置/state/cache。要求保存的交付物写批准位置,临时数据用 OS 临时目录;不将客户原文写进技能仓库。
日志与完成回执: 结果本身是主要交付;说明实际变更或未改动、关键依据与未验证部分,不强制额外报告。