Communitygithub.com

工作流程視覺化工具

將工作流程、程序或處理過程以視覺化頁面呈現,包含符號圖例、資訊框和具體解說,並根據流程結構自動選擇最合適的圖形樣式。

工作流程視覺化工具 是什麼?

Workflow Visualizer 是一項專為開發者與 AI 代理設計的技能,用於將繁複的文字流程轉化為結構化、直觀的視覺化頁面。它透過分析流程的內在結構(如決策點、迴圈、交接、平行任務等),從流程圖、分支圖、泳道圖、循環圖、平行軌道圖與時間軸等形狀中選出最適合的一種,並依據預先定義的符號系統與樣式規範生成可供發布的 HTML 頁面。此技能尤其適合需要深入理解步驟細節的場景,例如「詳細說明」、「逐步解釋」或「再次解釋流程」,但不會因使用者隨口提及「工作流程」一詞就啟動。支援多種平台(如 Claude Code、Cursor 等 AI 代理開發環境),且具備嚴謹的檢查清單以確保輸出一致、無資訊遺漏。其設計強調中立美學(無陰影、漸層、圓角與表情符號),並可透過 CSS 變數輕鬆配合品牌樣式,同時保持行動裝置優先的響應式佈局。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jirispataart-deve/workflow-visualizer/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

工作流程視覺化工具 是做什麼的?

當有人想深入了解工作流程的細節時,純文字往往不夠充分。一個流程包含順序、交接、決策和等待時間。合適的圖形能讓這些資訊一目瞭然。圖形應取代長篇文字回答,而非附加於其上。

形狀可自由選擇。任何形狀都沒有優先權,無論是時間軸還是其他。流程的結構決定形狀。

適用時機

同時滿足以下兩個條件時啟用:

  1. 主題是工作流程、程序或處理過程(使用者自己的、討論過的,或需要從頭解釋的)。
  2. 使用者想要更深入的內容:「詳細說明」、「更精確」、「逐步解釋」、「再次解釋」、「如何運作」。

如果「工作流程」一詞只是順帶提及,且問題可以快速回答,則在對話中簡短回覆即可。為每一個隨口提及的詞語都產生圖形會降低其價值。

操作步驟

  1. 釐清流程。 從對話、檔案或使用者指定的來源取得流程。如果缺少關鍵要素,簡短詢問一次即可。請勿自行發明步驟、時間或工具。任何未經確認的資訊都標記為「開放」。
  2. 閱讀結構,然後選擇形狀。 請參閱下一節。在對話中以一句話說明選擇了哪種形狀及其原因。使用者可用一句話推翻您的選擇。
  3. 規劃大綱。 總共 4 到 10 個步驟,分為 2 到 4 個階段或泳道。步驟過多會稀釋圖形;請將子流程合併。
  4. 填寫每個步驟。
    • 時間標記或位置:真實的持續時間、時間點或順序(例如「步驟 3」)。請勿使用推測的時間。
    • 圖例中的一個符號。
    • 標題(名詞,簡短)以及一至兩句說明發生了什麼及原因。
    • 可選的重要框:僅當某項資訊對流程成敗至關重要時使用(例如先決條件、錯誤來源、核準)。
    • 可選的具體框:一個具體的圖像、範例或比喻,使抽象的步驟易於理解。圖像應能解釋事物,而非裝飾。
  5. 建立圖例。 僅包含圖形中出現的符號,以及所選形狀的元素。圖例置於頂部。
  6. 以頁面形式交付。 從 assets/base-template.html 建構(包含標記、頁首、圖例、資訊框),並根據 references/shapes.md 加入所選形狀的結構。流程圖有範例 assets/flowchart-example.html:可重複使用其 CSS 並替換內容。頁面標題應為工作流程的名稱,例如「文件核准流程」。如果您的環境可以發布頁面或成品,請發布;否則交付一個自包含的 HTML 檔案。
  7. 在對話中回覆。 一至兩句話:選擇的形狀及其原因,以及任何未解決的問題。請勿重複圖形內容。

選擇形狀

先閱讀工作流程的結構,再決定形狀。以下問題有助於判斷:

  • 是否有決策點導致往回走(形成迴圈),或路徑會再次交會,且讀者應該能用手指追蹤路徑? → 流程圖
  • 路徑在決策點分岔,並在不同位置結束,不再返回? → 分支圖
  • 流程中涉及多人、工具或角色,困難點在於交接,且沒有迴圈? → 泳道圖
  • 流程在最後一步完成後原樣重新開始,或結果會饋入下一次運行,且中間沒有決策點? → 循環圖
  • 多條線索同時進行,且必須在某處匯合? → 平行軌道圖
  • 流程核心是按時間順序的一系列步驟,且等待時間、截止日期或持續時間很重要? → 時間軸
  • 工作流程混合了多種特性?選擇讀者最可能出錯的那一種。次要特性則以資訊框或位置標記呈現:流程圖可以在不引入泳道的情況下,顯示步驟發生的位置。

迴圈是切換形狀最常見的原因。將它藏在資訊框裡等於埋沒了它,而這正是讀者容易困惑的地方。如果存在迴圈,流程圖通常是最誠實的形狀,即使泳道圖或時間軸乍看之下很適合。

請勿根據外觀或習慣選擇。形狀若與結構不符,會扭曲流程:座標軸會隱藏替代方案;沒有實際交接的泳道只不過是裝飾。

每種形狀的詳細建構規則請見 references/shapes.md。只需閱讀所選形狀的章節。

符號

全部使用直角,無圓形。形狀以 CSS 繪製而非字元,以確保在不同環境下顯示一致。

符號形狀意義
動作實心正方形完成或產生某件事
決策空心正方形流程在此分岔
檢查點菱形檢查、簽核、核准
交接三角形結果轉移到某人、工具或階段
等待水平條無主動事件發生,時間流逝
開放虛線正方形資訊缺失或未經確認

只有在工作流程確實需要時才加入其他符號,並在圖例中說明。

風格樣式

範本預設為中性風格:溫暖的紙質背景、近墨色的文字、一種淡雅強調色僅用作底色,以及系統字型。所有顏色都在 :root 中以變數定義。如果使用者有品牌或設計系統,僅需修改這些變數;請勿重新設計結構。

  • 紙張為背景,墨色用於標題,石墨色用於內文,平靜色調用於靜態底色,細線用於格線。
  • 強調色僅用作底色,從不用於文字或線條顏色。其上文字始終為墨色。每頁最多一個大型強調色帶;階段和泳道標題下方的小標記條(10px)可重複使用。
  • 僅使用一種字型。透過字重和字距建立層級;字距僅應用於大寫文字。
  • 無陰影、無漸層、無圓角、無表情符號、無驚嘆號。項目符號使用墨色正方形。連接線為直線、直角、2px 墨色。
  • 頁面保持在紙質單一主題。所有顏色都明確設定,以便在淺色和深色 UI 中顯示一致。
  • 行動裝置優先,頁面無水平捲動。需要更寬的內容(例如泳道)在其自身容器內滾動。

請勿發明新的顏色、字型或形狀。如果系統缺乏某項功能,請說明差距並在既有變數範圍內解決。

語言

以使用者正在使用的語言撰寫圖形。保持客觀、以名詞為主、簡潔。避免廢話和流行用語。解釋可以生動但精確:用一個強而有力的圖像取代三個薄弱圖像。

交付前檢查清單

  • 形狀遵循工作流程的結構,並且對話中陳述了選擇原因。
  • 每個迴圈都以路徑繪製,而非僅在文字中提及。
  • 每個時間陳述均有記錄,或僅標記為順序。
  • 所有未經確認的資訊都帶有「開放」符號。
  • 圖形中出現的所有符號均在圖例中,且無其他符號。
  • 強調色僅用作底色,從不用於文字或線條。
  • 即使在 400px 寬度下,文字也不會超出邊界。
  • 對話文字未重複圖形內容。

相關技能