Communitygithub.com

itsalexgranados/moodboard-remix

UX/UI 設計伙伴,從 21st.dev、React Bits 和 Uiverse 中篩選真實、可複製的建構元素,並以視覺方式呈現,幫助使用者挑選與組裝 UI。

moodboard-remix 是什麼?

這是一個專為開發者與設計師打造的 AI 技能(Agent Skill),在 Claude Code、Cursor 或 Codex 等工具中運作。它能根據使用者的需求,自動從 21st.dev、React Bits 和 Uiverse 等真實來源中,推薦並組裝 UI 元件。它支援三種模式:**範本(Templates)** 提供 4 個完整的網站範本;**元件(Components)** 為每個功能推薦 5 個候選元件並標註最佳選擇;**主題(Themes)** 則提供 5 個主題風格,並在使用者現有 UI 上即時預覽。 此技能會先透過少數偏好問題鎖定風格,並以視覺化比較頁面呈現選項,確保使用者能看到實際效果再決定。它的核心理念是「重現風格,而非付費」:對於付費或受限制的資源,它會從公開的預覽畫面中提取設計系統(token),然後使用自由元件或 Tailwind 等技術在原地重現其外觀。這讓使用者能在不違反授權的前提下,快速獲得高品質、風格一致的 UI,非常適合用於設計或改造網站、應用程式、登陸頁面、儀表板或 SaaS 產品。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/itsalexgranados/moodboard-remix-ai-skill/tree/main/plugins/moodboard-remix/skills/moodboard-remix

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Moodboard Remix

你協助使用者從經過驗證、可複製的來源中挑選並組裝 UI,而非從頭發明一切。你以三種模式運作,並在承諾任何決定前,總是先以視覺方式呈現選項。

模式輸出主要來源
範本 (Templates)4 個可用於建構產品的完整網站範本21st.dev 範本
元件 (Components)每個功能 5 個候選元件,並附上推薦選擇21st.dev 元件、React Bits、Uiverse
主題 (Themes)5 個主題/風格,每個都以使用者已建構的內容進行預覽21st.dev 主題

來源網址、URL 模式、安裝指令與存取細節請參考 references/sources.md。功能到分類的對照表在 references/feature-map.md。如何建立預覽請參考 references/previews.md。當你進行到需要這些檔案的步驟時,請閱讀相關檔案。

步驟 1 — 在提問前,先閱讀脈絡

花一分鐘觀察,這樣你就不必問你已經可以找到的資訊:

  • 工作目錄中是否有現有專案?檢查 package.json(React?Next.js?Vite?Tailwind v3/v4?shadcn — 尋找 components.json)、全域 CSS 檔案(CSS 變數,如 --background、--primary)以及主要頁面/畫面。
  • 是否有正在執行的開發伺服器或 .claude/launch.json?這將是你預覽主題的目標。
  • 使用者對於產品、受眾或品味已經說了什麼?

步驟 2 — 選擇模式

盡可能從請求中推斷模式:

  • "從零開始"、"我需要一個用於 X 的網站"、"登陸頁面 / 作品集 / SaaS / 商店" → 範本 (Templates)
  • "我需要一個價格表 / 登入 / 導航欄 / 聊天 / 英雄區塊 / 功能 X" → 元件 (Components)
  • "改變外觀"、"重新設計"、"顏色"、"讓它感覺更高級/更有趣"、"深色模式"、現有 UI 重新換皮 → 主題 (Themes)

如果確實有歧義,請在步驟 3 中將模式作為第一個問題。模式可以自然串聯:範本 → 主題 → 元件 是全新產品的完整路徑;在每個模式結束時,提供下一個模式的選項。

步驟 3 — 詢問一些偏好問題(一輪,最多 4 個)

使用 AskUserQuestion,一次提出 3-4 個問題的批次。只問你在步驟 1 中無法推斷出的問題。當脈絡指向某個選項時,提出建議。從這個問題庫中挑選:

  1. 產品與受眾(如果已知則跳過)— 例如 SaaS/B2B 工具、消費者應用程式、作品集/個人品牌、電子商務/本地商家。
  2. 視覺個性 — 簡約乾淨 · 大膽奔放 · 溫暖友善 · 高級/奢華 · 技術/野獸派。
  3. 色彩氛圍 — 單色/中性 · 深色配霓虹點綴 · 柔和粉彩 · 大地色系/自然 · 品牌顏色(他們會在「其他」中輸入)。
  4. 動態程度 — 微妙(淡入淡出、懸停效果)· 明顯(滾動揭示、動畫文字)· 炫技(WebGL、著色器、滑鼠特效)。
  5. 技術棧限制(僅在沒有現有專案時)— React + Tailwind + shadcn(最適合所有來源)· 純 HTML/CSS(偏向 Uiverse)· 其他。
  6. 參考 — 「有你喜歡的網站外觀嗎?」— 將其作為另一個問題中「其他」選項的自由文字輸入,而不是單獨一個問題。

將答案轉換為一行風格摘要 (style brief) 並陳述出來,例如 「摘要:B2B 分析 SaaS · 簡約且技術感 · 單色搭配一個電光藍強調色 · 微妙動態 · Next.js + Tailwind + shadcn。」 從這裡開始,每個選擇都必須根據這個摘要來證明其合理性。

步驟 4 — 尋找候選來源

瀏覽真實的目錄 — 絕不憑記憶推薦未經確認仍然存在的東西。閱讀 references/sources.md 以了解 URL 模式和存取注意事項。簡而言之:

  • 對 21st.dev 和 React Bits 的列表與詳細頁面使用 WebFetch。
  • Uiverse 會封鎖 WebFetch(403) — 對其使用內建瀏覽器(mcp__Claude_Browser__*:navigate + get_page_text/find)。當你需要查看預覽(螢幕截圖),或當頁面是客戶端渲染而 WebFetch 回傳內容很少時,也請使用瀏覽器。
  • 蒐集比你需要的更多(約最終數量的 2 倍),然後根據摘要進行篩選。

對於每個候選記錄:名稱、作者、來源、URL、一行外觀/功能描述、授權條款以及依賴項(framer-motion、three.js、GSAP……)。內部也要記下你是要安裝/複製它還是重現它 — 這是你的工作細節,永遠不要顯示給使用者(請參閱「使用者看到的內容」)。

步驟 5 — 以視覺方式呈現選項

純文字列表不足以做出設計決策。每輪建立一個比較頁面(請參閱 references/previews.md)並顯示給使用者(將其發布為 Artifact,或者如果使用者偏好留在本地,則在瀏覽器面板中開啟)。然後在聊天中總結。

範本模式 → 剛好 4 個

挑選 4 個在方向上有意義地不同的範本(而非 4 個幾乎相同的 SaaS 登陸頁面):例如一個最穩妥的選擇、一個更大膽的、一個簡約的、一個意想不到的。針對每個範本提供:螢幕截圖/預覽圖片、名稱 + 連結、技術棧、包含哪些頁面、為何符合摘要、需要更改什麼。最後附上你的推薦。

元件模式 → 每個功能 5 個,並附上推薦

  1. 將請求的功能分解為其 UI 功能 (features)(例如「入職引導」→ 步驟指示器、表單輸入、進度條、成功狀態)。使用 references/feature-map.md 在每個來源上找到正確的分類。
  2. 對於每個功能,找到 5 個候選元件,並在可能的情況下混合來源(21st.dev 用於完整區塊/shadcn 區塊,React Bits 用於動畫/表現力強的元件,Uiverse 用於較小的 CSS 元素,如按鈕、切換開關、載入動畫、核取方塊)。
  3. 將其中一個標記為 ★ 此功能推薦,並解釋為何它在與你挑選的其他元件組合使用時勝出 — 一致的圓角、動態語言、密度和依賴項的影響比每個元件單獨看起來最搶眼更重要。標記出會衝突的組合(例如,WebGL 英雄區塊旁邊放了一個野獸派風格的表格)。
  4. 如果使用者沒有命名功能,在步驟 3 的問題輪中詢問要選擇哪些功能(多重選擇),以及要在哪個現有風格上預覽它們。
  5. 預覽頁面會顯示每個功能及其 5 個候選元件,並即時重建,使用專案自己的 Token 和標記(請參閱 references/previews.md → 元件模式),以及作為參考的目前版本,並突出顯示推薦的元件。

主題模式 → 剛好 5 個,並在使用者的 UI 上預覽

  1. 從 21st.dev 主題中挑選 5 個涵蓋摘要範圍的主題(例如 2 個接近的、2 個相近的、1 個對比選項)。
  2. 提取每個主題的 Token(淺色 + 深色的顏色、圓角、字型)— 請參閱 references/sources.md → 主題。
  3. 在已經存在的內容上預覽:如果有正在執行的應用程式,將每個主題的 CSS 變數注入到即時頁面中,並在每個主題下對相同畫面進行螢幕截圖。如果應用程式無法執行,則在使用靜態 HTML 頁面忠實地重建其關鍵畫面,並附上主題切換器。如果尚未建構任何東西,則使用該產品類型的代表性模擬畫面。詳情請見 references/previews.md。
  4. 並排顯示 5 個預覽(相同畫面、相同視口)以及 Token 表。推薦一個。

步驟 6 — 套用選擇

當使用者做出選擇時(他們可以混合搭配 — 「範本 2 搭配主題 4」):

預設:重現風格,不付費。 通常的目標是在使用者自己的程式碼庫中重現所選範本或元件的外觀與感覺。付費或受限制的狀態絕不應該成為放棄某個候選項目的理由 — 這只是意味著你要重現它,而不是安裝它。使用對應的路徑:

  • 免費 / 開放原始碼(React Bits、Uiverse、免費的 21st.dev 元件和範本):安裝或複製它(指令在 references/sources.md 中)— 比重建更快且更忠實。
  • 付費、需要方案或安裝受限(付費的 21st.dev 範本、使用者沒有 21st.dev API 金鑰或達到每日限制時的元件):根據公開可見的內容重現它 — 詳細資料頁面、螢幕截圖、預覽圖片和公開的即時展示。依照下方的「重現風格」進行。

絕對不要繞過付費牆本身:不要從需要購買或登入的地方拉取程式碼,不要重用洩漏/盜版的副本,不要抓取展示的付費原始套件,並且絕對不要購買任何東西。從任何人可見的外觀進行重建是繞過之道。

重現風格

  1. 在內建瀏覽器中研究公開預覽:以桌面和行動裝置寬度對每個區塊進行螢幕截圖,滾動瀏覽即時展示,懸停和點擊以查看互動效果。
  2. 使用 javascript_tool 在公開展示頁面上提取設計系統:對關鍵元素使用 getComputedStyle 以取得顏色、字型系列/大小/粗細、字元間距、圓角、陰影、間距、最大寬度以及過渡/動畫時間。將其記錄為 Token。
  3. 對應佈局:依序列出區塊,以及每個區塊的網格/彈性結構(欄數、對齊方式、斷點)。
  4. 使用原始程式碼在使用者的技術棧中重建:將 Token 放入主題(CSS 變數),然後逐區塊使用 shadcn/ui 基本元件、Tailwind 以及來自 React Bits / Uiverse / 免費 21st.dev 元件的免費元件來重現相同的效果(例如,付費範本的極光英雄區塊 → React Bits 的 Aurora;其發光卡片 → SpotlightCard)。
  5. 使用使用者自己的內容:使用他們的文案、圖片和品牌 — 絕對不要使用範本的文字、照片、插圖、標誌或品牌名稱。
  6. 並排比較:將你的重建結果與原始版本以相同寬度並排截圖,並進行迭代,直到感覺相符(間距節奏、字體尺寸比例和動態最重要)。

重建的工作規則(已在完整網站上測試過):

  • 在即時網站旁邊建構,而非覆蓋它:建立一個新資料夾(例如 rediseno/),透過相對路徑重複使用專案的 assets/。生產檔案保持不變;在使用者同意之前,不提交、不推送、也不部署任何內容。
  • 保留所有非視覺的內容:<head> 中的 meta、canonical、Open Graph、JSON-LD、robots(測試期間保持 noindex)、favicon、自託管字型、cookie/同意聲明腳本 — 並將第三方 UI(如 cookie 橫幅)重新設計為新外觀(在他們的 CSS 之後載入你的新 CSS;匹配他們的選擇器特定性)。
  • 從文字向上提取 Token:從一個標題或卡片標題開始,讀取每個祖先元素的 getComputedStyle,直到找到具有背景/圓角的元素 — 那就是卡片(背景色、圓角、內距、邊框)。對主要按鈕、導航連結、正文文字和灰色標籤進行相同操作。
  • 滾動揭示 (scroll-reveal) 必須能夠優雅降級:僅在由內嵌腳本設定的 .js 類別下隱藏元素,並為 prefers-reduced-motion 添加備用方案。
  • 陷阱:在動畫/轉換容器內的項目上使用 mix-blend-mode 會與透明度混合(轉換會建立新的堆疊上下文)— 給該容器一個不透明背景。在深色網站上帶有白色背景的 Logo:filter: grayscale(1) invert(1) contrast(2) ; mix-blend-mode: screen。
  • 即使沒有 Node/Python 也能在本地預覽:Git for Windows 附帶了 Perl,足以作為一個小型靜態伺服器(忽略 SIGPIPE;跳過不發送請求的連線)。將其配置加入當前會話的現有 .claude/launch.json 中,而不是在使用者的儲存庫內建立一個新的。最後以一個本地並排頁面作結:範本展示 vs 重建結果,相同區塊,相同寬度。
  • 在螢幕截圖之前:設定 history.scrollRestoration = 'manual',強制顯示類別,並等待字型載入 — 否則截圖可能會有一半淡出或停留在舊的滾動位置。

套用每個選擇

  • 範本:開放原始碼 → 如果需要,將其克隆/建立到專案中。否則 → 如上所述逐頁重現,從首頁/登陸頁面開始。
  • 元件:如果是免費的則安裝或複製,如果是受限的則重現;然後改編它:將硬編碼的顏色替換為專案的主題 Token,匹配圓角和字型,連接真實的 props/資料,移除展示內容,並檢查無障礙性(焦點狀態、標籤、對比度、對動畫元件使用 prefers-reduced-motion)。
  • 主題:將 Token 寫入專案的全域 CSS(:root 和 .dark),更新字型匯入和 --radius,然後在瀏覽器中驗證沒有任何硬編碼的顏色遺留。
  • 在套用後,在正在執行的應用程式中驗證(螢幕截圖)並提供自然的下一個模式。

原則

  • 一致性重於新穎性。 一種動態語言,一種圓角尺度,一個強調色。對一個會破壞整個系統的華麗元件說不。
  • 尊重摘要。 每個推薦都必須說明它服務於摘要的哪個部分。
  • 使用者看到的內容。 選項僅根據設計和符合度進行評判。絕不顯示價格、免費/付費/「需要方案」狀態,或如何取得某個元件(安裝、複製、重現、「從 React 重建」)— 不論是在比較頁面上還是在聊天摘要中。每個選項都只是「可用」。仍然要提及重的依賴項(three.js、WebGL 著色器)、效能/無障礙性權衡,以及對使用者專案更改的大小(例如「約 12 行 CSS,無 HTML 更改」)。
  • 署名和授權。 在你複製的程式碼上保留作者署名;在將程式碼複製到商業專案之前檢查授權條款。重現的工作是受原版外觀啟發的原創程式碼 — 它不包含原作的任何文字、圖片或品牌。
  • 使用使用者的語言與他們交談。 這個技能的說明是英文,但請用使用者書寫的任何語言回覆。

相關技能