Communitygithub.com

coastdigitalgroup/coastai-skills

設計並實作有目的的「空狀態」(無資料畫面),引導使用者、減少挫折感,並在內容缺失或尚待建立時提供明確的行動路徑。

coastai-skills 是什麼?

這項技能提供了一個完整的「空狀態系統」框架,用於設計應用程式中沒有資料可顯示時的畫面。它將空狀態視為引導新使用者、教育與主動探索的機會,而不是單純顯示空白畫面或「找不到結果」的訊息。該系統支援首次執行體驗、搜尋結果為零、篩選無資料、空容器(如購物車)以及錯誤狀態等多種情境。透過明確的輸入(空狀態類型、使用者意圖、核心價值主張與可用操作)與輸出(空狀態藍圖、情境邏輯與發現策略),它引導開發者逐步建立有層次且行動導向的空狀態設計。同時,技能中包含了關鍵的決策規則(如單一操作原則、同理心優先於幽默)以及嚴格的無障礙與響應式設計限制,協助避免常見的失敗模式,例如死胡同、過度設計或負面語氣。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/empty-state-system

在你喜歡的 AI 中提問

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

說明文件

空狀態系統

目的

空狀態系統提供了一個框架,用於設計當沒有資料可顯示時出現的畫面或元件。與其顯示空白畫面或通用的「找不到結果」訊息,此系統將空狀態視為引導新使用者、教育與主動發現的機會。它將潛在的死胡同轉化為富有生產力的時刻,維持使用者動能並釐清系統效用。

使用案例

  • 首次體驗: 使用者首次登入且尚未建立任何內容時(例如空白的儀表板或專案列表)。
  • 搜尋結果: 使用者的搜尋查詢未傳回任何相符項目時。
  • 篩選: 多個作用中篩選條件組合導致資料格為空時。
  • 空容器: 特定的 UI 元素,例如空的購物車、已清空的通知中心或全新的最愛清單。
  • 錯誤狀態: 因權限或連線問題導致內容無法載入時(次要使用案例)。

何時不應使用

  • 載入狀態: 當內容預計即將顯示時,應使用骨骼框架或旋轉圖示。
  • 永久的「死」頁面: 請使用 404 頁面處理連結失效或已刪除的資源。
  • 部分內容: 如果仍有部分資料可用但數量有限,應使用標準版面配置模式,而非空狀態。
  • 被動背景: 請勿用於設計上本應留空的區塊(例如邊距或裝飾性的空白區域)。

輸入

  1. 空場景類型: 這是使用者已清空的狀態(成功)、首次執行狀態(引導新使用者),還是搜尋失敗(探索)?
  2. 使用者意圖: 使用者原本試圖達成或尋找什麼?
  3. 核心價值主張: 目前缺失的內容最主要的好處是什麼?
  4. 可用操作: 對使用者而言「最佳的下一個步驟」是什麼?

輸出

  1. 空狀態藍圖: 一個結構化定義,包含插圖、標題、內文與主要行動呼籲按鈕。
  2. 情境邏輯: 何時何地應觸發空狀態的規則。
  3. 發現策略: 填補空白處的建議內容或教育提示之建議。

工作流程

1. 識別空觸發條件

判斷狀態為何為空。將其分類以選擇適當的語氣:

  • 首次執行(教育性): 鼓勵第一次的「建立」操作。
  • 使用者已清空(正面): 確認完成(例如「全部完成!」)。
  • 搜尋/篩選(輔助): 提供擴大或調整搜尋範圍的方式。

2. 建立視覺層級

使用「三點法則」(針對空狀態修改)來建構空狀態:

  • 錨點(視覺): 一個不分散注意力的圖示或插圖,用以設定基調。
  • 情境(訊息): 一個清楚的標題說明_為什麼_是空的,以及內文說明_如何_改變它。
  • 目標(行動呼籲): 一個主要按鈕,用於觸發內容的建立或重設篩選條件。

3. 草擬行動導向的文字

  • 標題: 要具體。不要用「沒有項目」,而要用「您尚未建立任何專案。」
  • 內文: 提供價值。「專案能協助您組織任務。建立您的第一個專案即可開始。」
  • 行動呼籲: 使用利益驅動的動詞。「建立專案」或「開始免費試用」。

4. 提供發現路徑(次要操作)

如果沒有直接的「建立」操作(例如在搜尋中),請提供替代方案:

  • 重設: 清除所有篩選條件的連結。
  • 建議: 熱門類別或「您是不是要查詢...」的建議。
  • 教育: 連結到文件或影片教學。

5. 定義技術限制

  • 響應式設計: 確保空狀態在小型視窗中仍能置中並清晰可讀。
  • 無障礙: 使用適當的 ARIA 角色(例如 role="status")以確保狀態在動態出現時能被輔助技術宣告。

決策規則

  • 單一操作原則: 專注於「一個」主要操作,以避免在使用者可能感到困惑的時刻造成資訊過載。
  • 同理心優先於幽默: 雖然可以帶入一點個性,但應優先考慮清晰度與助益。避免使用會隱藏解決方案的「巧妙」文字。
  • 直接 vs. 間接:
    • 如果使用者_可以_修正(例如首次執行),請使用主要行動呼籲按鈕。
    • 如果使用者_無法_修正(例如搜尋失敗),請使用建議或重設連結。
  • 圖像相關性: 使用能強化特定情境的插圖(例如搜尋使用放大鏡,檔案使用資料夾)。

限制

  • 無障礙: 空狀態插圖必須設有 aria-hidden="true" 或僅作為裝飾用途。文字必須符合 WCAG AA 對比度要求。主要行動呼籲按鈕以及任何次要連結/按鈕都必須符合 WCAG 2.2 SC 2.5.8(24x24px 最小目標尺寸)。
  • 尺寸: 空狀態不應超過其所取代的實際內容之容器寬度。
  • 一致性: 在整個網站中使用相同的視覺風格與版面配置來處理所有空狀態,以建立模式辨識。

常見失敗模式

  • 「死胡同」: 告知使用者某個區塊是空的,卻沒有告訴他們如何解決。
  • 過度設計: 使用複雜、沉重的插圖,分散了對主要行動呼籲按鈕的注意力。
  • 負面語氣: 使用聽起來像錯誤或失敗的語言(例如「搜尋失敗!」)。
  • 通用文字: 從搜尋到首次引導新使用者,所有情況都使用「沒有結果」。
  • 行動裝置溢出: 在桌機上看起來很棒,但在行動裝置上需要垂直捲動才能看到行動呼籲按鈕的設計。

驗證標準

  • 空狀態清楚說明為何出現。
  • 有明確、可操作的主要行動呼籲按鈕或「重設」路徑。
  • 視覺層級引導目光從視覺元素移動到行動呼籲按鈕。
  • 語氣符合情境(引導新使用者 vs. 搜尋失敗)。
  • 狀態具備無障礙性(對比度、鍵盤導航、透過 role="status" 或等效即時區域的螢幕閱讀器宣告)。
  • 主要行動呼籲按鈕符合 WCAG 2.2 SC 2.5.8(24x24px 最小目標尺寸)。
  • 版面配置具有響應式且在其父容器內置中對齊。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

相關技能