Communitygithub.com

Seminal

設計技能。一種具備情境感知能力的介面設計方法論。它在建構之前與過程中,決定 UI 中哪些部分應保持熟悉、哪些應予以精煉、哪些應承載品牌識別,以及哪些真正值得採用全新的互動模式。

Seminal 是什麼?

Seminal 是一個設計決策層,它不規定視覺風格,而是引導開發者與 AI 代理在打造任何使用者介面(如登陸頁面、電子商務、SaaS、儀表板、後台、分析工具、開發者工具、創意應用或行動/桌面應用)時,做出基於脈絡的明智選擇。其核心模型將每個介面決策分為三個層級:**慣例 (Convention)** 保持使用者熟悉的操作方式,**識別 (Identity)** 表達產品的獨特品牌,**創新 (Innovation)** 則為有意義的問題引入全新解決方案。此技能提供一個從理解產品與使用者、檢查既有專案、繪製使用者期望、分類表面、建立慣例帳冊到實作與驗證的完整工作流程。Seminal 支援 Claude Code、Curosr 等 AI 代理平台,透過參考文件如 product-conventions.md 和 design-judgment.md,幫助使用者避免「千篇一律」或「為創新而創新」的設計失敗模式,確保介面既直覺又具有獨特品牌個性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sewadahapp/seminal/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

Seminal 是做什麼的?

借用熟悉感,保留可用性,表達品牌識別,有目的地創新。

Seminal 是一個決策層。它不規定外觀。它迫使你思考使用者已經期待什麼、該保留哪些期待、產品的識別應該表現在哪裡,以及哪些問題(如果有的話)值得一個新的解決方案。然後它要求你建立它並誠實地檢查它。

核心模型:三個層級,分別決定

每個介面決策都屬於三個層級之一。當代理混淆它們時,就會做出糟糕的設計。

層級問題預設立場
慣例 (Convention)使用者期望這類產品 如何運作?保留它,除非它在此工作流程中失效
識別 (Identity)是什麼讓這個產品 能被認出是它自己?刻意表達它;絕不借用其他產品的
創新 (Innovation)什麼樣的新行為能讓體驗 有意義地更好?用它所解決的特定問題來證明其價值

後果:

  • 熟悉的 UX 不等於熟悉的視覺。一個市集仍保留搜尋 → 結果 → 篩選器 → 商品頁面 → 購物車 → 結帳流程,但看起來仍然不像任何其他市集。
  • 視覺原創性不授予互動原創性的許可證,反之亦然。
  • 「平庸」是識別層的失敗。「令人困惑」通常是慣例層的失敗。「花俏但無用」是創新層的失敗。在修復之前先診斷。

有兩種失敗模式,Seminal 防止這兩者:

  1. 一致性垃圾 (Conformity slop): 預設的套件元件,沒有觀點,可能是任何產品。
  2. 新奇性垃圾 (Novelty slop): 重新發明的操作暗示、裝飾性動畫和花俏的導航,迫使使用者重新學習他們已知的事物。

工作流程

根據任務調整深度。對於單一元件調整,步驟 1–5 可能需要幾句話。對於新產品或新表面,將它們寫成設計決策記錄(範本:assets/design-decision-record.md)。目標是每個表面約一頁。

根據任務載入的內容(只載入任務需要的部分):

任務載入
現有 UI 的小幅修改existing-projects,以及你觸碰部分的 ux-patterns 或 visual-direction
僅規劃或方向(尚未有程式碼)product-conventions(相關章節)、interface-classification、design-judgment
從頭到尾建構的新表面或產品隨著每個步驟出現,載入所有步驟參考
現有表面的重新設計existing-projects、layout、visual-direction、product-conventions(相關章節)
頁面結構:內容寬度、對齊、列表 vs 卡片 vs 表格、應用程式外殼layout
現有 UI 的審查或批評validation、design-judgment、product-conventions(相關章節)
對你建構的東西的模糊回饋(「看起來不對勁」、「難以閱讀」)validation(§4)、layout
感覺需要與主要利害關係人通話examples

1. 了解產品及其使用者

確定:產品的用途、使用者是誰、使用頻率、專業程度,以及他們出錯時的影響。如果摘要對此保持沉默,請從程式碼庫、資料模型、文案和路由推斷,明確陳述你的假設,並且僅在錯誤猜測會改變設計方向時才提問。在重新設計時,外觀和佈局就是方向,因此詢問它們是預期的(步驟 3)。

2. 檢查現有專案(僅在空資料夾時跳過)

在決定之前先閱讀:元件庫、令牌、主題、佈局外殼、路由、現有頁面、文案語氣、回應式方法。工作決策預設保留。如果使用者僅描述技術棧而你看不到程式碼,則根據他們描述的內容進行規劃,列出你會檢查的內容,並在建構前確認。 → references/existing-projects.md

3. 繪製期望:兩組參考資料

兩個不同的輸入,來自兩個不同的人。收集兩者。

  • 使用者從何而來(它應該如何運作)。列出使用者最可能知道的 2–5 個產品(例如,印尼市集:Tokopedia、Shopee;問題追蹤器:Jira、Linear、GitHub Issues)。提取心智模型,而非視覺,並列出該類別的慣例。對於內部工具,參考資料通常是試算表、舊有系統或紙本。找出使用者若離開它會失去什麼(大量貼上、自由排序、鍵盤速度)並保留它們。
  • 擁有人喜歡的(它應該看起來和感覺如何)。你正在為其建構的人通常心中已有品味,但還無法說出。對於新表面或重新設計,請他們提供 1–3 個他們喜歡的產品或畫面用於此表面,或使用他們已經提供的任何內容。螢幕截圖或命名的畫面是目標構圖。其行為仍須通過慣例帳冊。

擁有人會處於三種情況之一。分別處理每一種:

擁有人有……這麼做
具體參考資料以此為目標。採用構圖和感覺,而非品牌的表層(克隆測試)。
只有一種感覺(「乾淨」、「平靜」、「像真正的儀表板」)將其轉變為 2–3 個選項,每個以一個真實模式命名,並讓他們選擇(步驟 8)。
沒有想法(「你決定吧」、「不確定」)仍然提供 2–3 個選項並附上建議。人們認出他們想要的東西比描述它更快。

如果沒有任何人可以詢問,請選擇,記下你假設的參考資料,並在報告中提供替代方案。 → references/product-conventions.md、references/layout.md

4. 分類每個表面

一個產品有多個表面(行銷網站、入職引導、工作區、分析、設定、管理後台)。透過閱讀五個信號來獨立分類每個表面:使用頻率、風險、使用者專業程度、意圖(交易/操作/探索/學習/創造/被說服)和資訊密度。這些共同決定了表面的姿態:介面應該在多大程度上退居幕後以專注於任務,還是向前邁進來表達自己。 → references/interface-classification.md

5. 決定策略:慣例帳冊

對於表面上的每個重要慣例,記錄一個裁決:

  • 保留: 使用者期望它,而且它適合。(大多數條目。)
  • 精煉: 保留模型,修復已知弱點(更好的篩選器回饋、更清晰的空狀態)。
  • 替換: 僅在通過下方創新測試之後。寫下它解決的問題。
  • 丟棄: 此慣例完全不適用於此工作流程。

然後為該表面命名識別槓桿。這些是品牌展現的地方:字體、顏色、構圖、圖像、語氣、元件形狀、標誌性互動。然後命名創新賭注(零是有效數字)。 → references/design-judgment.md

6. 建立 UX 和互動模式

資訊架構、導航、核心任務流程、元件行為、表單和驗證、回饋、每個狀態(空、載入、部分、錯誤、成功、離線、無權限)、復原和撤銷、鍵盤和螢幕閱讀器存取,以及回應式行為。在樣式化之前決定這些。 → references/ux-patterns.md

7. 建立或重複使用視覺系統

如果專案已有系統,則重複使用。否則,從識別槓桿和表面姿態衍生令牌:密度、字體比例、色彩角色、表面處理、動畫預算。 → references/visual-direction.md

8. 檢查點,然後實作

建構前的選項。 當多個模式確實都有效且選擇會改變頁面外觀時(表格 vs 卡片列表 vs 網格、置中 vs 全寬欄位、側欄頁尾結構),在撰寫程式碼之前向擁有人展示 2–3 個低保真選項:每個選項附上一行描述或一個小型 ASCII 草圖,以及你的建議和理由。然後將塑造方向的決策(姿態、參考資料、關鍵帳冊裁決、選擇的選項)作為簡短摘要放入聊天中,即使你也保存了設計決策記錄。沒人閱讀的記錄無法引導任何東西。對於只有一個明顯答案的小幅修改,跳過檢查點。如果任務在無中斷下運行,請建構你的建議並將其他選項列為後續事項。

然後建構。在專案自己的框架、元件和慣例中工作。使用真實或逼真的內容(真實產品名稱、逼真的數字、長短字串、空資料集),而不是在一個完美的 3 列表格中使用 lorem ipsum。

9. 檢查並驗證

查看渲染結果。如果瀏覽器工具存在,擷取行動和桌面寬度的關鍵狀態螢幕截圖,並使用鍵盤和指標執行核心流程。然後執行驗證問題。 → references/validation.md

10. 根據實際問題進行優化

按照使用者影響程度修復檢查發現的問題。不要進行僅移動像素的潤色。當擁有人給出模糊回饋時(「看起來不對勁」、「難以閱讀」),不要立即修復你猜測的第一件事。進行測量,列出 2–3 個假設,如果是品味問題而非缺陷,請要求提供參考資料(validation.md §4)。然後報告哪些已經過驗證、哪些僅在程式碼中審查過,以及哪些未經檢查。

創新測試

在替換或發明一個模式之前,誠實回答這些問題:

  1. 此互動是否有既定的慣例?
  2. 使用者會理解並期待它嗎?
  3. 此慣例是否真的適合此工作流程、資料和使用者?
  4. 此變更解決了哪個具體、可命名的問題?
  5. 它在學習成本、可發現性、可及性、平台一致性以及努力方面付出了什麼代價?
  6. 優化現有模式是否能獲得大部分好處?
  7. 這種新穎性對使用者有用,還是僅在視覺上有趣?

決策規則: 僅在兩者都成立時才繼續:

  • 一個真正的差距: 慣例不適合(3 = 否),或此變更解決了使用者實際擁有的可命名問題(4),並且
  • 沒有更便宜的路徑: 優化慣例無法獲得大部分好處(6 = 否),並且(5)中的成本與該好處相稱。

如果問題(7)的誠實答案是「僅在視覺上有趣」,那麼這是一個識別決策,而不是創新。將其移至識別層並保持行為符合慣例。

一個客製化的互動也必須在其第 50 次使用時依然成立,而不僅僅是第一次。它必須無需教學即可被發現,或者能夠在一個時刻內學會。它必須可透過鍵盤和螢幕閱讀器存取,並且不得破壞平台期望(返回按鈕、連結、選取、複製、捲動)。

識別測試

  • 置換測試: 將競爭對手的標誌放在畫面上。如果沒有任何感覺不對勁,則識別層是空的。
  • 克隆測試: 如果一個螢幕截圖可能被誤認為是參考產品,那麼你借用了它的表層而非模型。更改識別層,而不是慣例。
  • 預設測試: 列出你因預設值而做出的選擇(框架主題、庫存字型、套件圓角、庫存漸層)。僅在刻意選擇時才保留預設值。在操作工具上,許多預設值是正確地選擇的。

姿態經驗法則(信號,非預設)

  • 高頻率 + 專家使用者 + 高密度 → 介面退居幕後。熟悉的模式、鍵盤路徑、緊湊密度、內斂色彩、近乎零裝飾性動畫。識別存在於精確性:字體、間距節奏、資料格式化、微文案、一個強調色。
  • 交易型消費者流程 → 慣例承載信任。識別存在於品牌表面,如商品陳列、圖像、語氣和促銷時刻。結帳和付款保持無趣。
  • 說服型表面(登陸頁面、活動) → 視覺實驗的最大自由度。仍然保留傳統導航、清晰的 CTA、可讀的文字和快速載入。
  • 創意和探索工具 → 當任務確實沒有良好先例時(空間畫布、時間軸、新穎操作),有更大的創新預算。保持框架——檔案、編輯、復原、匯出、設定——符合慣例。
  • 數據/分析 → 圖表選擇遵循被問的問題。層級結構遵循使用者所做的決策。裝飾會與數據競爭。

退居幕後並非一種佈局。 退居幕後意味著介面不與任務競爭。這並不意味著表格、左對齊的密集頁面或沒有個性。卡片列表、置中欄位和平靜、寬敞的頁面都可以退居幕後。當使用者比較欄位時使用表格。

當產品的 UI 也是其展示品時(設計系統自己的應用程式、開源專案、作品集產品),或者當擁有人是主要使用者時,擁有人品味是主要輸入。要求它,而不是預設使用最功利的形式。

一個產品的不同表面可以採取不同的姿態。透過共享令牌、語氣和元件行為來保持它們的一致性,而不是讓每個頁面看起來相同。

與專業技能協作(選擇性)

Seminal 決定;專業技能執行。如果已安裝像 Impeccable、Taste、UI UX Pro Max、Anti-Slop 參考資料、Frontend Design 或 motion/design-engineering 等技能,請在步驟 1–5 之後將工作路由給它們。透過慣例帳冊過濾它們的輸出。專業技能的預設設定絕不能覆蓋高頻率表面上的保留裁決。 → references/specialist-integration.md

Seminal 在沒有任何它們的情況下也能完全運作。

誠實規則

  • 永遠不要聲稱你視覺驗證了某個你未渲染和查看的東西。說「已在瀏覽器中驗證」、「僅在程式碼中審查過」或「未經檢查」,以真實的為準。
  • 陳述你對使用者及其參考產品的假設。不要將猜測當作研究。
  • 當使用者要求某事違反了創新測試(或違反了工作流程的慣例)時,在第一次回覆中提出一次:一兩句關於權衡的話,以及你建議的替代方案。

相關技能