kwakseongjae/oh-my-design

Give your AI coding agent a design system. One command installs 500+ quality-graded company DESIGN.md references + skills into Claude Code, Codex, Cursor, and OpenCode. Free, MIT, zero AI calls.

解决的问题

编程代理在维护一致的设计系统时往往力不从心，导致出现“设计混乱”（design slop），即生成的 UI 组件缺乏统一的理念，或未能严格遵守可访问性和品牌标准。本项目提供了一个结构化的、原生支持代理的框架，用于直接在您的仓库中定义、强制执行和记录设计系统。

工作原理

该系统强制 AI 代理遵循严格的推导链：理念 → 决策表 → 令牌 → 组件契约 → 布局语法。通过使用 DESIGN.md 文件作为事实来源，代理受到明确规则和“混乱门禁”（slop gates）的约束，防止其随意发明样式。CLI 提供了验证这些文件、托管本地文档站点（omd book）以及管理与 Claude Code、Cursor 和 OpenCode 等流行编程代理集成的工具。

适用人群

本工具专为使用 AI 编程代理构建用户界面的开发者和团队设计，旨在确保这些代理能够产出高质量、品牌一致且符合可访问性要求，并严格遵循正式设计系统的代码。

亮点

  • 原生代理工作流：直接与 Claude Code、Cursor 和 OpenCode 集成，提供特定于设计的技能和专家角色。
  • 严格执行：包含 54 个“混乱门禁”和 8 个系统保真度门禁，如果代码偏离既定的设计契约，将自动导致构建失败。
  • 便携式文档：生成一个 DESIGN.md 文件，作为一份便携、人类可读且机器可验证的契约。
  • 丰富的参考库：包含 500 多个经过质量分级的公司设计参考，帮助引导新项目。
  • 无外部依赖：核心工作流在您现有的代理会话中本地运行，无需额外的 API 密钥或 MCP 服务器。

相关

  • 项目
    Owl-Listener/designer-skills

    一组 Claude Code/Gemini-CLI 插件，将设计知识转化为机器可读的技能和可直接运行的命令，使 AI 代理能够从助手直接执行完整的设计工作流（研究、策略、UI、交互、系统、运营、评审）。

  • 项目
    mxyhi/ok-skills

    OK Skills 是一个包含 31 个即用型“技能包”的库，专为 AI 编码代理（如 Codex、Claude Code、Cursor 等）设计。每个技能都位于独立目录中，并附带一个 SKILL.md，指导代理如何运行底层脚本（例如浏览器自动化、文档查询、规划、设计）。安装方式为将其 clone 到 ~/.agents/skills（或 Autohand 等效目录），将 CLAUDE_AGENTS.md 的内容复制到代理的配置文件中，然后要求代理“Use <skill-name> …”。该仓库提供研究、规划、自动化、前端和工具等类别，适合希望使用可移植、可重复 AI 代理功能而非临时提示词的开发者。

  • 项目
    can1357/oh-my-pi

    一个功能齐全的编程代理 CLI，具备 IDE 集成、子代理、调试和众多内置工具，基于 Rust 和 TypeScript 构建。

  • 项目
    iamfakeguru/agent-md

    agent-md 是一个轻量级框架，通过安装规则文件、git-hooks 和辅助脚本，将 AI 编码助手（如 Claude Code、Codex、Cursor、Windsurf）转变为合约驱动的代理。它提供单一事实来源的 markdown 文件 (AGENT.md) 以及强制执行检查（类型检查、lint、测试、视觉截图、状态更新），在满足必要证据前会阻挡模型完成任务。

  • 项目
    jbarbier/CLAUDE.md

    一套有明确立场的指令和工作流合同，用于确保 AI 编码代理产出高质量、可预测的代码和专业沟通。