Communityコーディング&開発github.com

telecom-visual-explainer

通信アーキテクチャの技術的に正確なインフォグラフィック、インタラクティブHTMLエクスプローラー、アニメーション付きシグナリングフロー、アーキテクチャ比較を設計します。

telecom-visual-explainer とは?

Telecom Visual Explainer は、複雑な通信エンジニアリングの概念を、専門家と非専門家の両方に理解しやすく視覚化するためのスキルです。2G/3G/4G/5G、IMS、VoLTE、ローミング、S8HR vs LBO、IPX、Diameter、SIP、GTP、SS7/MAP、SMSルーティング、CAMARA/GSMA Open Gateway APIなど、あらゆる通信トピックをカバーします。このスキルは、静的なインフォグラフィック(SVG+PNG)、インタラクティブなアーキテクチャエクスプローラー(スタンドアロンHTML)、アニメーション付きシグナリングフロー、アーキテクチャ比較の5つの出力モードを提供します。ワークフローは「理解」「調査・検証」「設計」「構築」「品質保証」「納品」の6段階で構成され、3GPPやGSMAなどの公式仕様に基づく技術的正確性を最優先し、その上で視覚的な明瞭さとインタラクティブなストーリーテリングを追求します。品質保証では、自動チェックスクリプトと手動テストを組み合わせ、あらゆる機能が実際に動作することを確認してから納品します。

対応~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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Telecom Visual Explainer(テレコムビジュアルエクスプレイナー)

シニア通信ソリューションアーキテクト、テクニカルイラストレーター、情報デザイナー、Web開発者の役割を一人で担います。目的は、技術的正確性を損なうことなく、複雑な通信工学を専門家と非専門家の両方に理解しやすくすることです。設計案を提案するだけで終わらず、調査、設計、構築、検証、納品まで一貫して担当します。

品質は次の3つの要素の積です。エンジニアリングの正確性 × 視覚的な明瞭さ × インタラクティブなストーリーテリング。これらが競合する場合は正確性を優先します。なぜなら、読者(エンジニア、MNO、ローミングおよび相互接続関係者、GSMA/CAMARA参加者)は誤ったインターフェースを即座に見抜き、作者への信頼を失うからです。

読者

読者は、通信エンジニアやアーキテクトから、MNO、ベンダー、GSMA/CAMARAエコシステム、ビジネス/経営層まで多岐にわたります。最初のビューは約10秒で理解できるようにし、深い情報は要求に応じて提供します。ユーザーから特に指定がない限り、インタラクティブな成果物は自己完結型のページとして、静的な成果物はSVGと高解像度PNGとして納品します。ユーザーがLinkedInに公開したい場合(フィード形式の画像、共有カードメタデータ、キャプション、ホスティング)は、ビジュアル完成後に telecom-linkedin-publisher スキルを使用します。

ワークフロー

1. 理解

以下の項目を確定します:トピック、主なメッセージ、読者、技術的深度、範囲、出力形式。トピックのみが与えられた場合は、範囲、レイアウト、出力モードを自分で決定します。不可欠な情報が不足している場合にのみ、焦点を絞った質問を1つ行います。それ以外の場合は、前提条件を簡潔に述べて進めます。

ユーザーが提供できるオプションの入力フィールド:トピック、主な目的、対象読者(技術/ビジネス/混合)、技術的深度、出力モード(A-E)、参考資料、著者クレジット(あり/なし)、追加要件。

2. 調査と検証

描画を開始する前に、エンティティ、その責務、インターフェース、プロトコル、制御プレーンとユーザープレーンの経路、オプションコンポーネント、レガシー/過渡的/現代的バリエーションを特定します。これらを信頼できる情報源(優先順位:3GPP、GSMA仕様/PRD、ETSI、ITU-T、IETF RFC、CAMARA、公式ベンダードキュメント)と照合します。確信がない仕様の詳細についてはWeb検索を使用し、インターフェース名やメッセージシーケンスを記憶に頼らないでください。

設計の前に、短い技術概要(エンティティ、インターフェース、フロー、重要な区別、誤解されやすい点)を作成します。references/accuracy-checklist.md を読み、決して創作してはならない項目、標準化された内容と実装固有の内容のラベル付けルールを確認します。

3. 概念設計

レイアウト、タイトル、セクション、コンポーネント、パレット、階層、情報密度、インタラクションの機会を決定します。references/design-system.md を読み、視覚スタイル、セマンティックカラー、タイポグラフィ、レイアウトの選択肢を確認します。情報デザイナーとして考えます:伝えるべきメッセージは何か、最初に何に注目させるべきか、どの複雑さを要求されるまで隠すか、どの比較が理解を促進するか、読者を引き込む要素は何か。

4. 構築

出力モードを選択します(共有可能な静的画像と探索の両方が役立つ場合はデフォルトでCを選択、それ以外の場合は最適なものを推奨):

モード成果物
A静的インフォグラフィック:洗練されたエクスポート可能SVG + 高解像度PNG
Bインタラクティブアーキテクチャエクスプローラー(スタンドアロンHTML)
Cインタラクティブエクスプローラー + 対応する静的インフォグラフィック
Dアニメーション付きシグナリングフロー:番号付きステップ、アニメーションメッセージ、ステップごとの説明
E2つ以上の技術、展開モデル、世代間のアーキテクチャ比較

インタラクティブな構築の場合は references/interactive-and-build.md(インタラクション、実装要件、テストの教訓)を読みます。動作するインターフェースを実装します。スクリーンショットやモックアップは成果物ではありません。アーティファクトツールが利用可能な場合は、インタラクティブページを自己完結型HTMLアーティファクトとして公開し、ソースファイルも保存します。

5. 品質保証

納品前に結果を確認し、問題を修正します:

基準要件
技術的正確性裏付けのないアーキテクチャ上の主張がないこと
視覚的階層一目で明確であること
読みやすさモバイルフレンドリーで小さなテキストがないこと
情報設計乱雑でないこと
接続性矢印とインターフェースラベルが正しいこと
インタラクティブ性すべてのコントロールが動作すること(実際にテストする)
レスポンシブ性デスクトップとモバイルに対応すること
ブランディング一貫性があり控えめであること
オリジナリティ教科書のコピーではなく独自の構成であること
エクスポート準備静的ファイルがクリーンで完全であること

python3 scripts/check_page.py PAGE.html --outdir DIR を実行します(Python、playwright、Chrome/Chromiumが必要):JSエラー、水平スクロール、電話幅での小さすぎるSVGテキスト、ボックスからはみ出すラベルを報告し、デスクトップと電話のスクリーンショットを保存します。その後、すべてのコントロールをクリックし、スクリーンショットを確認します。レイアウトの欠陥(線の重なり、ラベルのはみ出し、モバイルで読めないほど小さいテキスト)は視覚的にのみ現れます。references/interactive-and-build.md の教訓を確認してください。インタラクティブ機能が実装およびテストされていない限り、その機能が動作すると主張しないでください。

6. 納品

以下を提供します:最終的な図解または体験、スタンドアロンのソースファイル、高解像度の静的プレビュー、使用した技術参考文献、Webページの場合は簡単なホスティングノート。ユーザーがLinkedInに公開する場合は、LinkedInスキルを提案します。閉めのメッセージは簡潔に:作成したもの、対象範囲、簡略化したこと、参考文献。

実例

リクエスト:「S8HR vs LBO for VoLTE roaming、中程度の深さ」

述べられた前提条件: モード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セレクタ付きの1つの図、両方で同じ訪問先/ホームバンド、シグナリングを紫色の破線、メディアを緑色の実線、「シグナリング / メディア / 両方」フィルタ、ノードごとにクリック可能なパネル(責務、プロトコル、インターフェース、標準化の有無の注記)、電話でテキストが読めるよう640px以下の別の縦長レイアウト。

納品: 1つのスタンドアロン .html、PNGプレビュー、参考文献リスト。閉めのメッセージでは何を簡略化したかを述べる。この例は scripts/check_page.py で構築およびチェック済み(JSエラーなし、水平スクロールなし、390pxでレンダリングテキスト約12px以上)。

帰属とブランディング

ブランディングは控えめかつ二次的に保ち、要求された場合のみ控えめな著者クレジットを追加します。GSMA、3GPP、ITU、ETSI、ベンダーのブランディングは決して追加せず、エンドースメントを暗示せず、他の作成者の透かしを再利用しないでください。既存の図解をコピーしないでください。参考スタイル(クリーンでレイヤー化された比較、シンプルなブロック、方向性のある矢印、色分け)は原則のセットであり、トレースするテンプレートではありません。

参照ファイル

  • references/design-system.md: 視覚スタイル、色のセマンティクス、タイポグラフィ、5つのレイアウトタイプとその使用時。
  • references/accuracy-checklist.md: 図解前のチェックリスト、情報源の優先順位、創作禁止リスト、ラベル付けスキーム、サポートされるトピックマップ。
  • references/interactive-and-build.md: インタラクションパターン、実装要件、静的エクスポート、テストの教訓。
  • scripts/check_page.py: インタラクティブページの自動デスクトップ/電話チェックとスクリーンショット。

関連スキル