mcpField
I
infrahub-common

infrahub-common

github.com/opsmill云与 DevOps27164 次安装1 天前更新
代码仓库

关于 infrahub-common

infrahub-common 是供其他 Infrahub 技能引用的共享参考资料集，不面向直接调用。它汇集查询语法、配置格式、Marketplace、迁移说明及跨技能操作规则。

主要功能

  1. 01Infrahub GraphQL 查询参考
  2. 02.infrahub.yml 配置字段说明
  3. 03Marketplace 发现与复用指南
  4. 04NetBox 迁移对照参考
  5. 05数据元信息与模板说明
  6. 06共享操作规则与排错指引

适用场景

  1. 01为其他 Infrahub 技能查阅共同规则
  2. 02构建和验证 GraphQL 查询
  3. 03复用 Marketplace 中的模式与集合
  4. 04迁移 NetBox 查询或模板

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/opsmill/infrahub-skills --skill infrahub-common

安装后在 Claude Code 中输入/infrahub-common确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

graphql-queries.md
infrahub-yml-reference.md
marketplace-reference.md
metadata-lineage.md
netbox-vs-infrahub.md
profiles-and-templates.md
rules/
_sections.md
_template.md
caching-display-label.md
connectivity-python-environment.md
connectivity-server-check.md
deployment-git-integration.md
deployment-gql-dry-run.md
deployment-partial-sync-recovery.md
protocols-adopt-typed-kinds.md
protocols-generated.md
testing-resource-framework.md
workflow-branch-for-crud.md
workflow-information-priority.md

详细介绍

Infrahub 通用参考

此技能包含所有其他 Infrahub 技能引用的共享资源。此技能不用于直接调用。

内容

  • graphql-queries.md — Infrahub GraphQL 查询语法、 过滤器、嵌套查询和分页模式
  • infrahub-yml-reference.md — .infrahub.yml 配置文件格式和字段参考
  • marketplace-reference.md — Infrahub Marketplace： 通过 infrahubctl marketplace get 复用已发布的架构和集合， 使用 infrahubctl marketplace list / search / show 进行发现， 以及断网环境下的备用方案。优先复用，再从头建模。
  • netbox-vs-infrahub.md — 面向工程师的逐字段迁移附录， 适用于移植 NetBox 查询、模板或覆盖数据
  • metadata-lineage.md — 值元数据（source、 owner、is_protected）：各字段的含义、如何在对象文件中 设置这些字段，以及为何 source 不控制编辑权限
  • profiles-and-templates.md — Profiles 与 Object Templates 的区别和机制
  • rules/ — 各技能共用的跨领域规则：
    • 数据增删改查优先使用分支（默认使用分支，而非默认分支）
    • 在查询中缓存显示标签
    • Python 环境和连接性检查
    • Git 集成和部署模式
    • 合并前，对照实时架构试运行已更改的 .gql 查询， 并了解 infrahubctl 中用于转换、检查或生成器的命令
    • 从不完整的仓库同步中恢复
    • 生成文件协议约定
    • schema.graphql 是 infrahubctl graphql export-schema 的输出——应重新导出，绝不手动编辑
    • 采用生成的协议进行类型化 SDK 调用
    • 信息来源优先级（优先使用技能内容； 只有在确实存在信息缺口时，才按具体的最后手段流程查阅 docs.infrahub.app）

评论

支持 Markdown