mcpField
N
netbox

netbox

github.com/netboxlabsクラウド・DevOps2159 回インストール2 週間前に更新
リポジトリ

netbox について

netbox は NetBox タスクの入口となるスキルです。モデリング、連携、管理、検証、移行、レビューの専門スキルへ依頼を振り分け、複数スキルを使うタスクの組み合わせも案内します。

主な機能

  1. 01NetBox の専門スキルへの振り分け
  2. 02モデリング、API、プラグインへの対応
  3. 03運用とデータ移行の案内
  4. 04複数スキルを使うタスクの構成
  5. 05MCP 利用時のライブインスタンス検証の推奨

活用シーン

  1. 01ネットワークのモデリングとデータ投入に使うスキルの選定
  2. 02API、Webhook、オートメーションを使う連携の計画
  3. 03移行と検証またはアシュアランスの組み合わせ

MCP 対応

スキル一覧には、エージェント向けにコードモードと個別モードを備える Platform MCP サーバー netboxlabs-platform-mcp が含まれます。NetBox MCP サーバーが設定されている場合、ライブのスキーマやデータを照会し、結果を検証するよう推奨します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/netboxlabs/skills --skill netbox

インストール後、Claude Code で/netboxを入力して読み込まれたか確認します。

同梱ファイルreferences/netbox-version-matrix.mdreferences/product-catalog.md

詳細

NetBox Hub スキル

NetBox 関連のすべてのタスクのエントリーポイントです。以下の決定ツリーから適切な専門スキルを見つけ、詳細なガイダンスを確認するために読み込んでください。

決定ツリー

何を行おうとしていますか？

ネットワークをモデル化しますか？

  • サイト、デバイス、回線、IPAM を定義する → netbox-data-modeling
  • コードを書かずに新しいオブジェクトタイプを作成する → netbox-custom-objects
  • 再利用可能な YAML 設計からラック、サイト、ケーブル配線を構築する（レンダリング → 計画 → レビュー → 適用） → netbox-designs

インテグレーションを構築しますか？

NetBox を拡張しますか？

変更を安全に管理しますか？

  • 分離されたブランチで変更をステージングする → netbox-branching
  • 変更リクエストと承認を追跡する → netbox-changes

ネットワークを検証しますか？

ネットワークを検出または監査しますか？

  • Orb Agent でインフラストラクチャを自動検出する → netbox-discovery
  • 意図した状態と実際の状態の差異を検出する → netbox-assurance

機器を調達または予備品として確保しますか？

ハードウェアの仕様やライフサイクルデータを調べますか？

  • デバイスタイプのメタデータと拡充データ（EOL、熱特性、プロトコル）を利用する → netbox-ndx

運用または移行を行いますか？

  • NetBox サーバーを設定、保護、または調整する → netbox-administration
  • スプレッドシートまたはレガシーツールからデータを移行する → netbox-migration

既存の作業をレビューまたは監査しますか？

  • インテグレーションコードをレビューする（ページネーション、認証、パフォーマンス） → netbox-review-integration
  • データモデル設計を監査する（階層、IPAM、命名） → netbox-review-datamodel

スキル一覧

スキルカテゴリ説明
netbox-data-modelingコアネットワークをモデル化 — 階層、IPAM、テナント、カスタムフィールド
netbox-custom-objectsコアノーコードでデータモデルを拡張 — カスタムタイプ、フィールド、リレーションシップ
netbox-api-integrationコアREST と GraphQL の API パターン、pynetbox、認証
netbox-plugin-developmentコアプラグインの構築 — モデル、ビュー、API、マイグレーション、テスト
netbox-custom-scriptsコアカスタムスクリプトとレポート — Script クラス、ジョブ、ORM アクセス
netbox-config-templatesコア設定の生成 — Jinja2、コンテキスト変数、プラットフォームパターン
netbox-administrationコアサーバー管理 — 設定、認証、権限、パフォーマンス
netbox-branchingプラットフォームブランチのライフサイクル、スキーマの分離、CR ワークフロー
netbox-changesプラットフォーム変更管理、ポリシー、承認ワークフロー
netbox-diodeプラットフォームデータ取り込み — SDK、エンティティマッピング、照合機能
netbox-discoveryプラットフォームOrb Agent — 設定、バックエンド、ポリシー、シークレット
netbox-validationプラットフォーム検証ポリシー、コンプライアンスチェック、検出結果、変更前の安全性
netbox-assuranceプラットフォームドリフト検出 — 期待値と実際の状態の比較、修正
netbox-asset-lifecycleプラットフォーム調達ライフサイクル — BOM、PO、出荷、受け入れ、予備品
netbox-ndxプラットフォームData Exchange — デバイスタイプのカタログと拡充（ライフサイクル、熱特性、プロトコル）
netbox-designsプラットフォームInfrastructure as code — YAML 設計、構成、plan/apply、デプロイ
netboxlabs-platform-mcpプラットフォームプラットフォーム MCP サーバー — エージェント向けのコードモードと個別モード
netbox-automation-patterns横断Webhook、Ansible、Terraform、GitOps
netbox-migration横断スプレッドシート、CMDB、その他のツールからの移行
netbox-review-integrationレビュー統合コードの正確性とパフォーマンスを監査
netbox-review-datamodelレビューデータモデル設計をベストプラクティスに照らして監査

共通パターン

段階的な情報開示

各スキルは、次のような階層構造になっています。

  1. SKILL.md — 中核となる指示（500 行未満）。最初に読み込みます。
  2. references/ — 詳細が必要なときに、必要に応じて読み込むドキュメント。
  3. scripts/ — 実行可能なコード（該当する場合）。

必要なものだけを読み込みます。ハブから始め、専門スキルを選び、必要に応じてリファレンスを詳しく確認してください。

複数スキルを組み合わせるタスク

複数のスキルにまたがるタスクもあります。一般的な組み合わせは次のとおりです。

タスクスキル
ディスカバリー連携の構築netbox-diode + netbox-discovery
変更管理に対応したプラグインnetbox-plugin-development + netbox-branching
移行後の検証netbox-migration + netbox-assurance
構成生成の自動化netbox-config-templates + netbox-automation-patterns
データモデルの作成とデータ投入netbox-data-modeling + netbox-api-integration
連携全体のレビューnetbox-review-integration + netbox-review-datamodel
変更前の検証netbox-validation + netbox-branching + netbox-changes
計画済み機器の調達netbox-data-modeling + netbox-asset-lifecycle
インベントリ全体のEOLリスク把握netbox-ndx + netbox-api-integration
エージェント主導のNetBox自動化netboxlabs-platform-mcp + netbox-api-integration
設計に基づく安全なラック構築netbox-designs + netbox-branching
新規サイトのコード化netbox-data-modeling + netbox-designs + netbox-ndx

原則

NetBox関連のタスクに取り組む際は、次の点に従ってください。

  • 事前学習より情報の取得を優先してください。 NetBoxのAPI、設定、プラグインの動作はリリースごとに変わります。コードを生成したり、断定的な説明をしたりする前に、必ず最新のドキュメントまたは稼働中のインスタンスで確認してください。
  • 利用可能な場合はMCPを使用してください。 NetBox MCP サーバーが設定されている場合は、稼働中のインスタンスに問い合わせてオブジェクトスキーマを確認し、既存データを調べ、作業内容を検証してください。
  • 依存関係の順序を守ってください。 NetBoxのオブジェクトには親子関係があります。親を子より先に作成してください（またはDiodeを使用して順序を省略してください）。
  • バージョンを明示してください。 NetBoxのバージョンに依存するアドバイス（v2トークン、カーソルページネーション、カスタムオブジェクトなど）を提示する場合は、必要な最小バージョンを明確に示してください。
  • 巧妙さより正確さを優先してください。 明確なコードで動作する連携は、簡潔でも壊れやすい連携より優れています。

参考資料

コメント

Markdown 対応