1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | oh-my-design |
| 作者/维护者 | kwakseongjae |
| 来源链接 | https://github.com/kwakseongjae/oh-my-design |
| 许可证 | MIT（GitHub API 确认，仓库根目录含 LICENSE 文件） |
| GitHub Stars | 370（GitHub API） |
| Forks | 35（GitHub API） |
| 最新版本 | v1.9.0（npm 包信息） |
| 安装方式 | npx oh-my-design-cli@latest（GitHub API / 官方文档） |
2. 功能介绍与亮点
- 核心机制是 DESIGN.md：把品牌设计基调（tokens、语调、原则、人格、状态、动效）固化为项目根目录下的一份文件，此后 AI 编码助手每次改 UI 都以此为准，跨会话保持视觉一致。
- 内置 440+ 家真实公司的 DESIGN.md 参考库（如 Toss、Stripe 风格），按关键词匹配即可生成贴合场景的品牌规范草稿，也支持自定义品牌。
- 20 个技能 + 18 个专精子代理组成完整工作流：初始化（
omd:init）、应用到界面（omd:apply）、偏好记忆、素材抓取、文案本地化、“AI 味”审查（omd:slop-audit）、上线前质量把关（omd:final-qa）均覆盖。 - 核心工作流完全本地完成，不需要外部 API Key 或常驻服务；唯一联网的可选子技能
claude-design会把代码库上下文发到用户自己已登录的 claude.ai/design 会话，用途透明。 - npm 每月下载量约 3,400 次，是 GitHub star 之外的独立采用度证据。
3. 适用场景
所属分类：前端与设计
面向没有专职设计师、需要快速确定并长期保持产品视觉基调的独立开发者与小团队。典型场景：新项目冷启动时定下品牌调性；已有项目希望后续 UI 生成保持同一设计语言；把原本只存在于设计师脑中的“设计规范”沉淀成 agent 可长期读取的文件。
4. 跨 Agent 兼容性
- Claude Code：原生支持——官方文档给出专属安装路径（
.claude/下完整技能、子代理与 hooks）。 - Codex：原生支持——官方文档给出专属安装路径（
.agents/skills/、.codex/agents/）。 - OpenClaw：未验证——现有文档未提及。
- Hermes Agent：未验证——现有文档未提及。
补充：项目还支持 OpenCode（原生）与 Cursor（仅规则文件，不含完整技能），但二者不在本报告四个目标 Agent 范围内，仅供参考。
5. 推荐理由
用 DESIGN.md 把品牌设计基调固化成可跨会话复用的文件，配合真实公司参考库和完整技能链，让没有设计师的团队用一条命令，使 AI 编码助手持续产出风格统一的界面。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 370 stars，npm 每月下载约 3,400 次，仓库近日仍有提交 |
| 可用性 | 9 | 一条 npx 命令安装并附带 doctor 诊断命令；文档提供英/韩/日/简中/繁中五语版本；近日仍在活跃维护；MIT 协议免费使用，无付费依赖 |
| 安全性 | 8 | 见下方安全检查清单 |
综合评分：约 7.7
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 核心技能仅执行本地文件读写，安装脚本为标准 npm CLI 流程，未见越权系统操作 |
| ② 运行时联网外发 | 核心工作流不联网、不依赖任何常驻服务；仅可选子技能 claude-design 会把代码库上下文发送至用户自己已登录的 claude.ai/design 会话，去向透明 |
| ③ API Key/凭据存储 | 核心功能无需任何 API Key 或凭据；上述可选功能复用用户已有的浏览器登录状态，不额外存储凭据 |
| ④ 可疑指令 | 审阅技能说明文档与关键脚本，未发现隐藏的可疑指令或数据外发行为 |
| ⑤ 作者信誉 | 作者 GitHub 账号有多年历史与多个公开仓库，未见刷星或虚假宣传迹象 |
| ⑥ License | MIT，仓库根目录明确列出 |
| ⑦ 维护活跃度 | 近日仍有提交，issue 反馈渠道开放 |
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与 oh-my-design 的差异 |
|---|---|---|
| superdesign-skill（superdesigndev） | 专注于把 AI 生成的粗糙 UI 改造成可上线前端的单一技能 | 聚焦单次 UI 改造动作，没有 oh-my-design 那样的品牌规范文件沉淀与跨会话记忆机制 |
| ux-ui-agent-skills（plugin87） | 提供 DTCG 设计 tokens、138 套预置设计系统与跨框架组件代码生成 | 更偏组件与代码层面的落地产出；oh-my-design 更偏品牌调性与设计语言本身的确立与长期维护 |
| claude-skills（rampstackco） | 覆盖品牌、内容、SEO、开发、运营等全站生命周期的技能集合，按需选装子集 | 覆盖范围远超单一设计环节，但设计系统本身的深度与参考库规模不及 oh-my-design |
8. 用户评价
该技能目前在第三方社区与讨论区尚未见具名用户评价；已被至少一个第三方 AI 技能目录收录列示。
9. 其他补充
文档提供英语、韩语、日语、简体中文、繁体中文五种语言版本，仓库附带 CHANGELOG，欢迎社区贡献。
10. 安装使用方式
通用安装（自动检测已安装的 Agent）：
npx oh-my-design-cli@latest仅安装到指定 Agent（如 Codex）：
npx oh-my-design-cli@latest install-skills --agent codex --all安装后诊断：
npx oh-my-design-cli@latest doctor安装后需完全重启对应 Agent 以加载新技能；Codex 用户还需额外确认信任该项目，本地角色配置才会生效。首次使用可直接用自然语言描述需求，例如“帮我的项目建一份品牌设计规范，参考 xx 风格”，技能会引导选择参考对象并生成 DESIGN.md。
11. 注意事项
- 目前仅有单一维护者，外部贡献与 issue 讨论量较小。
- Cursor 仅获得规则文件与参考库，不含完整技能与子代理，体验弱于 Claude Code/Codex/OpenCode。
- OpenClaw 与 Hermes Agent 的兼容性未见官方说明，如需使用建议自行验证。
- 可选的
claude-design子技能依赖用户在 Chrome 中已登录的 claude.ai 账号，若未登录或存在浏览器扩展冲突，会退回手动操作。