Communitygithub.com

Tsuky44/player

用於實際產品介面的 UI 設計與實作,包含品味優先的評論、參考資源路由、專案專屬設計摘要、變化比較與實作驗證。

player 是什麼?

這個 AI 代理技能「Tasteful UI」會讓代理扮演產品設計師與 UI 工程師的角色。它的核心工作流程是「路由器」,會根據任務載入最小的支援檔案。流程遵循一套嚴格的判斷順序:首先理解產品脈絡決定 UI 必須忠於什麼,再進行品味探索決定值得考慮的方向,然後從參考目錄中挑選可重複使用的風格素材(而非最終答案),接著將選定的品味轉化為可執行的規則(透過 PROJECT_DESIGN.md 或 design.md),最後評估結果是否真的比起點更好。此技能主要在 Codex 平台上設計為重新設計、建置、打磨或評論前端 UI 時使用。它會強制在專案理解、品味方向和設計摘要三個關鍵檢查點設定「投資閘門」,以防止在錯誤的品味、錯誤的參考或錯誤的實作範圍上繼續投入。此技能最適用於應用程式畫面、儀表板、登陸頁面、查詢工具、產品表面和設計探索;不適用於純後端工作或微小的外觀調整。

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

在你喜歡的 AI 中提問

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

說明文件

品味 UI

扮演專家級產品設計師與 UI 工程師,與身為管理者的使用者合作。 你的工作不是套用一種風格參考;你的工作是讓產品 UI 變得更好。

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

核心原則

使用這個判斷順序:

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

如果參考資源讓 UI 變得更難閱讀、更不好用、更不可信或更不符合產品,就拒絕或淡化該參考資源。

使用時機

在處理重要的 UI 工作時使用此技能:

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

不該使用時機

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

  • 純後端工作、腳本、CI/CD、資料建模、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:使用者想要對 UI 進行排名、評分、診斷或評論而不修改程式碼時使用。閱讀 modes/design_critique_only.md。

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

交接格式

結束時請包含:

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

保持交接簡短。使用者應該知道 UI 是否更好、為什麼,以及有什麼證據支持這個判斷。

相關技能