mcpField
N
netbox

netbox

github.com/netboxlabs云与 DevOps2159 次安装2 周前更新
代码仓库

关于 netbox

netbox 是面向 NetBox 任务的入口技能，将请求分派给建模、集成、管理、验证、迁移和审查等专用技能，并说明多步骤任务的组合方式。

主要功能

  1. 01将任务路由到专用 NetBox 技能
  2. 02涵盖建模、API 和插件
  3. 03包含运维与数据迁移
  4. 04列出多技能任务组合
  5. 05MCP 可用时建议验证实时实例

适用场景

  1. 01选择网络建模和数据填充所需技能
  2. 02规划使用 API、Webhook 或自动化的集成
  3. 03将迁移与验证或保障检查结合

MCP 相关

技能目录包含 netboxlabs-platform-mcp，这是面向 Agent、提供代码模式和离散模式的 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 相关任务的入口。使用以下决策树找到合适的专用技能，然后加载该技能以获取详细指导。

决策树

你要做什么？

对网络进行建模？

构建集成？

扩展 NetBox？

安全地管理变更？

验证网络？

发现或审计网络？

采购设备或管理备件？

查询硬件规格或生命周期数据？

  • 使用设备类型元数据和增强信息（EOL、热学、协议） → netbox-ndx

运维或迁移？

审查或审计现有工作？

技能索引

技能类别描述
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平台数据交换 — 设备类型目录与增强信息（生命周期、热学、协议）
netbox-designs平台基础设施即代码 — YAML 设计、组合、计划/应用、部署
netboxlabs-platform-mcp平台平台 MCP 服务 — 面向 Agent 的代码模式和离散模式
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
由 Agent 驱动的 NetBox 自动化netboxlabs-platform-mcp + netbox-api-integration
根据设计安全地构建机架netbox-designs + netbox-branching
以代码方式构建全新站点netbox-data-modeling + netbox-designs + netbox-ndx

原则

处理任何 NetBox 任务时：

  • 优先检索，而非预训练。 NetBox API、配置和插件行为会随版本更新而变化。生成代码或作出断言前，务必查阅当前文档或实时实例进行验证。
  • 有 MCP 时使用 MCP。 如果已配置 NetBox MCP 服务，请查询实时实例以验证对象架构、检查现有数据并验证工作成果。
  • 遵守依赖顺序。 NetBox 对象具有父子关系。先创建父对象，再创建子对象（也可以使用 Diode 跳过顺序限制）。
  • 明确说明版本。 如果建议取决于 NetBox 版本（v2 令牌、游标分页、自定义对象），请清楚说明最低版本。
  • 正确性胜过巧妙。 清晰代码构建的可用集成，胜过简洁但脆弱的集成。

参考资料

评论

支持 Markdown