ux-audit-skill

Name: ux-audit-skill
Author: sergekostenchuk

github.com/sergekostenchuk设计与 UI3263 次安装18 周前更新

代码仓库

关于 ux-audit-skill

ux-audit-skill 用于基于证据审查现有 UI，并生成严重性矩阵和可执行的重构说明。它面向需要评估网页、截图或源代码的设计与开发工作流，并明确区分证据类型与结论边界。

主要功能

01审查在线页面、截图和代码
02生成严重性矩阵与修复建议
03标注每项发现的证据类型
04比较前后证据并检查回归

适用场景

01根据截图评估界面问题
02审查现有页面或源文件
03将审查发现整理为实现任务
04验证改动后的回归风险

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill ux-audit-skill

安装后在 Claude Code 中输入/ux-audit-skill确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/

openai.yaml

assets/

audit-report.template.md

regression-report.template.md

evals/

evals.json

references/

audit-evidence-model.md

mobile-touch-rubric.md

severity-model.md

wcag-quick-ref.md

详细介绍

UX 审查技能

使用此专业工具，基于证据审查现有 UI 产物。输出应为严重性矩阵和可执行的重构简报，而非泛泛的设计文章。

操作模式

review-live-url：使用可用的浏览器／静态证据审查可访问的 URL。
review-screenshot：在仅有图像的上下文中进行审查，不对 DOM 做出断言。
review-code：审查源文件和模板。
refactor-brief：将发现转化为交由其他技能执行的实现任务。
regression-check：对比前后证据及剩余风险。

必需工作流

使用 references/audit-evidence-model.md 对可用证据分类。
在对发现进行排序前，应用 references/severity-model.md。
使用 assets/audit-report.template.md 生成审查报告。
使用 assets/regression-report.template.md 进行前后对比检查。
在处理截图、Figma 或已验证身份的状态前，应用 ../../shared/privacy-policy.md。
如果提供了 URL，请复用 ../../shared/tool_inventory.json 中列出的本地脚本。
为每条发现标注证据类型：DOM、screenshot、source、automated 或 Manual。

证据边界

仅有截图输入，不能支持有关 DOM、Lighthouse、axe 或运行时的断言。
仅有源代码输入，不能证明渲染后的布局，除非有运行或截图证据。
可以提出人工检查发现，但必须标注为 Manual。
计划使用的工具不属于证据。

验证

python3 $CODEX_SKILLS_DIR/.system/skill-creator/scripts/quick_validate.py $CODEX_SKILLS_DIR/ux-audit-skill
python3 $CODEX_SKILLS_DIR/senior-skill-architect/scripts/lint_production_skill.py $CODEX_SKILLS_DIR/ux-audit-skill

输出格式

Audit target:
Evidence available:
Ran:
Skipped:
Severity matrix:
Top fixes:
Verification plan:
Privacy notes:
Residual risk:

支持 Markdown

登录后评论