Communitygithub.com

anfrageozmarketing/unslop-components

讓應用程式 UI 更具創意與領域特定性,而非千篇一律的表單、表格與 KPI 卡片。提供一套流程,根據資料形狀(路線圖、條狀、跑道、矩陣、時間軸、圖表、串流)為每個畫面選出標誌性元件,禁止使用預設的表格/卡片/下拉選單外觀,並設有關卡。

unslop-components 是什麼?

unslop-components 是一個 AI 代理技能,旨在打破 AI 生成應用程式常見的「管理後台模板」外觀(頁面標題、KPI 卡片列、表格、表單)。它強制採用「資料形狀驅動」的設計方法,而不是依賴預設元件庫。使用者需先基於 `unslop-foundation` 技能建立基礎(調色盤、圖示、插畫、動態語言與經批准的元件表),然後遵循按畫面處理的流程:命名資料形狀(序列、比較、層級等)、從參考模式中選擇適合的元件形式、定義一個標誌性元件、為狀態設計多通道視覺語言(形狀/填色加顏色)、預設唯讀、支援直接操作,並在不同的螢幕尺寸與無障礙功能上進行驗證。該技能包含一個嚴格的「禁止清單」(預設表格、卡片網格、統計卡片、表單)和一個「關卡」,以確保每個畫面都經過實際審查(使用 Playwright MCP 截圖)。它支援 Claude Code 等平台(透過 MCP 工具),且適合用於任何從表格、統一的卡片網格、統計圖塊和表單欄位構建的應用程式畫面,或用於使用者要求更具創意、更少「管理後台模板」元件的場景。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/anfrageozmarketing/unslopUI/tree/HEAD/skills/unslop-components

在你喜歡的 AI 中提問

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

說明文件

unslop-components 是做什麼的?

AI 生成的應用程式共用同一種輪廓:一個頁面標題、一行四個 KPI 卡片、一個表格、一個附有下拉選單的表單。這個輪廓雖然正確,但過目即忘。元件應該由資料本身的形狀來塑造,而不是由元件庫提供了什麼來決定。

首先建立在基礎之上(unslop-foundation):調色盤代碼、圖示風格、插畫系統、動態語言以及一份經批准的元件表。這裡的元件使用那些代碼及部件;它們不會自行發明顏色或樣式。

禁止清單(預設外觀)

優先思考元件:為產品命名構成區塊,建立並審查它們,然後再組合畫面。不要發布一個主要內容是以下任何一項的畫面,除非資料真的就是那樣:

  • 以邊框和細線分隔的行或群組(請改用空間和色調來分隔)

  • 一個加上標籤的表單(欄位網格加上「儲存」按鈕)作為編輯方式;請使用 unslop-foundation/references/designer-standard.md 中的編輯模式

  • 一行 KPI / 統計卡片(請改用一句話,或將數字顯示在其所測量的事物內部)

  • 儲存格中含有編輯下拉選單的表格(表格用於比較多個行的多個屬性)

  • 由相同卡片組成的統一網格

  • 以表單作為主要介面(表單用於輸入資料,而非檢視資料)

  • 狀態以純色文字或僅有名稱的藥丸形狀呈現(請賦予狀態具體形狀,請見下方說明)

  • 用圓餅圖表示進度、量表、作為裝飾的甜甜圈環

流程(每個畫面)

  1. 命名資料形狀。 序列/旅程、整體的各部分、比較、關係、隨時間的變化、排序、位置、階層,或是一串需要關注的事物串流。
  2. 從 references/patterns.md 中選擇符合形狀的形式。 寫下一行文字:「這個畫面是一個路線圖,因為資料是按區域排序的流程。」
  3. 每個畫面定義一個標誌性元件: 使用者會記住的那個東西。它承載了豐富性;它周圍的一切都是安靜的文字和細線條。
  4. 為狀態賦予視覺語言,至少使用兩個通道(形狀/填色和顏色,而不是只有顏色),並在每個畫面上一致使用。
  5. 先顯示,再編輯。 預設檢視是以閱讀為優先。編輯操作位於更深的層級(詳細資訊區塊、抽屜、詳細資料頁面),而不是在每一行中。
  6. 直接操作勝過控制項。 同樣也是圖例的篩選器。點擊事物本身,而不是「檢視」按鈕。只有在拖曳能取代下拉選單且速度更快時才使用拖曳。
  7. 變化密度。 一個大的亮點,一個安靜的中間段落,一些小的輔助細節。不要放入五個等大的方塊。
  8. 根據下面的關卡進行檢查。

關卡

  • 畫面的主要元素不是表格、卡片網格、統計行或表單。
  • 有一行理由將所選的元件與資料形狀聯繫起來。
  • 狀態使用形狀/填色加顏色,並且在畫面間保持一致。
  • 唯讀優先:在沒有點擊的情況下,任何畫面的可見下拉選單或輸入框不得超過少數幾個。
  • 元件在 360 px 寬度下仍能正常運作(有目的地換行、堆疊或滾動),並且可以透過鍵盤操作且有可見的焦點指示。
  • 尊重減少動畫設定:沒有僅為裝飾而進行的動畫。
  • 你已經實際看過它了:使用 Playwright MCP 在 360 px 和 1280 px 下截圖(claude mcp add playwright npx @playwright/mcp@latest)。如果你無法實際查看,請明確說明;不要僅憑程式碼就稱一個畫面具有創意或已完成。

何時適合使用表格

多行、多個可比較的欄位、排序很重要(稽核日誌、價格列表、匯出資料)。在這種情況下,設計表格:數字以表格方式對齊、欄位對齊、規則線條安靜、行懸停效果、無斑馬紋或框線儲存格,且儲存格中無控制項。

檔案

  • references/patterns.md - 資料形狀到元件目錄、狀態語言、範例作品(產品流程的路線圖)

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能