maquina_components
为 Ruby on Rails 项目提供一套可组合的 UI 组件库。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：maquina_components。 它的用途是：为 Ruby on Rails 项目提供一套可组合的 UI 组件库。 完整的 Skill 内容见：https://321skill.com/skills/maquina-components/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在开发一个 Rails 后台管理系统，需要一个风格统一的卡片组件来展示用户信息，并且要支持暗色模式。”，它会引导你安装 Maquina Components，然后展示如何使用其可组合的卡片部分（如 `card/header`, `card/title`, `card/content`）来快速构建出符合设计规范的界面。
介绍
Maquina Components 旨在解决 Rails 应用中，特别是仪表盘和管理后台界面，UI 组件风格和 API 不一致的问题。它提供了一套基于 ERB 部分模板、TailwindCSS 4.0 和 Stimulus 构建的组件，确保在不同项目中拥有统一的视觉和交互体验。
使用方式非常简单，通过添加 Gem 并运行安装生成器，即可在视图中直接渲染组件。组件设计为高度可组合，通过嵌套多个小组件部分来构建复杂界面，例如卡片、表单元素等，同时支持通过数据属性和 CSS 变量轻松定制主题和样式。
它非常适合那些希望在 Rails 项目中快速构建现代化、一致 UI，但又不想引入 ViewComponent 或 Phlex 等更复杂框架的团队或个人开发者。尤其适合维护多个内部工具或管理后台的项目。
建议在项目初期或重构 UI 层时引入，以统一设计规范。由于组件基于原生 ERB，学习成本极低，但需要注意其设计哲学是“组合优于便利”，因此构建复杂界面可能需要组合多个部分，这提供了灵活性但也增加了些许模板代码。
核心特点
与同类 Rails UI 库（如 ViewComponent、Phlex）不同，它坚持使用最基础的 ERB 部分模板，无需学习新的 DSL 或类结构，任何熟悉 Rails 的开发者都能立即上手。同时，它并非简单复制 shadcn/ui，而是精选了作者在实际生产项目中高频使用的组件，并为其设计了统一的 API 和主题系统。
注意事项
不适合追求极致抽象、希望用纯 Ruby 类来封装所有 UI 逻辑和状态的团队或项目。
常见问题
Maquina Components 和 shadcn/ui 有什么区别？
Maquina Components 灵感来源于 shadcn/ui，但并非完整移植。它只包含了作者在实际 Rails 项目中真正用到的组件，并针对 Rails 的 ERB 和资产管道进行了适配和 API 设计。
它支持暗色模式吗？
支持。组件使用 CSS 自定义属性进行主题化，天然支持通过切换 CSS 变量来实现亮色/暗色模式。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/maquina-components/raw/index.md 读取 maquina_components 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/maquina-components/raw/index.md（查看排版版本）