1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | ux-heuristics-wondelai-skills | GitHub 合集仓库子目录（wondelai/skills 仓库内 ux-heuristics） |
| 作者/维护者 | wondelai（GitHub 组织，2023-07 注册，仅此一个公开仓库，运营 skills.wondel.ai） | GitHub API |
| 来源链接 | https://github.com/wondelai/skills/tree/main/ux-heuristics | — |
| 许可证 | MIT | GitHub API / SKILL.md frontmatter |
| GitHub Stars / Forks | 合集仓库整体 1,813 / 185（该数字属整个 skills 合集，不代表本子技能自身热度） | GitHub API（认证取数） |
| 最新版本 | SKILL.md frontmatter 标注 version 1.6.0，最近一次提交 2026-06-30 | GitHub API |
| 安装方式 | npx skills add wondelai/skills/ux-heuristics --global，或 Claude Code 插件市场安装 ux-design@wondelai-skills 套装 |
官方 README |
2. 功能介绍与亮点
ux-heuristics 是 wondelai/skills（62 个技能，均改编自畅销商业/设计/工程书籍）中专注可用性评估方法论的子技能，把 Steve Krug《Don’t Make Me Think》的三条可用性法则、Jakob Nielsen 十大启发式原则整理成一套可执行的界面审查框架，正文之外附 7 份细分参考文档：krug-principles.md（扫描/满足式决策心理学）、nielsen-heuristics.md、dark-patterns.md（暗黑模式分类）、wcag-checklist.md（WCAG 2.1 AA 完整核对表）、cultural-ux.md（RTL 布局与跨文化本地化）、heuristic-conflicts.md（原则冲突时的取舍规则）、audit-template.md。
主要亮点：
- 量化评分而非印象式评价：从 10 分起按问题严重度逐项扣分，输出当前得分、最高严重度问题与达到满分所需的具体修复项。
- 十项速查诊断表：从“能否立刻看出这是什么页面”到“是否所有交互元素都有文字标签”，逐条给出“若否→后果→修复动作”。
- 原则冲突有解法：简洁性与灵活性、一致性与情境化等常见启发式矛盾，给出取舍规则并附实战案例。
- 暗黑模式识别独立成章：强制续订、“蟑螂屋”式退订路径、愧疚式确认按钮等模式配伦理边界说明。
- 纯 Markdown 指导内容，frontmatter 未声明任何工具权限，不含任何可执行脚本。
3. 适用场景
所属固定分类：前端与设计。适用于需要对界面做可用性走查但缺乏系统方法的前端/产品工程师——把“用户会不会用得顺”从主观感觉变成有严重度分级、有评分依据的审查产出；也适合产品经理、UX 研究员在评审表单流程、导航结构、信息架构时用作检查清单，或在设计评审会上作为“是否达到可用性门槛”的量化依据。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。可通过
/plugin marketplace add wondelai/skills后/plugin install ux-design@wondelai-skills整包安装，或npx skills add单独安装本技能。 - Codex：✅ README 明确说明 Codex 采用同一套开放 SKILL.md 标准，仓库自带由
.claude-plugin/marketplace.json生成的 Codex 插件清单（.agents/plugins/marketplace.json），可在 Codex TUI 的/plugins菜单直接管理安装。 - OpenClaw：⚠️ 官方 README 将 OpenClaw 列入支持的 agent 名单，但未找到独立第三方渠道验证，未验证。
- Hermes Agent：✅ 第三方注册表 Hermes Atlas（hermesatlas.com）已收录
wondelai/skills项目条目。
5. 推荐理由
把界面可用性审查从“凭经验看一眼”变成有理论依据（Krug 三定律 + Nielsen 十启发式）、有评分标准、有严重度分级的可复现流程；7 份参考文档覆盖 WCAG 无障碍核对、暗黑模式识别、跨文化本地化与原则冲突处理，深度明显超过一份速查表；纯 Markdown 无代码执行，安装门槛低，且背靠一个持续迭代、有真实第三方贡献者参与提议新技能的技能合集。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 合集仓库 wondelai/skills 收到多位独立贡献者的 issue 与 PR（如提议新增 gestalt-ui/laws-of-ux 相关技能、市场收录反馈等），但 ux-heuristics 子目录自身提交记录仅来自单一作者（13 次提交，跨 2026-01~06），按子目录自身证据评分，不沿用合集整体 1,813 星 |
| 可用性 | 9 | 一条 npx skills add 命令或 Claude Code 插件市场即装；正文 + 7 份细分参考文档结构完整；version 1.6.0 持续迭代，最近提交 2026-06-30；README 明确列出对 Claude Code / Codex / Cursor 等多 agent 的支持，无付费依赖 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① Shell 命令执行：无，SKILL.md frontmatter 未声明 allowed-tools，正文纯 Markdown 参考资料 ② 联网外发：无，技能本身不发起任何网络请求 ③ API key/凭据：不涉及 ④ 可疑指令：通读全文未发现 prompt injection 或隐蔽指令 ⑤ 作者信誉：wondelai 为 2023-07 注册的 GitHub 组织，公开仓库仅此一个，提交历史分布在数月内、非短时爆发式刷星特征 ⑥ License：MIT，仓库根目录 LICENSE 与 SKILL.md frontmatter 均明确声明 ⑦ 最近维护：最近一次提交 2026-06-30，距今约一个月，所属合集仓库近期仍有其他子技能持续提交
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与 ux-heuristics 的差异 |
|---|---|---|
| better-accessibility（jakubkrehel/skills） | 无障碍工程实操规则（焦点态、ARIA、屏幕阅读器、触控目标） | 聚焦“如何把无障碍做进代码”的具体实现规则；ux-heuristics 聚焦“如何系统性评估整体可用性并打分”，无障碍只是其十项启发式检查中的一项 |
| make-interfaces-feel-better（jakubkrehel） | 界面视觉“手感”细节审查（圆角、阴影、动效、图标） | 关注视觉打磨与像素级观感一致性；ux-heuristics 不涉及视觉样式，关注信息架构、导航逻辑与任务完成路径是否顺畅 |
| ux-writing-skill（content-designer） | 界面文案与微文案写作规则 | 聚焦文字表达本身；ux-heuristics 的“减少认知负荷”等原则会涉及文案，但核心是可用性诊断框架而非文案写作指南 |
8. 用户评价
该技能本身在第三方平台尚无具名用户评价。其所属的 wondelai/skills 合集仓库收到过多位独立贡献者的功能提案（如建议新增 gestalt-ui、laws-of-ux、ui-patterns 等可用性相关技能）与安装体验反馈，显示该合集在可用性/设计类技能方向存在真实的社区关注度。
9. 其他补充
wondelai/skills 按主题打包成 10 个 Claude Code 插件套装，ux-heuristics 归属 ux-design@wondelai-skills 套装，同套装内还包含 refactoring-ui（视觉设计系统）、ios-hig-design（iOS 人机界面指南）、hooked-ux（习惯养成设计）等技能，可整包安装形成互补的设计评审工具链。全部技能可在 skills.wondel.ai 站点浏览详情。
10. 安装使用方式
- Claude Code 插件市场：
/plugin marketplace add wondelai/skills，然后/plugin install ux-design@wondelai-skills（整包，含 refactoring-ui、ios-hig-design 等 9 个同类技能） - skills.sh（跨 Claude Code / Codex 通用）：
npx skills add wondelai/skills/ux-heuristics --global - Codex：同上
npx skills add命令，或克隆仓库后由 Codex 自动发现.agents/plugins/marketplace.json中的插件清单 - 安装后注意事项：全局安装后由触发词自动激活，如提及“usability audit”“users are confused”“is this easy to use”等；
references/下 7 份子文档需与 SKILL.md 保持同目录完整安装，不要只摘取正文单文件使用
11. 注意事项
- 本技能子目录当前提交历史仅来自单一作者，不代表企业级 SLA 或响应速度承诺，团队重度依赖前建议自行评估维护延续性
- README 中书籍引用链接带 Amazon 联盟标识（不影响技能本身功能，知悉即可）
- 内容基于英文经典可用性理论，示例文案（如错误提示措辞）面向英文界面，中文产品使用时需要按本地语境改写
- OpenClaw 兼容性为官方自述，未经独立第三方验证，如作为选型依据请自行验证