Communitygithub.com

coastdigitalgroup/coastai-skills

設計並實作一套系統化框架,用於管理時間順序的事件與活動日誌,涵蓋空間節奏、事件分組與狀態視覺化。

coastai-skills 是什麼?

這個技能提供了一個系統性的方法論,用於設計時間順序的事件序列、歷史紀錄或路線圖。它的核心目標是讓使用者能夠有效追蹤進度、理解時間關聯性,並快速掃視歷史數據,同時在資訊密度與空間節奏之間取得平衡。此技能特別適用於 SaaS 儀表板的活動動態、產品路線圖、版本發布說明、公司里程碑或電子商務的訂單追蹤等場景。它支援垂直與水平時間軸佈局,並定義了事件節點(節點)、內容區塊、時間分組策略以及響應式設計藍圖。技能文件也明確列出了不建議使用的情境,例如單純的步驟進度或全域導航,並在決策規則中強調了時間線的連貫性、事件分組的門檻,以及符合無障礙標準的實作方式(如使用語意化標記與 aria-live 區域)。最終會產出一份時間軸結構規格、分組策略、狀態矩陣與響應式設計藍圖,協助開發者建立清晰、可掃視且具備良好使用者體驗的時間軸元件。

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

在你喜歡的 AI 中提問

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

說明文件

時間軸活動系統

目的

時間軸活動系統提供了一種設計時間順序事件、歷史紀錄或路線圖的方法論。它確保使用者能夠追蹤進度、理解時間關聯性,並有效率地掃視歷史數據。此系統在資訊密度與空間節奏之間取得平衡,確保「何時」與「何事」的敘事在所有檢視區域中清晰可見。

使用案例

  • 為 SaaS 儀表板設計活動動態(例如:專案歷史)。
  • 建構產品路線圖或版本發布說明。
  • 組織公司歷史或「關於我們」的重要里程碑。
  • 為電商實作訂單追蹤或出貨歷史。
  • 管理多階段流程視覺化(例如:申請狀態)。

不建議使用時機

  • 線性步驟進度: 若需要使用者即時完成簡單的步驟序列,請使用 step-progress-system。
  • 純表格數據: 若主要目標是依多個欄位進行排序與篩選(例如:完整的財務稽核日誌),請使用 data-table-ui-system。
  • 全域導航: 若為全站結構,請使用 site-navigation-system。
  • 簡單部落格動態: 若標準卡片在網格或列表中已足夠,且無需視覺「線索」或時間標記。

輸入

  1. 事件清單: 事件、時間戳記與相關元資料的列表。
  2. 時間解析度: 使用者關心的是秒、天還是年?
  3. 事件類型: 事件的分類(例如:資訊、成功、警告、錯誤,或里程碑 vs. 次要動作)。
  4. 空間限制: 時間軸將位於側邊欄、全頁檢視還是狹窄的卡片中?
  5. 品牌標記: 顏色、字體尺度與間距標記。

輸出

  1. 時間軸結構規格: 「時間線」(垂直/水平線)、「節點」(標記)與「內容區塊」的定義。
  2. 分組策略: 事件分組的規則(例如:「今天」、「昨天」、「2023 年 10 月」)。
  3. 狀態與狀態矩陣: 不同事件類型與互動狀態的視覺處理方式。
  4. 響應式設計藍圖: 時間軸如何從置中或交替佈局適應為單欄行動版檢視。

工作流程

1. 定義時間線與方向

確定時間的方向:

  • 垂直(標準): 最適合內容長度多變的長歷史。
  • 水平: 最適合高層次的路線圖或短流程,且水平空間充足。

建立「時間線」(連接事件的線條),並確保其具備一致的視覺權重與顏色(通常為中性且柔和的色調)。

2. 建立事件節點與標記

設計每個事件的視覺錨點:

  • 簡單節點: 用於次要動作的小點或圓圈。
  • 圖示節點: 圓圈內放置圖示以指示事件類型(例如:勾選圖示代表「已完成」)。
  • 日期標記: 浮動在節點旁邊或上方的標籤。

3. 應用空間節奏與分組

透過時間段對事件進行分組,避免視覺雜亂:

  • 相對分組: 「剛剛」、「2 小時前」。
  • 絕對分組: 「星期一,10 月 23 日」、「2023 年 9 月」。

使用 fluid-spacing-system 維持事件之間的垂直間距一致。高優先級的里程碑應比次要活動項目擁有更多的空白區域。

4. 組織內容區塊

對每個節點旁的內容應用 visual-hierarchy-system:

  • 標題: 核心動作或事件名稱。
  • 元資料: 時間戳記、執行者(使用者頭像/名稱)與類別。
  • 主體/描述: 可選的詳細資訊或展開的內容。
  • 動作: 上下文相關的按鈕(例如:「檢視詳細資訊」、「復原」)。

5. 規劃響應式適應

  • 交替佈局(Z 字模式): 在桌機上,事件在時間線左右交替排列。在行動裝置上,摺疊為單欄(時間線在左,內容在右)。
  • 單側佈局: 為行動裝置標準化為「時間線在左,內容在右」,以最大化可讀性。

決策規則

  • 「時間線」規則: 除非有時間上的邏輯斷層或「載入更多」的操作,否則時間線不應中斷。
  • 分組門檻: 如果同一天內有超過 5 個事件,將它們分組在單一日期標題下,以減少重複文字。
  • 「節點」層級: 對「里程碑」使用較大節點或品牌顏色,對「活動」使用較小且中性的節點。
  • 時間戳記位置: 對於垂直時間軸,將時間戳記放置在時間線左側(桌機)或標題正下方(行動裝置),以利於快速掃視。

限制條件

  • 無障礙性: 時間軸必須能以列表形式導覽(<ul> 或 <ol>)。包含圖示的節點必須具備 aria-label 或為螢幕閱讀器提供的隱藏文字。將時間戳記包裹在 <time datetime="..."> 元素中,使「2 小時前」這類相對標籤仍保持機器可讀性。對於即時更新的活動動態,在 aria-live="polite" 區域(而非整個列表)內新增條目,讓螢幕閱讀器使用者在不失去位置的情況下聽到新事件。
  • 響應性: 時間軸絕不能超出檢視區域。水平時間軸必須在行動裝置上切換為垂直或使用水平捲動。
  • 視覺對比: 時間線與節點必須與背景達到 3:1 的對比度。

常見失敗模式

  • 時間線中斷: 垂直線條任意地開始與結束,導致難以跟隨順序。
  • 資訊過載: 在每個事件中包含過多的主體文字,使時間軸變成一片文字牆。
  • 對齊不一致: 在相同時間軸內混用置中與靠左對齊的文字,卻沒有明確的邏輯。
  • 行動裝置擁擠: 在行動裝置上試圖維持交替(左/右)佈局,導致文字欄位過小。

驗證標準

  • 事件遵循清晰且一致的時間順序(遞增或遞減)。
  • 視覺標記(節點)與連接的時間線具備一致的樣式。
  • 已使用時間分組(例如:「今天」)來降低認知負擔。
  • 已定義並實作響應式行為(例如:摺疊為單欄)。
  • 無障礙性:時間軸以語意化列表標記,且時間戳記使用 <time datetime="...">。
  • 即時動態透過限定的 aria-live="polite" 區域宣佈新條目,且不干擾螢幕閱讀器焦點。
  • 主要的里程碑在視覺上與次要活動有別。

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.

相關技能