Community影像github.com

fluxograma

專家級流程圖產生器,依據參考模型視覺風格(HTML + SVG、彩色泳道、156×92 節點、菱形決策、深色終端)建立、編輯、標準化與驗證流程圖。

fluxograma 是什麼?

這項技能旨在幫助使用者在符合特定視覺參考模型(「航海圖」風格)的前提下,建立、編輯、標準化與驗證流程圖。它會讀取使用者的文字描述、文件或現有流程圖,並以單一 HTML 檔案(內嵌 SVG)的形式,產生視覺一致的流程圖。產出的圖表會嚴格使用參考模型的 CSS、排版、幾何形狀與顏色(最多三條彩色泳道),包括 Barlow Condensed 字型、156×92 的節點尺寸,以及深色終端。技能會使用 `assets/template-base.html` 和 `scripts/` 工具來確保樣式與驗證的一致性。它支援建立、轉換、編輯與純驗證模式,並且內建一套邏輯驗證檢查,以防止出現懸空節點、缺少替代路徑的決策或流程迴圈等問題。當遇到資訊不足時,技能會主動提問,避免自行編造流程步驟或細節。對於執行 AI 代理的團隊來說,此技能特別有價值,因為其視覺模型就是專門為 AI 代理工作流程設計的。透過標準化圖表並執行驗證規則,它能確保產出的流程圖具有專業的外觀、邏輯正確性,並可作為團隊間的有效溝通工具。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pedrocavalcante87/Claude-Skill-fluxograma-/tree/HEAD

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

Fluxograma:流程圖專家(依據參考模型風格)

您產生的流程圖看起來必須與參考模型出自同一作者之手,絕不能使用新的視覺標準。 模型具有獨特風格:單一 HTML、內嵌 SVG、三條彩色泳道(綠藍色、琥珀色、酒紅色)、淺色/深色主題,以及 Barlow Condensed / IBM Plex 字型。模型檔案為 assets/template-base.html。 輸入:$ARGUMENTS(文字描述、文件路徑或現有流程圖的路徑)。若為空,請詢問流程。

不可協商的規則

  1. 不得建立新的視覺標準。 色彩、字型、形狀、尺寸、線條與間距皆來自模型。禁止重寫 CSS:必須從 assets/template-base.html 複製。變更任何數值均須取得使用者明確授權。
  2. 不得自行編造步驟、決策、負責人、期限或數字。 只有使用者(或提供的文件)所述的內容才能放入圖表。若資訊不足,請提問(步驟 3)。節點中的文字須使用使用者的原始用詞。
  3. 保留原始邏輯。 不要為了「改善」流程而修改流程圖;請在驗證報告中指出問題,由使用者決定。
  4. 所有連線必須正確。 每條箭頭必須有明確的起點和終點;每個決策必須有 2 個(含)以上的標籤輸出;沒有任何懸空元素。
  5. 避免不必要的交叉。 在允許任何交叉之前,應重新排列泳道和欄位。
  6. 不得修改參考模型(assets/template-base.html 與 assets/exemplo-reembolso.html,或使用者專案中既有的參考流程圖)。這些檔案僅供讀取。
  7. 交付前必須進行驗證,請執行 scripts/validar_fluxograma.py 並修正直到無錯誤為止。

參考模型與技能檔案

檔案用途
assets/template-base.html擁有與模型相同 CSS 及箭頭標記的頁面骨架。所有新建流程圖的起點。
assets/simulador-bloco.html選用的逐步模擬器區塊(與模型相同的 JS 引擎)。
assets/exemplo-reembolso.html完整且已驗證的範例(3 條泳道、3 個決策、迴圈、子流程)。
references/design-system.md繪圖前務必閱讀。 色票、字型、幾何形狀、附帶 SVG 的符號目錄、圖例。
references/validacao.md邏輯與視覺驗證準則,以及如何解讀驗證器輸出。
references/exemplos.md使用提示、釐清問題與報告的範例。
references/simulador.md如何填寫模擬器(僅在使用者要求時使用)。
scripts/validar_fluxograma.py驗證器(使用標準函式庫)。python -I scripts/validar_fluxograma.py 檔案.html
scripts/svg_helpers.py使用精確幾何形狀的 SVG 產生器(建議使用以避免座標錯誤)。
scripts/gerar_exemplo_reembolso.py輔助函式的使用範例。

上述路徑相對於此技能所在的資料夾。此技能是自包含的:不依賴其他專案檔案。 如果使用者專案中有自己的參考流程圖(不同的模型),也請一併讀取:若與模板不符,以專案模型為準,並告知使用者兩者間的差異。

模型的技術:使用手寫內嵌 SVG 的單一 HTML、CSS 變數(淺色/深色主題)、透過 Google Fonts 載入的 Barlow Condensed / IBM Plex 字型。不使用 Mermaid、圖片或外部函式庫。


工作流程

步驟 1:識別模式

  • 建立:根據文字描述建立。
  • 轉換:從文件/程序中轉換(讀取檔案;僅提取書面內容)。
  • 編輯:修改現有流程圖(完全讀取後再編輯;參閱「編輯」)。
  • 驗證:驗證現有流程圖(執行驗證器並呈現報告,不修改檔案)。

步驟 2:提取元素

建立工作表格(不需顯示,但內部使用)。為每個項目記錄來源(證明該項目的文字片段):

元素搜尋目標
開始觸發條件:「當…」、「收到…」時
活動動作動詞,依發生順序
決策「如果…」、「假如…」、「檢查是否…」、「核准或否決」
替代方案每個答案的結果;各自導向何處
負責人執行每個步驟的人(成為泳道)
輸入/輸出在步驟之間傳遞的文件、資料、成品(成為箭頭標籤)
子流程被描述為獨立流程的步驟
儲存庫系統、試算表、資料庫、被讀取/寫入的檔案
結束所有可能的結果(每個結果皆為一個終端)
迴圈「返回…」、「重複直到…」

步驟 3:釐清遺漏(不要自行編造)

在出現以下任何情況時,請先詢問使用者再繪圖:

  • 決策缺少替代方案描述(例如「檢查數值」但未說明兩個分支的結果)。
  • 當其他步驟都有負責人時,某一步驟缺少負責人。
  • 沒有明確的結果,或結果不明確。
  • 迴圈缺少結束條件。
  • 超過 3 個負責人/路徑(模型僅有 3 種泳道顏色 + 中性色:請詢問如何分組;不要建立第四種顏色)。
  • 會改變結構的模糊術語(例如:由誰「核准」?順序為何?)。
  • 要求使用模型不支援的視覺元素(參閱「對應表」)。

當答案簡短且封閉時,使用 AskUserQuestion;否則,使用一組簡短問題的編號清單。如果使用者說「用現有資料做」,請繼續進行,但必須在最終報告中列出每個遺漏以及所採用的最小假設,不要用編造的內容填補遺漏(將節點保留為所提供的原始描述)。

步驟 4:對應到模型符號

查閱 references/design-system.md。摘要:

流程元素模型符號
開始圓形 start + 2 行標籤
活動156×92 節點(node + 泳道顏色)
決策菱形 dia;每個輸出帶有標籤(是/否或替代方案)
結束 / 結果終端 term(深色矩形),每個不同的結果一個
儲存庫 / 資料 / 文件圓柱體 store
負責人泳道(帶有 .lt 的彩色條帶);或 .tag 文字
步驟間的輸入/輸出箭頭標籤(.el)
備註虛線註解 note
輔助流程(非主要步驟)虛線箭頭

不建立新標準的對應方式

模型沒有專門的符號來表示「負責人」、「子流程」或「文件」。請僅使用現有符號來表示它們,並在報告中記錄此決定,由使用者確認:

  • 負責人 → 泳道(顏色 + 標籤 姓名 · 角色)。如果流程只有一個負責人,則使用單一泳道;標籤仍保留。
  • 子流程 → 使用 tool 類別的節點(粗邊框 2.4)和 .tag = SUBPROCESSO。在圖例中包含「子流程」(圖例文字即為內容)。 這是一種詮釋:在模型中,tool 表示被呼叫的工具。請告知使用者。
  • 步驟類型 → .tag 文字(大寫,簡短):ATIVIDADE、APROVAÇÃO、MANUAL、SISTEMA;在代理流程中保留 LLM、CÓDIGO、BUSCA、TOOL。
  • 色調填充(llm):僅用於模型定義的、涉及 LLM 的步驟。在代理流程之外,請勿使用。
  • 識別碼(.c,等寬字型):步驟的簡短代碼(E1、E2…)或技術名稱;非必要但有助於引用步驟。

顏色:顏色 = 泳道(負責人/路徑)。類別 regra/frota/fora 僅為「顏色 1/2/3」(請勿重新命名)。箭頭使用目標泳道的顏色;中性輸入和匯流排使用 ink。

步驟 5:規劃版面(在撰寫 SVG 之前)

  1. 泳道:每個負責人/路徑一條,依出現順序由上而下堆疊。高度 168(若有菱形則更高),泳道間距 20 px。
  2. 欄位:流程由左至右。每個節點佔據一個欄位;步長 226 px(156 + 70)。起始點在 cx=40,第一個節點在 x=90。
  3. 分支:「是/主要」替代方案繼續前進;「否/例外」從底部或頂部頂點離開,前往正確的泳道。
  4. 返回(迴圈):透過直角線路向上/向下,使用空曠通道(不穿過節點)。兩個節點之間有來回連線時,使用兩條相距 ±12 px 的平行箭頭。
  5. 結束靠右對齊在同一欄位(x 相同),每個結果一個,各自位在其路徑的泳道中。
  6. 在產生之前,先草擬每個節點/箭頭的座標清單。在接受箭頭之前,先在腦中追蹤其路徑:是否與其他線條交叉?是否穿過節點?是否通過文字?
  7. viewBox = 0 0 <寬度> <高度>;寬度 = 最後一個結束的尾端 + ~24;高度 = 最後一個泳道 + 16。

如果流程太大而無法容納於一頁(超過約 14 個線性節點),建議拆分為子流程(每個子流程一個流程圖),而不是壓縮。

步驟 6:產生檔案

  • 將 assets/template-base.html 複製到目標位置(若使用者未指定路徑則詢問;建議:在專案根目錄下命名為 fluxograma-<流程名稱>.html)。
  • 填入頁首(eyebrow、h1、lede、facts)、章節標題、圖例(僅限使用到的符號)、SVG 與 figcaption。請勿修改 <style>。
  • 對於 SVG,建議使用 scripts/svg_helpers.py(一個簡短的 Python 腳本,用於建置元素列表並寫入 HTML;請參閱 scripts/gerar_exemplo_reembolso.py)。也可以手寫 SVG,從 references/design-system.md 複製區塊。
  • 每個節點、儲存庫、結束、開始和箭頭都必須有 id(節點使用 n-…,結束使用 n-t1…,箭頭使用 e1…)。模擬器和驗證器需要這些 ID。
  • 節點文字使用葡萄牙語,簡短:標題 ≤ 17 個字元,描述行 ≤ 23 個字元,最多 2 行。
  • <svg> 的 aria-label 用一句話描述流程。
  • 模擬器:僅在使用者要求時加入(references/simulador.md)。

步驟 7:驗證與修正

python -I <技能資料夾>/scripts/validar_fluxograma.py <檔案.html>

修正所有錯誤。評估每個警告(修正,或在報告中說明原因)。重複直到錯誤數歸零。然後手動執行 references/validacao.md 的邏輯檢查(腳本無法判斷流程是否正確反映使用者所述)。 若可能,在瀏覽器/無頭模式下開啟 HTML 並視覺檢查:文字被截斷和標籤重疊等問題僅能透過視覺發現。

步驟 8:交付

回覆內容應包含:

  1. 產生的檔案路徑。
  2. 摘要:泳道數、活動數、決策數、結束數;從開始到每個結束的可能路徑。
  3. 假設與遺漏(已詢問的內容、未確定的內容、以及如「子流程 = 粗邊框」等詮釋)。
  4. 驗證結果(錯誤數 0、警告及其保留原因)。
  5. 流程的改進建議(偵測到的不一致處),與圖表分開列出並不修改圖表。

編輯現有流程圖

  1. 在修改之前,完全讀取檔案並執行驗證器(以了解已存在的錯誤)。
  2. 進行最小程度的變更;保留所有未被要求修改之項目的 ID、順序、文字和座標。
  3. 插入步驟:將右側所有元素(包括箭頭點、標籤和終端)以 226 px(或根據間距為 38/70 px)的倍數位移以騰出空間;調整 viewBox 和泳道條帶。 刪除步驟:使用新箭頭重新連接起點和終點,並移除孤立的標籤。
  4. 新增決策:在相同編輯中新增所有輸出和標籤。
  5. 如果檔案使用與模板不同的 CSS,請勿「修正」該 CSS:驗證器會報錯;請回報並詢問。
  6. 重新驗證並報告變更內容(以及哪些警告因早已存在而仍保留)。

僅驗證不編輯

執行驗證器,解讀每條訊息(references/validacao.md)並交付報告:邏輯錯誤(無輸出的步驟、只有一個替代方案的決策、孤島、無出口的迴圈)、視覺問題和標準化問題。未經要求不得修正。

觸發範例

/fluxograma 當員工申請報銷時,財務部門會檢查文件。如果缺少文件,則退回;如果完整,則...
/fluxograma docs/procedimento-compras.md
/fluxograma 在 fluxograma-contratos.html 中的「審查合約」之後新增一個「法務核准」步驟
/fluxograma 驗證 fluxograma-compras.html 的邏輯

也支援自然語言觸發:「為…流程建立流程圖」、「將此程序轉換為流程圖」、「這個流程圖正確嗎?」。 更多範例、釐清問題與報告請參閱 references/exemplos.md。

已知限制(在相關時告知使用者)

  • 為忠於模型,最多3 種泳道顏色(+ 中性色)。
  • 驗證器檢查結構、幾何形狀和標準化;無法判斷流程是否忠實反映使用者的流程。此確認由您(和使用者)負責。
  • 版面以網格方式手動規劃;過大的流程應予以拆分。
  • 原始模型是為 AI 代理工作流程(LLM/CÓDIGO/BUSCA/TOOL)設計的;在適應業務流程時,使用 .tag 和泳道,而不建立新的符號。

相關技能