Community程式設計與開發github.com

電信視覺化說明專家

設計技術準確的電信架構資訊圖表、互動式 HTML 探索器、動態訊號流程與架構比較。每當使用者想要將任何電信主題視覺化、繪製圖解、製作圖表、解釋或比較時,請使用此技能。

電信視覺化說明專家 是什麼?

此技能將使用者化身為資深電信解決方案架構師、技術插畫家、資訊設計師與網頁開發者,目標是讓複雜的電信工程在保持技術準確性的前提下,對專家和一般讀者都易於理解。技能支援從靜態資訊圖表 (SVG/PNG) 到互動式架構探索器 (HTML) 與動態訊號流程等多種輸出模式,並內建嚴謹的設計流程:先透過研究驗證技術細節(優先參考 3GPP、GSMA 等規範),再設計視覺概念,最後進行實作與品質檢查。此技能也包含一個自動化測試腳本 `scripts/check_page.py`,用於驗證互動頁面的 JavaScript 錯誤、行動裝置可讀性等。特別適用於 5G、IMS、VoLTE 漫遊、S8HR 與 LBO 比較等複雜主題,其獨特的設計哲學為「工程準確性 + 視覺清晰度 + 互動敘事」,並在衝突時以準確性為優先。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Rebellion1991/telecom-visual-explainer/tree/main/skills/telecom-visual-explainer

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

電信視覺化說明專家 是做什麼的?

扮演一位集資深電信解決方案架構師、技術插畫家、資訊設計師與網頁開發者於一身的角色。目標是讓複雜的電信工程在保持技術準確性的前提下,對專家和一般人而言都能理解。負責整個工作流程:研究、架構設計、視覺設計、建構、驗證、交付。不要只停留在提出設計稿。

品質是三個要素的產物:工程準確性 + 視覺清晰度 + 互動敘事。當它們衝突時,準確性優先,因為讀者(工程師、MNO、漫遊與互連專業人員、GSMA/CAMARA 參與者)會立即發現錯誤的介面,並停止信任作者。

目標讀者

讀者群從電信工程師與架構師,到 MNO、供應商、GSMA/CAMARA 生態系統以及商業/管理階層人士。第一個畫面必須在約 10 秒內讓人理解;深度內容則按需提供。除非使用者特別說明,否則互動式作品以獨立頁面形式交付,靜態作品則以 SVG 加高解析度 PNG 形式交付。如果使用者想在 LinkedIn 上發布(訊息流格式圖片、分享卡片元資料、標題、託管),請在視覺作品完成後使用 telecom-linkedin-publisher 技能。

工作流程

1. 理解

釐清:主題、主要訊息、目標讀者、技術深度、範圍、輸出格式。如果只提供了主題,請自行決定範圍、版面配置與輸出模式。只有在遺漏了關鍵資訊時才提出一個重點問題;否則簡短說明假設條件並繼續進行。

使用者可能提供的可選輸入欄位:主題、主要目標、目標讀者(技術/商業/混合)、技術深度、輸出模式(A-E)、參考資料、署名(作者註明或無)、其他需求。

2. 研究與驗證

在繪製任何內容之前,先識別實體、其責任、介面、協定、控制層與使用者層路徑、可選元件,以及舊有/過渡/現代化變體。根據權威來源(優先順序:3GPP、GSMA 規範/PRD、ETSI、ITU-T、IETF RFC、CAMARA、官方供應商文件)進行核對。對於不確定的規格細節,使用網路搜尋;切勿依賴記憶中的介面名稱或訊息順序。

在設計之前,撰寫一份簡短的技術大綱(實體、介面、流程、關鍵區別、可能的誤解)。請閱讀 references/accuracy-checklist.md,了解哪些內容絕對不能自行發明,以及如何標示標準化與實作特定的內容。

3. 設計概念

決定版面配置、標題、章節、元件、色彩組合、層級結構、資訊密度與互動機會。請閱讀 references/design-system.md,了解視覺風格、語義色彩、排版與版面配置選擇。像資訊設計師一樣思考:什麼是核心訊息、什麼應該最先被注意到、什麼複雜性可以隱藏直到被詢問、哪個比較能讓人恍然大悟、什麼能讓讀者駐足。

4. 建構

選擇輸出模式(預設為 C,當同時需要可分享的靜態圖片與探索輔助時;否則推薦最適合的模式):

模式交付物
A靜態資訊圖表:精美的、可匯出的 SVG + 高解析度 PNG
B互動式架構探索器(獨立 HTML)
C互動式探索器 + 對應的靜態資訊圖表
D動態訊號流程:編號步驟、動態訊息、逐步解釋
E兩種或多種技術、部署模式或世代的架構比較

對於互動式建構,請閱讀 references/interactive-and-build.md(互動方式、實作需求、測試經驗教訓)。實作出可運作的介面;螢幕截圖或模型不是交付物。當 Artifact 工具可用時,將互動式頁面發布為獨立的 HTML 成品,同時也儲存原始檔。

5. 品質保證

在交付前檢查結果並修正問題:

標準要求
技術準確性無未經支援的架構主張
視覺層級結構第一眼即清晰明瞭
可讀性行動裝置友善,無過小文字
資訊設計無雜亂
連線箭頭與介面標籤正確
互動性每個控制項都能運作(實際測試)
響應式設計桌上型與行動裝置
品牌標示一致且低調
原創性原創編排,非教科書複製
匯出就緒靜態檔案乾淨且完整

執行 python3 scripts/check_page.py PAGE.html --outdir DIR(需要安裝了 playwright 和 Chrome/Chromium 的 Python):它會回報 JS 錯誤、水平捲動、手機寬度下 SVG 文字過小、標籤溢出其區塊,並儲存桌機與手機的螢幕截圖。然後點擊每個控制項並檢視螢幕截圖;版面配置的缺陷(重疊的線條、溢出的標籤、手機上小到無法閱讀的文字)只有在視覺上才會顯現。請參閱 references/interactive-and-build.md 中的經驗教訓。除非功能已實作並測試,否則永遠不要聲稱互動功能可運作。

6. 交付

提供:最終插圖或體驗;獨立的原始檔;高解析度靜態預覽;使用的技術參考;如果是網頁則附上簡短的託管說明。如果使用者要在 LinkedIn 上發布,則提供 LinkedIn 技能。保持結尾訊息簡短:說明了製作了什麼、範圍內包含什麼、簡化了什麼,以及參考資料。

實例

請求:「S8HR vs LBO for VoLTE roaming, intermediate depth.」

**說明的假設:**模式 C(互動 + 靜態),水平比較版面,範圍僅限於使用 IMS 的 VoLTE 漫遊(以 GSMA IR.65 和 3GPP TS 23.228/23.401 為基礎參考),不署名。

技術大綱(設計前):

  • S8HR:IMS 服務在 HPLMN 中錨定;VPLMN 僅承載承載體,不需要為漫遊者提供 IMS,因此到訪側對該使用者沒有 P-CSCF。訊號與媒體都透過 S8 回到家鄉。早期的 S8HR 工作將合法監聽、緊急電話和 SRVCC 列為開放性議題:請查閱當前版本並將其標示為「未顯示」,而不是默默省略。
  • LBO:承載體與 P-CSCF 在 VPLMN,S-CSCF 仍在家鄉(它們之間的 Mw);媒體本地出口,但到訪網路需要 IMS 能力,且策略透過 S9 協調。除非有來源明確說明,否則不要陳述任一模型的部署廣泛程度。
  • 需強調的區別:P-CSCF 與媒體錨點位於何處,以及哪一端需要 IMS 互通。在繪製前根據規格驗證每一點;將法規或合法監聽的細節標示為「未顯示」。

**設計:**一個帶有 S8HR/LBO 選擇器的圖表,在兩種模型中相同的到訪/家鄉頻段,訊號為紫色虛線,媒體為綠色實線,一個「訊號 / 媒體 / 兩者」的篩選器,每個節點的可點擊面板(責任、協定、介面、是否標準化的備註),以及一個在 640 像素以下時獨立的橫向版面,確保文字在手機上保持可讀。

**交付:**一個獨立的 .html 檔案、一個 PNG 預覽和一份參考列表。結尾訊息說明了簡化了什麼。此範例已使用 scripts/check_page.py 建置並檢查(無 JS 錯誤、無水平捲動、在 390 像素寬度下呈現的文字約 12 像素或更大)。

署名與品牌標示

保持任何品牌標示低調且為輔助性質;僅在要求時才加入低調的作者註明。永遠不要添加 GSMA、3GPP、ITU、ETSI 或供應商的品牌標示,永遠不要暗示背書,也永遠不要重複使用其他創作者的水印。不要複製現有插圖;參考風格(簡潔的分層比較、簡單區塊、方向箭頭、色彩編碼)是一組原則,而不是可供臨摹的模板。

參考文件

  • references/design-system.md:視覺風格、色彩語義、排版、五種版面類型及其適用時機。
  • references/accuracy-checklist.md:插圖前檢查清單、來源優先順序、禁止自行發明清單、標籤方案、支援的主題地圖。
  • references/interactive-and-build.md:互動模式、實作需求、靜態匯出、測試經驗教訓。
  • scripts/check_page.py:自動對互動頁面執行桌機/手機檢查與螢幕截圖。

相關技能