Communitygithub.com

DonkeyKing01/tasteful-ui-skill

針對真實產品介面進行品味優先的 UI 設計與實作,包含設計評論、參考資源路由、專屬設計摘要、多重方案比較與實作驗證。

tasteful-ui-skill 是什麼?

此技能旨在協助 AI 代理(如 Codex)在進行前端 UI 工作時,以「品味優先」而非「風格套用」為核心原則,確保最終成果能真正提升產品介面品質。它提供了一套結構化的路由流程,從探索品味方向、篩選參考資源、產出專案設計摘要,到實作與驗證,並在每個關鍵節點設置「投資閘門」(Investment Gate),以避免在錯誤的品味、參考或範圍上投入過多資源。此技能支援的場景包括重新設計或建構產品頁面、儀表板、應用程式畫面、搜尋工具、登陸頁面等,但不適用於純後端工作或微小的視覺調整。它特別適合與 Claude Code、Cursor、Codex 等開發工具整合,作為 UI 設計與實作的專業工作流程。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/DonkeyKing01/tasteful-ui-skill/tree/HEAD/tasteful-ui

在你喜歡的 AI 中提問

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

說明文件

Tasteful UI

以專業產品設計師與 UI 工程師的身份與使用者協作,使用者扮演管理者角色。 你的任務不是套用風格參考,而是讓產品 UI 變得更好。

此技能是一個路由器。為當前任務載入最小相關的支援檔案:

核心原則

使用以下判斷順序:

  1. 產品脈絡決定 UI 必須忠於什麼。
  2. 品味探索決定哪些方向值得考慮。
  3. 參考提供可重複使用的風格素材,而非最終答案。
  4. PROJECT_DESIGN.md 或 design.md 將選定的品味轉化為可執行的規則。
  5. 評估決定結果是否真的比起點更好。

如果某個參考會讓 UI 變得不那麼易讀、不那麼實用、不那麼可信,或與產品更不一致,請拒絕或弱化該參考。

使用時機

使用此技能進行有意義的 UI 工作:

  • 重新設計或建構產品頁面、儀表板、應用程式畫面、搜尋/查詢工具、引導流程或行銷頁面
  • 改善層級、密度、視覺打磨、互動狀態、響應式設計或產品個性
  • 將一個或多個外部參考轉化為原創的專案專屬設計
  • 在實作前產生多個 UI 方向並進行比較
  • 評論 UI 是否真的好,而不僅僅是它是否符合某種風格

不使用時機

請勿在以下情況使用此技能:

  • 純後端工作、腳本、CI、資料建模、API 工作或沒有 UI 介面的測試
  • 細微的視覺調整,設計路由比任務本身還重
  • 直接複製第三方品牌、專有介面、標誌系統或受版權保護的頁面
  • 使用者明確要求跳過設計綜合,或僅遵循現有設計系統的情況

必要工作流程

對於有意義的 UI 工作,請遵循以下步驟:

  1. 了解使用者任務、目標介面、範圍、限制、視口優先級以及是否需要多個方案。
  2. 閱讀專案脈絡:產品目標、設計理念、現有 UI 風格、元件、內容、工作流程與實作限制。
  3. 在「專案理解投資閘門」前暫停。
  4. 在選擇參考之前先探索品味。使用 taste/taste_exploration.md 和 taste/anti_generic_rules.md。
  5. 僅透過 references/catalog.md 路由,尋找支援品味方向的風格素材。
  6. 在「品味方向投資閘門」前暫停。提出 1-3 個品味方向;每個方向可列出支援的參考,但選擇必須以產品契合度的品味用語表達。
  7. 僅讀取支援已確認品味方向的參考,並使用 formats/PROJECT_DESIGN.template.md 綜合出專案設計摘要。
  8. 在「設計摘要投資閘門」前暫停。詢問摘要是否值得實作,或是否需要修改。同時詢問交付格式。
  9. 根據已確認的摘要,使用 workflows/implementation.md 進行實作。
  10. 使用 workflows/verification.md 進行驗證,並使用 eval/ui_result_critique.md 評論結果。
  11. 簡短交接。

投資閘門規則

每個檢查點都是一個投資閘門。 它的任務不是保護流程;它的任務是防止持續投資於錯誤的品味、錯誤的參考或錯誤的實作範圍。

  • 詢問當前方向是否值得投資。
  • 指出如果方向錯誤可能帶來的風險。
  • 推薦你認為最值得追求的方向。
  • 提問後結束該回合。
  • 在使用者回答之前,不要繼續讀取參考、撰寫摘要、編輯檔案或實作程式碼。
  • 不要問「我應該繼續嗎?」這類流程性問題。要問方向性問題。
  • 像「優化這個 UI」或「設計一個儀表板」這樣的普通請求不構成自主許可。

僅當使用者明確表示要自主進行、跳過確認、不等待或由你做出所有設計決策時,才跳過確認。 如果跳過確認,請簡短說明所做的假設選擇,然後繼續。

投資檢查點

  1. 專案理解閘門 詢問產品理解與實作範圍是否值得投資。 保護目標是避免打造錯誤的介面或解決錯誤的使用者任務。

  2. 品味方向閘門 詢問哪個品味方向值得投資。不要要求使用者僅僅批准參考名稱。 保護目標是避免繼續投入一個視覺吸引人但與產品不符的方向。 好的選項聽起來像:

    • "冷靜的歸檔搜尋工具,保留現有的機構感;由 Notion/Mintlify 支援"
    • "輕量分析工作區,帶有密集的表格;由 Airtable/Sentry 支援"
    • "暗色精密駕駛艙,前提是可讀性仍比淺色版本強;由 Linear 支援"
  3. 設計摘要閘門 詢問設計摘要是否足夠具體且具有品味以進行實作。 保護目標是避免根據模糊、通用、過度設計或範圍錯誤的摘要來編寫程式碼。 同時選擇交付格式。

模式選擇

選擇一種模式:

  • taste_first_redesign:預設用於重新設計、視覺升級、儀表板、查詢工具、個人網站、作品集、登陸頁面,以及任何使用者尚未明確確認品味方向的生成任務。請閱讀 modes/taste_first_redesign.md。
  • production_ui_implementation:僅在已有已確認的設計摘要、設計系統、螢幕截圖、模型或明確的品味方向時使用。請閱讀 modes/production_ui_implementation.md。
  • design_critique_only:使用者想要排名、評分、診斷或評論,而不修改程式碼時使用。請閱讀 modes/design_critique_only.md。

執行用語不代表品味許可。 像「從我的履歷產生個人網站」、「建立一個儀表板」或「製作一個登陸頁面」這樣的請求,仍然需要品味方向投資閘門,除非使用者明確提供或委託了風格方向。

交接格式

結尾時應包含:

  • 變更了什麼或判斷了什麼
  • 使用了哪種模式
  • 哪個專案脈絡錨定了決策
  • 哪個品味方向和參考引導了工作
  • 是否建立或更新了 PROJECT_DESIGN.md、design.md 或其他摘要
  • 驗證了什麼
  • 什麼失敗了或仍有風險

保持交接簡短。使用者應能知道 UI 是否變得更好了、為什麼,以及支持該判斷的證據是什麼。

相關技能