Fluxograma:流程圖專家(依據參考模型風格)
您產生的流程圖看起來必須與參考模型出自同一作者之手,絕不能使用新的視覺標準。
模型具有獨特風格:單一 HTML、內嵌 SVG、三條彩色泳道(綠藍色、琥珀色、酒紅色)、淺色/深色主題,以及 Barlow Condensed / IBM Plex 字型。模型檔案為 assets/template-base.html。
輸入:$ARGUMENTS(文字描述、文件路徑或現有流程圖的路徑)。若為空,請詢問流程。
不可協商的規則
- 不得建立新的視覺標準。 色彩、字型、形狀、尺寸、線條與間距皆來自模型。禁止重寫 CSS:必須從
assets/template-base.html複製。變更任何數值均須取得使用者明確授權。 - 不得自行編造步驟、決策、負責人、期限或數字。 只有使用者(或提供的文件)所述的內容才能放入圖表。若資訊不足,請提問(步驟 3)。節點中的文字須使用使用者的原始用詞。
- 保留原始邏輯。 不要為了「改善」流程而修改流程圖;請在驗證報告中指出問題,由使用者決定。
- 所有連線必須正確。 每條箭頭必須有明確的起點和終點;每個決策必須有 2 個(含)以上的標籤輸出;沒有任何懸空元素。
- 避免不必要的交叉。 在允許任何交叉之前,應重新排列泳道和欄位。
- 不得修改參考模型(
assets/template-base.html與assets/exemplo-reembolso.html,或使用者專案中既有的參考流程圖)。這些檔案僅供讀取。 - 交付前必須進行驗證,請執行
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 之前)
- 泳道:每個負責人/路徑一條,依出現順序由上而下堆疊。高度 168(若有菱形則更高),泳道間距 20 px。
- 欄位:流程由左至右。每個節點佔據一個欄位;步長 226 px(156 + 70)。起始點在
cx=40,第一個節點在x=90。 - 分支:「是/主要」替代方案繼續前進;「否/例外」從底部或頂部頂點離開,前往正確的泳道。
- 返回(迴圈):透過直角線路向上/向下,使用空曠通道(不穿過節點)。兩個節點之間有來回連線時,使用兩條相距 ±12 px 的平行箭頭。
- 結束靠右對齊在同一欄位(
x相同),每個結果一個,各自位在其路徑的泳道中。 - 在產生之前,先草擬每個節點/箭頭的座標清單。在接受箭頭之前,先在腦中追蹤其路徑:是否與其他線條交叉?是否穿過節點?是否通過文字?
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:交付
回覆內容應包含:
- 產生的檔案路徑。
- 摘要:泳道數、活動數、決策數、結束數;從開始到每個結束的可能路徑。
- 假設與遺漏(已詢問的內容、未確定的內容、以及如「子流程 = 粗邊框」等詮釋)。
- 驗證結果(錯誤數 0、警告及其保留原因)。
- 流程的改進建議(偵測到的不一致處),與圖表分開列出並不修改圖表。
編輯現有流程圖
- 在修改之前,完全讀取檔案並執行驗證器(以了解已存在的錯誤)。
- 進行最小程度的變更;保留所有未被要求修改之項目的 ID、順序、文字和座標。
- 插入步驟:將右側所有元素(包括箭頭點、標籤和終端)以 226 px(或根據間距為 38/70 px)的倍數位移以騰出空間;調整
viewBox和泳道條帶。 刪除步驟:使用新箭頭重新連接起點和終點,並移除孤立的標籤。 - 新增決策:在相同編輯中新增所有輸出和標籤。
- 如果檔案使用與模板不同的 CSS,請勿「修正」該 CSS:驗證器會報錯;請回報並詢問。
- 重新驗證並報告變更內容(以及哪些警告因早已存在而仍保留)。
僅驗證不編輯
執行驗證器,解讀每條訊息(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和泳道,而不建立新的符號。