mcpField
I
intentui

intentui

github.com/intentui设计与 UI5186 次安装20 周前更新
代码仓库

关于 intentui

intentui 是一项在编写或审查 React/TSX 时强制遵循 Intent UI 组件库规范的技能。它检查组件、样式、表单、覆盖层、集合和导入,并为缺失组件提供注册表操作指引。

主要功能

  1. 01强制使用 Intent UI 组件
  2. 02遵循语义颜色与 className 规范
  3. 03检查表单和覆盖层模式
  4. 04验证集合渲染与选择方式
  5. 05核对导入和 intent 属性
  6. 06查找并安装缺失组件

适用场景

  1. 01审查 React/TSX 是否违反库规范
  2. 02将原生 HTML 替换为 UI 组件
  3. 03修正集合的渲染模式
  4. 04在注册表中查找缺失组件

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/intentui/skills --skill intentui

安装后在 Claude Code 中输入/intentui确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

rules/
cli.md
collections.md
components.md
forms.md
overlays.md
styling.md

详细介绍

Intent UI — 组件与样式规范检查器

你是 Intent UI 组件库的代码质量检查器。编写或审查 React/TSX 代码时,必须遵循 rules/ 目录中的所有规则。

规则

加载并遵循以下文件中的所有规则:

  • 样式规则 — 语义颜色令牌、className 工具函数、变体约定
  • 表单规则 — 表单组件模式、TextField、Select、Checkbox 等
  • 组件规则 — 始终使用 Intent UI 组件,而非原生 HTML 元素
  • 叠层规则 — Modal、Sheet、Drawer、Popover、Menu 和 Tooltip 的组合方式
  • 集合规则 — Table、ListBox、GridList、Tree、TagGroup:items + 渲染函数、选择属性
  • CLI 规则 — 如何从注册表搜索并安装缺失的组件

审查或编写代码时

  1. 检查原生 HTML 元素 — 替换为 Intent UI 组件(参见组件规则)
  2. 检查原生 Tailwind 颜色 — 替换为语义令牌(参见样式规则)
  3. 检查表单模式 — 正确使用 Intent UI 表单组件(参见表单规则)
  4. 检查叠层组合方式 — Modal/Sheet/Drawer/Popover/Menu 必须与其子组件配套使用(参见叠层规则)
  5. 检查集合模式 — Table/ListBox/GridList/Tree/TagGroup 必须使用 items + 渲染函数(绝不使用 .map());选择时使用 selectedKeys/onSelectionChange(参见集合规则)
  6. 检查导入 — 确保组件来自 @/components/ui/
  7. 检查 className 工具函数 — 对 react-aria 组件使用来自 @/lib/primitive 的 cx,对普通 HTML 使用 twMerge/twJoin;绝不使用 cn 或 clsx(参见样式规则)
  8. 检查 intent 属性 — 颜色变体使用 intent,绝不使用 variant 或 color
  9. 缺少组件 — 如果 src/components/ui/ 中不存在所需组件,按照 CLI 规则从注册表搜索并安装

如果发现违规,请修复并说明更改内容及原因。

评论

支持 Markdown