1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | ui-ux-guide |
| 项目自述名称 | oiloil-ui-ux-guide（仓库更名前用名，也是 SKILL.md 内部技能标识符，触发时仍用 $oiloil-ui-ux-guide） |
| 作者/维护者 | oil-oil（GitHub 个人开发者） |
| 来源链接 | https://github.com/oil-oil/ui-ux-guide |
| 许可证 | Apache License 2.0（来自 GitHub API） |
| GitHub Stars | 84（来自 GitHub API） |
| Forks | 12（来自 GitHub API） |
| 最新版本 | 未标注版本号（仓库未使用 Release/Tag 机制） |
| 安装方式 | CLI 一条命令：npx skills add oil-oil/ui-ux-guide |
2. 功能介绍与亮点
这是一个风格中立的 UI/UX 咨询技能：它不预设某种“正确”的审美偏好，而是像一位耐心的访谈者，先了解项目背景再给建议。核心提供三种模式：
- Design 模式（默认）：与用户结构化访谈，共创项目专属的设计系统，产出
design-spec.md；开始前会先“静默扫描”项目里的 Tailwind 配置、CSS 变量、主题文件等既有设计令牌，做到“先听后建议”。 - Guide 模式：针对特定页面类型（仪表盘、表单、长文内容等）给出简洁的 do/don’t 规则。
- Review 模式：审查现有界面，按 P0/P1/P2 优先级输出问题清单与修复建议。
亮点：定义了 10 条跨风格通用的“UX 硬规则”（任务优先级、可供性、防错、一致性、间距节奏等），与之并列的是 8 个独立的“风格镜头”（现代极简、编辑感、粗野主义、活泼、高端奢华、赛博朋克科技感、暖调内容型、品牌驱动），互不预设优先级，由用户或项目上下文决定采用哪一种。另内置“Anti-AI Self-Check”，用于识别 AI 生成界面常见的通病（滥用渐变、无意义文案堆砌、装饰性冗余等）。技能纯粹基于提示词与本地模板运作，不需要联网或任何 API Key。
3. 适用场景
所属分类：前端与设计
适合没有专职设计师、担心 AI 编码代理产出“千篇一律的默认样式”的初中级开发者：项目刚起步需要先定一套设计系统时用 Design 模式；已有界面想找茬时用 Review 模式；只是想知道某类页面该注意什么时用 Guide 模式。因为不绑定单一审美风格，也适合团队本身已有品牌调性、只想校验一致性与可用性的场景。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 仓库含 CLAUDE.md 入口文件与 skills/oiloil-ui-ux-guide/SKILL.md，符合 Agent Skills 规范 |
| Codex | ✅ 原生支持 | 安装命令显式提供 -a codex 选项，仓库含 agents/openai.yaml 桥接文件 |
| OpenClaw | ❓ 未验证 | README 未提及，未做专门验证 |
| Hermes Agent | ❓ 未验证 | README 未提及，未做专门验证 |
5. 推荐理由
多数 UI/UX 类技能要么直接生成一套固定风格的设计系统，要么只做单向的规则灌输。这个技能反过来：先访谈、先扫描现有代码，再给建议，且把“通用可用性规则”和“审美风格”显式拆开处理——这让它既能服务白纸项目，也能服务已有明确品牌调性、只想校验一致性的团队，不会把自己的审美强加给别人的产品。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 4 | GitHub 84 stars，落在 50–200 区间；未发现独立第三方媒体报道或活跃社区讨论 |
| 可用性 | 8 | 一条命令安装、零配置、零付费依赖，SKILL.md 文档完整并附 8 组测试用例（evals）；最近一次提交距今约 3.7 个月，略超“近 3 个月”窗口，故未打满分 |
| 安全性 | 9 | 纯提示词与本地模板类技能，无 shell 执行、无联网外发、无需任何凭据；License 明确；未发现可疑指令或混淆代码 |
安全检查清单： ① shell 命令：无，仅读取项目文件辅助扫描现有设计令牌 ② 联网外发：无 ③ API Key/凭据：不需要 ④ 可疑指令：直接读取 SKILL.md 全文，未发现 prompt injection 或隐蔽指令 ⑤ 作者信誉：个人开发者，无造假迹象，信誉一般可接受 ⑥ License：Apache 2.0，明确 ⑦ 最近维护：约 3.7 个月前，未达“弃置”标准
综合评分（三项均值）：7.0
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| ui-ux-pro-max-skill | 本地免联网设计知识库，一条命令为编码代理生成完整的、风格统一的 UI 设计系统 | 更偏“一键出图”，风格由技能预设主导；本技能则先访谈了解项目诉求，产出的规范风格由用户在 8 种镜头中自主选择，更适合已有审美倾向的团队 |
| ux-designer-skill（szilu） | 基于 2026 年现代最佳实践的综合性 UX/UI 设计指导技能 | 以知识灌输为主，缺少本技能的“访谈—扫描—共创”交互流程与结构化 Review 模式 |
| claude-design-auditor-skill（Ashutos1997） | 依据 19 条专业设计规则审计现有界面 | 只覆盖审查场景，没有从零共创设计系统的能力，功能范围窄于本技能的三模式组合 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
技能通过共享桥接文件（AGENTS.md、.cursor/rules/oiloil-ui-ux-guide.mdc、agents/openai.yaml）适配 Claude Code、Codex 之外的其他编码代理（如 Cursor、Windsurf），但这些平台不在本报告的四个评估范围内，仅作背景说明。
10. 安装使用方式
CLI 安装（推荐）：
npx skills add oil-oil/ui-ux-guide可指定目标代理：
npx skills add oil-oil/ui-ux-guide -a codex -a claude-code手动安装：
git clone https://github.com/oil-oil/ui-ux-guide ~/.claude/skills/oiloil-ui-ux-guide安装后无需重启，直接在对话中说明意图即可触发，例如：
- Design 模式：「请用 $oiloil-ui-ux-guide 帮我确定这个项目的设计规范，背景是……，先扫描现有令牌，先听我说再建议」
- Review 模式：「用 review 模式检查这个后台面板，输出 P0/P1/P2 问题与修复建议，不要按任何单一风格评判」
- Guide 模式：「用 guide 模式，页面类型是 B2B 长表单，给出 CTA 层级、可供性、防错方面的 do/don’t 规则」
11. 注意事项
- 技能定位为“提示词+模板”类工具，不会自动读取或修改代码文件之外的内容，也不会联网核实设计趋势，产出质量依赖对话中提供的项目背景是否充分。
- 仓库近期（约 3.7 个月内）无新提交，需留意后续是否有维护跟进。
- 未提供正式版本号/发布记录，无法追踪具体版本变更历史。