Flow Diagram
Flow Diagram 是用於製作可執行系統與流程圖表的創作技能：一次創作，即可播放、嵌入、檢查與匯出結果。
將文字描述與原始素材轉化為視覺化解釋：靜態或動畫圖表，清晰呈現結構、關係與流程。目標是保留原始含義，並幫助讀者理解事物如何組織、連接與隨時間變化。
選擇任務
此技能產出圖表素材；PPTX 檔案與原生 PowerPoint 形狀不在此範圍內。
識別任務類型、使用的輸入，以及進入或繼續流程的點。
| 請求 | 起始點 |
|---|---|
| 新圖表或將創作或修訂的 JSON 匯入 | 完成偏好預檢，然後遵循所有五個步驟。必要時保留未變更的匯入位元組。 |
| 用於匯出或檢查的未變更 JSON 匯入 | 使用匯出或診斷入口點；跳過偏好預檢並保留輸入設計。 |
| 修訂已定稿的圖表 | 讀取現有圖表與最終報告。確定請求的變更與範圍，完成偏好預檢，然後遵循五步驟流程，重複使用仍然有效的設計決策。除非使用者變更，否則保留請求的格式。 |
| 僅新增匯出格式 | 在步驟 3 使用現有未變更圖表進入。跳過草稿、樣式、測量與版面變更，然後檢查並定稿請求的檔案。 |
| 繼續未完成的任務 | 讀取任務記錄並選擇已儲存的修訂版本繼續。從未完成的步驟或受變更影響的步驟繼續。 |
| 僅驗證或診斷 | 使用 validate 進行結構檢查。若請求視覺診斷，請遵循步驟 4 中適用的檢查工作流程。報告已執行的檢查、其限制與發現的問題，然後停止。 |
對於獨立的儲存、變更或重設請求，請遵循專案偏好並報告操作，而不建立圖表。
對於從現有圖表進行匯入、修訂或匯出，請閱讀輸入與父項選擇。在建立任務檔案之前，請閱讀任務工作區需求；對於驗證命令與報告狀態，請閱讀執行時期與結果合約。
當輸入、授權的變更與流程入口點明確時再繼續。
流程
0. 初始化設計偏好
對於新的與修訂的草稿，請在步驟 1 之前遵循專案偏好。透過解決相關視覺選擇並記錄其來源來完成其預檢；完成任何請求的儲存或披露其失敗。獨立的偏好管理請求使用該參考並在報告操作後停止。純粹的匯出、驗證與診斷任務保留其現有入口點。使用記錄的決策繼續未完成的任務，僅在相關選擇變更時重新審視預檢。
1. 定義解釋目標
從讀者的問題開始：讀者在檢視圖表後應理解什麼？使用這個問題來引導後續的內容、版面與動畫決策。
-
定義問題。 從使用者的請求中識別主題以及讀者應理解的內容。
-
建立事實。 在授權範圍內讀取使用者指定的來源或現有圖表。識別相關物件、關係、流程與狀態變更。區分已知事實與需要釐清的資訊，並透過來源元資料記錄來源。
對於廣泛的調查，例如探索程式碼儲存庫，產出一個子代理來調查與讀者問題相關的部分。提供子代理問題與授權的來源範圍。要求相關的物件、關係、流程與狀態變更，包含來源位置與未解決的問題。使用這些發現來建立解釋所需的事實。
對於幾篇文章、少量參考資料或簡短請求（例如「使用流程圖解釋 RAG 工作流程」），在當前會話中建立事實。
-
記錄需求。 捕捉使用者已指定的目標受眾、使用情境與交付需求。遵循缺失的交付情境以重複使用已知的選擇，一次性收集相關的缺口，並在選擇幾何之前記錄採用的假設。
當你能用一句話陳述讀者的問題並識別支援答案的事實時再繼續。在起草之前，釐清會改變圖表含義的資訊缺口。如果 SDK 無法忠實表達請求，請解釋限制並等待使用者的選擇。
2. 設計視覺解釋
選擇如何呈現主題，以便讀者能回答步驟 1 中定義的問題。
對於新的或修訂的草稿，請在選擇畫布與密度之前閱讀交付情境，包括當目的未知時。對於能力清單、責任、資源狀態、請求和回應、狀態轉換、資料處理或架構，請使用讀者問題選擇表。
- 選擇內容。 選擇解釋所需的物件、關係、流程與狀態。在省略或聚合內容或決定如何呈現未知來源資訊之前，請閱讀來源忠實度與資訊選擇。在這些選擇中保留來源的含義。
- 將內容分配到其表面上。 在圖表幾何之前，遵循內容放置來指派頁面介紹、圖表邊界標籤、標題與輔助文字。記錄分配以及每個請求格式所需的上下文。
- 組織結構。 定義群組、層次結構與閱讀順序，以便讀者能識別要點並遵循其關係。
- 設定視覺方向。 遵循視覺設計為使用情境選擇方向。對於具有側邊欄的分層結構、具有分支或返回的流程，或具有較長內容的重複卡片，請選擇適用的佈局配方。記錄生產所需的具體選擇。
- 選擇靜態圖表或動畫。 使用靜態佈局來解釋結構與關係。對於動畫，區分持續關係流、注意力與階段性變更；流動線條的請求可以讓整個圖表保持可見。
- 規劃動畫敘事。 使用動畫時，遵循動畫節奏與視覺連續性來定義每個階段的解釋目標、狀態變更、過渡與閱讀暫停。
當計劃記錄了選定的內容、其承載表面、群組、閱讀順序、視覺選擇以及靜態或動畫呈現時再繼續。對於動畫，請包含階段計劃。
3. 建立圖表
實現步驟 2 的設計並產生步驟 4 檢查所需的工件。
使用 Node 20+ 與 npm。從使用者選擇的工作目錄執行 node <skill-directory>/scripts/flowsvg.mjs，必要時使用引號路徑。在此已安裝的技能中解析工具與任務資源。CLI 會準備其自己的固定 SDK 執行時期，而不會更改應用程式依賴項。
- 閱讀相關的創作指南。 對於新的或修訂的草稿，請閱讀文件模型與佈局指南，並實現選定的設計配方。在安排幾何之前，檢查渲染陷阱中關於短路徑搭配長標籤、側邊欄、無邊框文字、狹窄卡片或任何語言的換行風險、短標籤光學對齊、共享閱讀邊緣或變更的內容大小。對於動畫，也請閱讀場景、繼承狀態與時序。對於請求的 SVG、PNG 或 GIF 檔案，請閱讀匯出選項與限制。
- 建立圖表文件。 對於新的或修訂的草稿，實現規劃的物件、群組、連接、文字與動畫階段。保留來源語言與選定的視覺方向。對於沒有指定方向的新圖表，從淺色主題與圓角群組開始。在完整的草稿上測量文字，並在重複幾何需要計劃時遵循佈局計劃工作流程。比對每個物件、關係方向、父項邊界與狀態變更與來源。在新建的工作區草稿中儲存授權的變更；對於未變更的匯入或匯出，直接使用選定的輸入位元組。
- 驗證與修正。 在迭代期間使用唯讀
validate並讀取每個診斷。它會回傳確切的輸入身分與有限檢查，而不會建立圖表修訂版本；保留工作中的草稿。在當前授權範圍內應用修正，遵循診斷與修訂決策。釐清會改變解釋含義的修正並與使用者確認。 - 撰寫 HTML 頁面。 對於新的或修訂的 HTML 解釋，為分配在圖表之外的內容編寫頁面 HTML/CSS，並透過可編輯的 HTML 頁面提交。對於現有結果，遵循頁面延續以保留其設計並明確同步預期的圖表變更。需要在有用時重複使用已安裝的入門模板來建立新頁面；保留受管理的播放器區域，並將整個頁面保留在任務工作區中。
- 產生檢查工件。 在瀏覽器捕捉或選擇預覽範例數量之前，閱讀瀏覽器準備與取樣。使用
author來產生所需的離線 HTML、需要的預覽以及請求的匯出檔案。僅在需要中間 HTML 時使用author --browser none。對於幾個命名的靜態狀態，請遵循命名批次匯出；在綁定清單之前，與使用者確認從實際編譯節拍中選擇的時間。遵循執行時期與結果合約以進行設定、SDK 相容性與報告欄位；使用 CLI--help取得命令選項。
當草稿實現了計劃、或者保留了未變更的輸入、阻塞錯誤已解決、剩餘的診斷已記錄處理決策，並且所有檢查所需的檔案都已完成時再繼續。匯出失敗時，請遵循下面的恢復規則，並分別報告已完成與未完成的檔案。
4. 檢查結果
對於交付的 SVG/PNG，請遵循按需工件證據：對明確儲存的主題執行 evidence，然後檢視並獨立審查其圖片。現有的有效條件被重複使用；新條件保持未檢視狀態直到被檢查。
檢視產生的圖表，並確認其準確且清晰地解釋了主題。
- 檢查語義準確性。 比對物件、關係方向、群組邊界與狀態變更與來源。確認省略與聚合保留了來源的含義。
- 檢查視覺可讀性。 在預期的顯示尺寸下檢視實際渲染的圖片。檢查文字、間距、遮擋與閱讀順序。追蹤每個相關連接從其來源經過彎曲與交叉到箭頭；檢查端口、標籤以及與不相關節點的間距。
- 評估視覺設計。 遵循視覺設計檢查來識別可見的缺陷，並為使用者的最終設計判斷記錄觀察結果。
- 檢查動畫解釋。 對於動畫，根據階段計劃檢查初始狀態、關鍵變更與最終狀態。遵循預覽檢查檢查取樣狀態。在評估節奏時使用實際播放；將僅取樣檢查報告為僅限於檢視的狀態。
- 檢查交付的檔案。 讓工具開啟實際儲存的離線 HTML，並檢查其初始暫停狀態、控制項、離線請求與相關的播放狀態。透過HTML 檢查工作流程檢視其捕捉的圖片。檢查按交付方式請求的匯出檔案；使用目標尺寸工件檢查檢查最終的 SVG/PNG 檔案。
在提交審查之前，閱讀完整的審查輸入合約與範本工作流程。使用明確的圖表主題產生一個未檢視的表單，並使用 review-template，對於單獨的正式證據，使用 --evidence-from，然後使用獨立的 review 來記錄 HTML、預覽與正式 SVG/PNG 的觀察結果，並僅記錄實際檢視的圖片的 ID、雜湊、觀察結果與問題。重複提交審查不需要另一個圖表版本。當瀏覽器或圖片檢視器不可用時，明確記錄未執行的檢查及其影響。
對於發現的問題，返回步驟 3 以應用授權的修正、重新產生工件，並再次檢查受影響的檔案與狀態。在記錄問題或釐清含義時，遵循診斷與修訂決策。
5. 定稿與交付
定稿圖表文件並根據步驟 1 中記錄的需求交付最終檔案。
- 完成工作區。 從工作區中移除不需要的草稿與中間檔案。保留用於實例恢復的已提交結構。使用最後的
save記錄最終狀態與其檔案（包括flowsvg.json與報告）。 - 交付請求的格式。 使用
author --formats產生請求的匯出檔案。遵循匯出選項與限制來設定特定格式的輸出控制。將每個請求的檔案儲存為顯式的寫入結果，並報告其建立狀態。對於失敗的匯出，報告失敗的格式並遵循下面定義的恢復規則。 - 報告任務摘要。 提供一個清晰的摘要，說明讀者的問題、已建立的解釋、交付的檔案以及任何未解決的問題或已知的限制。對於診斷任務，報告執行的檢查、其限制與發現的問題。
當所有請求的格式已成功交付，或已記錄未解決的失敗並報告給使用者時，任務完成。
恢復規則
當圖表或匯出步驟失敗時：
- 檢視錯誤訊息與診斷輸出。
- 確定失敗是否為暫時性資源問題（磁碟空間、記憶體、網路）或架構問題（無效的圖表、不受支援的功能、不合規的 SDK 使用）。
- 對於暫時性問題，在簡短延遲後重試。對於架構問題，記錄錯誤、調整圖表或輸入，然後重試。
- 如果重試後仍然失敗，請通知使用者確切的失敗模式、已成功完成哪些步驟/檔案，以及建議的解決方法。
參考資料
此技能依賴於 <skill-directory>/references/ 中的檔案；在執行步驟 2、3 與 4 中的相關動作之前，請閱讀適用的參考資料。參考資料會詳細說明格式化、驗證合約與設計方法。
如需更多資訊，請參閱：