Communitygithub.com

步驟與進度系統

設計並實作結構化的進度指示器與多步驟流程,引導使用者完成複雜任務,並清楚回饋目前位置與剩餘進度。

步驟與進度系統 是什麼?

步驟與進度系統 skill 提供一套設計與記錄多步驟流程或背景任務進度的方法論。此技能專注於將複雜的工作流程(如結帳或入門引導)分解為可管理的區塊,透過清楚溝通使用者的當前位置、已完成事項以及待辦事項來降低認知負擔。它支援多種視覺模式,包括水平步驟器、垂直步驟器、連續進度條和進度圓圈,並定義了待處理、進行中、完成與錯誤等狀態的視覺規範。此技能提供決策規則(如 5 步驟規則)、可及性規範(ARIA 角色、對比度要求、點擊目標尺寸)、響應式設計策略,以及常見失敗模式的檢查清單,是開發者建置可靠且使用者友善的多步驟介面的實用參考。

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

在你喜歡的 AI 中提問

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

說明文件

步驟與進度系統 是做什麼的?

目的

步驟與進度系統 skill 提供一套方法論,用於設計和記錄使用者如何進行多步驟流程或等待背景任務。它確保複雜的工作流程(例如結帳或入門引導)被分解為易於管理的區塊,透過溝通使用者的目前位置、已完成的內容以及剩餘工作來降低認知負擔。

使用案例

  • 電子商務結帳: 引導使用者進行運送、付款與審查。
  • 多步驟表單: 將長篇資料輸入任務分割為邏輯章節。
  • 使用者入門引導: 視覺化新帳號的設定流程。
  • 載入/上傳狀態: 溝通長時間執行作業的狀態。
  • 學習路徑: 顯示課程或課程大綱的進度。

何時不應使用

  • 單一檢視任務: 如果任務可以在一個檢視中完成而不需切換上下文,則進度系統會增加不必要的噪音。
  • 無限捲動: 滾動瀏覽內容時,沒有定義「終點」的進度。
  • 關鍵高速互動: 如果顯示進度指示器會妨礙時間敏感的任務(例如即時遊戲 UI),則不應使用。

輸入

  1. 步驟清單: 完成任務所需的離散階段列表。
  2. 任務類型: 是使用者驅動的序列(步驟器)還是系統驅動的流程(進度條)?
  3. 線性程度: 步驟必須按順序完成,還是使用者可以隨時跳轉?
  4. 內容限制: 每個步驟的標籤、描述與圖示。

輸出

  1. 進度框架: 元件類型(水平、垂直或圓形)的定義。
  2. 狀態矩陣: 待處理、進行中、完成與錯誤狀態的視覺規格。
  3. 響應式策略: 指示器如何適應行動裝置視口(例如隱藏標籤、切換為數字)。
  4. 可及性規格: ARIA 角色、即時區域以及鍵盤互動規則。

工作流程

1. 分類進度類型

選擇最合適的視覺模式:

  • 水平步驟器: 最適合桌面上 3–5 步驟的線性流程。
  • 垂直步驟器: 最適合非線性流程、步驟內容長度不一,或行動裝置優先的流程。
  • 連續進度條: 最適合系統驅動的任務(上傳、載入)或具有大量微步驟的流程。
  • 進度圓圈: 最適合儀表板小工具或空間極度受限的情況。

2. 定義步驟階層與標籤

  • 主要標籤: 步驟的簡潔名稱(例如「運送」)。
  • 次要標籤(選擇性): 簡短描述或狀態(例如「進行中」)。
  • 視覺指示器: 數字(表示順序)、圖示(表示上下文)或圓點(用於極簡設計)。

3. 建立狀態視覺化

為每個狀態定義清晰的視覺區別:

  • 待處理: 低對比度,通常呈現灰色。
  • 進行中: 高對比度,通常使用主要品牌顏色或「發光」效果。
  • 完成: 使用「勾選」圖示和顯著的顏色(通常為綠色或進行中顏色的柔和版本)。
  • 錯誤: 使用「警告」圖示和語意錯誤顏色(紅色)。

4. 設計移動與回饋

  • 轉場: 在步驟之間使用微妙的動畫來強化進展。
  • 可點擊性: 決定使用者是否可以點擊先前的步驟以返回。
  • 驗證: 在允許前進之前,視覺化提示某步驟是否有效/已完成。

5. 規劃響應式適應

多步驟指示器在行動裝置上很容易出現問題:

  • 標籤縮減: 在行動裝置上隱藏文字標籤,僅顯示數字或圖示。
  • 轉換為「第 X 步,共 Y 步」: 將完整的視覺條替換為簡單的文字或數字摘要。
  • 垂直轉換: 在小螢幕上將水平條轉換為垂直列表。

決策規則

  • 5 步驟規則: 如果水平步驟器超過 5 個步驟,則應切換為垂直步驟器或簡單的「第 X 步,共 Y 步」文字指示器,以避免雜亂。
  • 圖示 vs. 數字: 如果順序順序至關重要,則使用數字;僅在圖示能提供即時語意價值時使用圖示(例如「信用卡」圖示代表付款)。
  • 線性: 如果使用者必須依序完成步驟,則停用「未來」步驟的點擊功能。如果是靈活的設定,則允許跳轉。
  • 上下文保留: 始終顯示當前、上一步和下一步的標籤。必要時可以截斷其他標籤。

限制條件

  • 可及性:
    • 對於連續條,使用 role="progressbar" 搭配 aria-valuenow、aria-valuemin、aria-valuemax 以及人類可讀的 aria-valuetext(例如「第 2 步,共 4 步:付款」)。
    • 使用 aria-current="step" 來識別序列中的當前步驟。
    • 確保進行中與非進行中步驟的對比度符合 WCAG AA(4.5:1)。
    • 如果步驟可點擊,其點擊目標必須符合 WCAG 2.2 SC 2.5.8(最小 24x24 像素,建議 44 像素),並顯示可見的 :focus-visible 狀態。
  • 階層: 進度指示器應作為指引,而非主要焦點。它通常位於內容的頂部(水平)或左側(垂直)。
  • 響應式: 不得導致水平溢出。

常見失敗模式

  • 「神秘進度」: 顯示沒有標籤或百分比的條,讓使用者納悶「還要多久?」
  • 無法存取的狀態: 僅使用顏色(例如綠色 vs. 灰色)來指示完成,而沒有圖示或文字。
  • 擁擠的水平佈局: 在水平佈局中強制塞入太多步驟,導致行動裝置上文字重疊或點擊目標過小。
  • 缺乏持續性: 在多步驟流程的某些頁面上隱藏進度指示器,導致使用者失去位置感。

驗證標準

  • 當前步驟與已完成和即將進行的步驟清楚區分。
  • 完成的步驟使用非顏色指示器(例如勾選記號)。
  • 行動裝置檢視正常,不會溢出或雜亂。
  • 正確應用 ARIA 角色和 aria-current。
  • 系統能處理個別步驟的「錯誤」狀態。
  • 指示器在流程的所有步驟中位置一致。

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.

相關技能