@ryuxdsgn/design-intelligence

中文文档
2.22.1发布于 2026/11/02MITES Module

RYUX: AI代理和设计师的设计智能。一项技能,五个切入点:分析,设计,构建,批判和QA,适用于Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Cline, Copilot等。

中文使用文档
文档目录7 节
  1. 使用
  2. 代理
  3. 安装了什么
  4. 安全为您的回购
  5. 网络和MCP
  6. 其他安装方式
  7. 开发

RYUX

@ryuxdsgn/design-intelligence

安装 RYUX,为人工智能代理和设计师设计智能,只需一个命令。RYUX就是其中之一 技能有五个入口点。告诉你的经纪人你在做什么;RYUX从任务中挑选知识 需求:

  • 分析理解现有的界面,并将每个发现标记为测量、观察或 推断。
  • 设计:在Figma, pen.dev或模型中创建或改进UI和UX,无需代码。
  • 构建在repo自己的栈中实现接口。
  • 批判:对Figma链接、pen.dev设计、网站URL或 截图。
  • 质量保证:渲染,检查,修复,再渲染。

原创作品由ryux.design提供,MIT授权。规则和原理: docs/design-rules.md.

使用

npx @ryuxdsgn/design-intelligence                                          # start here: agents, install, project setup
npx @ryuxdsgn/design-intelligence setup                                    # teach RYUX about the project (DESIGN.md)
npx @ryuxdsgn/design-intelligence setup --audience "..." --market "..."    # same, without questions
npx @ryuxdsgn/design-intelligence check                                    # health check (exit 1 on problems)
npx @ryuxdsgn/design-intelligence check --json                             # the same findings as JSON, for agents and CI
npx @ryuxdsgn/design-intelligence init --agent claude --dry-run            # list what would change, write nothing
npx @ryuxdsgn/design-intelligence init --agent claude                      # install + empty project context block
npx @ryuxdsgn/design-intelligence install --agent claude,cursor,codex      # non-interactive
npx @ryuxdsgn/design-intelligence install --agent all                      # every supported agent
npx @ryuxdsgn/design-intelligence install --agent claude --global          # into your home directory
npx @ryuxdsgn/design-intelligence update                                   # refresh, and migrate RYUX 1.x installs
npx @ryuxdsgn/design-intelligence remove --yes                             # remove RYUX and marked blocks

ryux-rules 仍然可以作为同一命令的别名。

命令它是做什么的
setup问一些简单的问题,“写我自己的”,或者跳过:产品,当前工作,受众,市场和地区,约束,设计意图,UX, UI和动作方向。将答案保存到 <!-- ryux-context --> 块在 DESIGN.md,只更改您回答的字段。答案是方向,而不是证据。没有终端时,用 --product, --work, --audience, --market, --constraints, --intent, --ux, --ui, --motion.
init安装RYUX,然后添加 <!-- ryux-context --> 块 DESIGN.md (产品,受众,市场和场所,设计系统,证据来源,约束),只预先填充它可以检测到的东西。重新运行永远不会覆盖您所写的内容。 --dry-run 列出要创建或更新的内容,不写入任何内容。
install写 ryux/ 技能放入每个代理的文件夹和一个短指针块放入 CLAUDE.md, GEMINI.md,或者 AGENTS.md. 交互式安装然后提供 setup. --dry-run 列出要创建或更新的文件夹和块,不写入任何内容。
check (doctor)检查每个安装:所有文件存在,前文有效,版本匹配这个命令,每个模块引用解析,没有RYUX 1。X文件夹,指针块,项目上下文以及填充了多少设置字段。每个问题都命名了修复它的命令。错误时退出1,因此它在CI中工作; --json 打印 { ok, cli, scope, installs, findings: [{ level, where, message, fix }] }.
update重写此版本的安装并迁移RYUX 1.x。
remove移除技能和指针块。离开你 DESIGN.md 上下文。

退出代码:0已完成或运行正常,1发现问题或命令失败,2命令使用错误(未知命令或代理)。

一个版本: packages/cli/package.json. 技能标题、插件清单和 ryux --version 一切都源于它。

代理

代理--agent项目文件夹全球文件夹文件指针
克劳德代码claude.claude/skills/~/.claude/skills/CLAUDE.md
食典委codex.codex/skills/~/.agents/skills/AGENTS.md
光标cursor.cursor/skills/~/.cursor/skills/AGENTS.md
双子座CLIgemini.gemini/skills/~/.gemini/skills/GEMINI.md
OpenCodeopencode.opencode/skills/~/.config/opencode/skills/AGENTS.md
克莱因cline.cline/skills/~/.cline/skills/AGENTS.md
GitHub副驾驶员copilot.agents/skills/~/.agents/skills/AGENTS.md
Ampamp.agents/skills/~/.config/agents/skills/AGENTS.md
乔任梁代码kimi.agents/skills/~/.agents/skills/AGENTS.md
反重力antigravity.agents/skills/~/.gemini/config/skills/AGENTS.md
别的agents-md内嵌规则 AGENTS.md(项目)AGENTS.md

共享文件夹的代理只写入一次。项目安装将一个短标记块添加到 指针文件;全局安装只写技能文件夹。

安装了什么

一个文件夹, ryux/,在每个代理的技能文件夹中:

ryux/
  SKILL.md            the router: entry points, how RYUX works, levels, Hard Gates, task table, Delivery Gate
  capabilities/       analyze, design, build, critique, qa
  knowledge/          product, ux, interaction, forms, edge-cases, content, ui, design-system,
                      accessibility, responsive, frontend, anti-slop

代理读取路由器,然后只读取任务所需的能力和知识文件。

安全为您的回购

  • 您的文件永远不会被全部覆盖。 CLAUDE.md, GEMINI.md, AGENTS.md 只有改变 在 <!-- ryux-rules:start --> … <!-- ryux-rules:end --> 块。
  • update 只接触已安装的东西; remove 把它拿出来。
  • 从RYUX 1.x升级: install 或者 update 代替16 ryux-* 单个文件夹 ryux/ 文件夹中。文件夹的 ryux-rules 0.x和光标 .mdc 文件也被删除。旧的 --for, --groups, --concerns 标志被接受和忽略。

网络和MCP

  • 命令行不发出网络请求,也不运行其他程序。它只写入列出的文件 以上。
  • ryux MCP服务器是可选的:还没有托管服务器,ryux永远不会连接到一个 自己的。RYUX在没有它的情况下工作,并将其证据评为无。
  • 该技能告诉代理将MCP服务器、网页或屏幕截图返回的内容视为数据, 从来没有作为指示。

其他安装方式

npx skills add ryuxdsgn/design-intelligence      # skills.sh, any agent
/plugin marketplace add ryuxdsgn/design-intelligence
/plugin install ryux@design-intelligence          # Claude Code plugin

开发

pnpm --filter @ryuxdsgn/design-intelligence build      # tsc -> dist/
node packages/cli/dist/cli/index.js --help
pnpm sync:skills              # regenerate skills/ryux/, docs/design-rules.md, plugin versions
pnpm test                     # unit + CLI integration tests (node:test, no extra dependencies)
pnpm check:sync               # CI: fail if the committed skill, docs, or versions drift from the sources

版本与发布记录

@ryuxdsgn/design-intelligence 共发布 42 个版本,首次发布于 2026/10/11;过去 12 个月发布了 42 个版本。

版本发布日期距今
2.22.1latest2026/11/021 天前
2.22.02026/11/021 天前
2.21.02026/10/294 天前
2.20.02026/10/295 天前
2.19.72026/10/295 天前
2.19.62026/10/295 天前

关于 @ryuxdsgn/design-intelligence 的常见问题

@ryuxdsgn/design-intelligence 是什么?

RYUX: AI代理和设计师的设计智能。一项技能,五个切入点:分析,设计,构建,批判和QA,适用于Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Cline, Copilot等。

如何安装 @ryuxdsgn/design-intelligence?

在项目目录运行 npm install @ryuxdsgn/design-intelligence,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ryux、ryux-rules,可以用 npx ryux 直接运行。

@ryuxdsgn/design-intelligence 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/ryuxdsgn__design-intelligence 是否存在。

@ryuxdsgn/design-intelligence 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@ryuxdsgn/design-intelligence 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.12。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@ryuxdsgn/design-intelligence 可以商用吗?

@ryuxdsgn/design-intelligence 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@ryuxdsgn/design-intelligence 还在维护吗?

最新版本 2.22.1 发布于 2026/11/02(1 天前);至今共发布 42 个版本,其中过去 12 个月发布了 42 个;首次发布于 2026/10/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。