network

network 技能概覽

network 技能能做什麼

network 技能可協助你用 PlantUML 搭配裝置專屬的 mxGraph 圖示繪製網路拓樸圖，讓你不用靠猜語法，就能描述 LAN、WAN、企業網路、資料中心，以及帶有廠商風格的圖表。當你需要一個用於基礎架構圖的 network skill，而且希望圖面看起來像實際營運環境，而不是抽象示意時，它就是很合適的選擇。

誰適合使用

如果你正在記錄路由器、交換器、防火牆、伺服器、無線存取、DMZ、分點據點，或混合式連線，而且希望圖表能清楚傳達真實拓樸，就適合使用這個技能。它特別適合用來比較設計方案、審查變更，或為架構文件產出圖表的團隊。

它和其他工具有什麼不同

network 的核心價值在於圖示還原度高，並且採用符合拓樸習慣的表達方式：mxGraph stencil 名稱、區域分組、連線類型與自動排版指引。這讓輸出比一般提示詞更精準，也能避免常見失誤，例如圖面雜亂、圖示家族選錯，或畫成偏軟體 UML 的樣式。

如何使用 network 技能

安裝並先查看正確檔案

先用 npx skills add markdown-viewer/skills --skill network 安裝。接著先讀 SKILL.md，再看 examples/ 裡的範例檔，例如 lan-topology.md、enterprise-network.md、datacenter-network.md 和 hybrid-cloud.md。這些範例比起把整個 repo 翻一遍，更快看出實際的 network usage 模式。

把粗略想法轉成可用提示詞

好的輸入會明確寫出拓樸、區域、裝置與連線類型。例如：「建立一個分公司網路，包含 Internet、防火牆、核心交換器、兩台接入交換器、12 台工作站、Wi‑Fi AP，以及連到總部的 site-to-site VPN。使用 Cisco icons，並把 DMZ 獨立呈現。」這比「幫我畫網路」更有效，因為這個技能需要範圍與結構，才能選對 stencil family。

遵守重要的圖面規則

network guide 預期輸出的是包含 @startuml 和 @enduml 的 PlantUML，並且要用正確的 fence：使用 plantuml 或 puml，不要用純文字。實體連線用 --，無線或備援路徑用 ..，區域則用 rectangle 或 package 分組。如果需要雲端或 Internet 形狀，請直接明確建模，不要讓它們默默隱含。

依照你的工作情境閱讀範例

如果你不確定哪一組 stencil 最適合，先看 examples/lan-topology.md 了解一般網路，接著看 examples/cisco-network.md 了解 Cisco 比例較高的環境，再看 examples/enterprise-network.md 了解分層式企業佈局，最後看 examples/security-architecture.md 了解縱深防禦模式。這條路徑通常比單純瀏覽 repo，更能幫你為 network 技能寫出更好的第一版提示詞。

network 技能 FAQ

network 技能只能畫 Cisco 圖嗎？

不是。雖然它對 Cisco 支援良好，但 network 技能也適用於通用的 LAN/WAN 佈局、Citrix、資料中心、無線，以及偏資安導向的網路圖。請選擇最貼近你環境的 stencil family，不要硬把所有東西都塞進單一廠商風格。

什麼情況下不該用 network？

如果是一般軟體架構、類別圖，或雲端服務圖，而且重點多半是邏輯關係而不是裝置拓樸，就不適合使用它。若你的目標是應用程式流程，請改用偏 UML 的技能；若你的目標是雲端服務架構，則應使用偏雲端的技能。

這比直接用 PlantUML 提示詞更好嗎？

通常是的，因為這個技能會縮小 stencil 詞彙、連線語意與分組模式的範圍，而這些都是一次性提示詞最容易出錯的地方。簡單情境下，直接提示詞也許可行，但當你需要一致的裝置圖示，以及看起來像基礎架構圖的拓樸時，network skill 通常更可靠。

使用前我應該先準備什麼？

先準備好網路區域、裝置類型、站點數量、偏好的廠商風格，以及連線行為。如果你能具體說出像「DMZ」、「core」、「access」、「VPN」或「wireless」這些資訊，輸出通常會更準確，也更容易快速修正。

如何改進 network 技能

提供拓樸事實，不要只給主題

最好的 network install 結果來自具體的拓樸資訊：站點數、主要子網或區域、裝置角色，以及哪些連線是實體、哪些是邏輯。像「零售 WAN，包含 HQ、4 個分點、每個分點都有防火牆，並透過 VPN backhaul 回傳」會比「企業網路圖」產出更好的結果。

直接說明圖示家族與用途

如果你要 Cisco 19、Cisco SAFE、Citrix，或通用網路圖示，請一開始就說清楚。也要說明這張圖是給維運、文件，還是架構審查使用，因為這會影響 network 技能該保留多少細節、又該簡化多少。

注意兩個常見失敗模式

第一個問題是把太多終端塞進同一張圖；可以改成分層分組，或拆成多張子圖。第二個問題是連線語意不清楚；請直接說明哪些連線是 Ethernet、wireless、VPN、management，或 traffic flow，讓技能能正確選擇 --、.. 或 -->。

從第一版持續迭代

拿到第一版輸出後，可以再要求補上缺少的區域、讓標籤更清楚，或降低每個群組內的裝置類型數量。如果結果看起來太泛，可再加上限制，例如「DMZ 與 internal VLAN 要分開呈現」、「使用 vendor-specific icons」，或「強調 WAN failover paths」，通常 network 技能就能產出更有決策價值的修訂版。