Agent Skills
› netdata/netdata
netdata/netdata
GitHub用于Netdata采集器的开发、修改与审查，涵盖Go/IBM/C/Rust等语言及外部插件。提供生命周期管理、指标规范、性能约束及多框架路由指导，确保数据采集的准确性、资源可控性与代码质量。
Install All Skills
npx skills add netdata/netdata --all -g -y
Skills in Collection (45)
用于Netdata采集器的开发、修改与审查，涵盖Go/IBM/C/Rust等语言及外部插件。提供生命周期管理、指标规范、性能约束及多框架路由指导，确保数据采集的准确性、资源可控性与代码质量。
创建新的Netdata采集器
修改现有采集器配置或逻辑
审查采集器代码与设计文档
解决采集数据缺失或指标异常问题
npx skills add netdata/netdata --skill collectors-authoring -g -y
用于设计和审查 Go.d 采集器与发现器的契约，涵盖能力范围、选项、指标含义、身份标识及持久化状态。适用于新采集器设计、配置变更评审及远程写入等复杂场景的规范制定。
设计新的 go.d 采集器或发现器
审查采集器契约或配置变更
定义指标含义或实体轴
处理远程写入或持久化状态逻辑
npx skills add netdata/netdata --skill collectors-go-design -g -y
指导 Go go.d 框架 V2 采集器的实现、迁移与审查，涵盖生命周期、指标存储、图表配置及主机范围。
实现新的 Go 采集器
V1 到 V2 的采集器迁移
审查采集器代码或设计
npx skills add netdata/netdata --skill collectors-go-framework-v2 -g -y
负责编写、审查和解释 Collector metadata.yaml 内容及集成页面文案，涵盖字段含义、默认值、权限、成本等，确保面向用户的文档可读性与准确性。
需要解释 metadata.yaml 字段含义
审查或编辑 collector 集成页面内容
检查元数据与文档的一致性
npx skills add netdata/netdata --skill collectors-metadata-yaml -g -y
用于创建、审查和验证 Netdata Prometheus 图表配置文件的技能，涵盖仪表板设计、采集策略及语义证明。
审查或验证 Prometheus profile 变更
创建或重新设计用户配置文件
构建 stock 配置文件或合成测试数据
捕获私有证据或进行实时验证
npx skills add netdata/netdata --skill collectors-prometheus-profiles -g -y
用于编写或审查 Netdata SNMP 轮询配置文件，涵盖解析、拓扑及文档。检查 MIB 可访问性、索引提取及行格式合规性，确保数据采集与拓扑定义的准确性。
编写 SNMP 采集配置文件
审查 SNMP 配置合规性
处理 SNMP MIB 索引与拓扑定义
npx skills add netdata/netdata --skill collectors-snmp-profiles -g -y
用于编写或审查 Netdata SNMP Trap 配置文件、指标规则及生成器，确保符合 MIB 和分类契约。
修改 SNMP Trap 配置文件或指标规则
审查 SNMP Trap 相关代码变更
更新 SNMP Trap 分类或严重程度
npx skills add netdata/netdata --skill collectors-snmp-trap-profiles -g -y
用于自动抓取 Coverity Scan 缺陷列表及详情，并协助用户进行缺陷分类（Bug/误报/故意）的自动化技能。支持 Cookie 认证与多模型协作流程。
review Coverity defects
triage Coverity findings
fetch Coverity outstanding
mention Coverity Scan, CIDs, or scan.coverity.com
npx skills add netdata/netdata --skill coverity-audit -g -y
在本地隔离环境中构建和预览 Netdata Learn 文档的 PR 或分支内容，用于合并前验证。
用户明确要求本地构建、运行、预览或检查 Learn 站点
需要验证未合并的 PR 或文档分支对站点的影响
npx skills add netdata/netdata --skill docs-learn-pr-preview -g -y
管理 Learn 站点结构，处理文档映射、页面 URL、重定向及 MDX 内容。涉及发布流程审查、本地构建验证及 CI/CD 管道行为排查，确保文档站点正确渲染与部署。
需要审查或修改文档发布配置
排查文档站点构建或渲染错误
添加、移动或重命名文档页面
检查或修复文档重定向规则
npx skills add netdata/netdata --skill docs-learn-site-structure -g -y
用于管理GitHub代码扫描警报，通过gh CLI列出CodeQL发现并执行误报、不修复或测试用途等分类操作。
review GitHub security alerts
check CodeQL findings
triage code scanning
npx skills add netdata/netdata --skill graphql-audit -g -y
用于编写、适配、修改或审查 Netdata 健康告警定义及模板。涵盖表达式调整、生命周期配置、测试编写及告警身份选择，确保生产环境告警策略的准确性与等价性。
需要创建或修改 Netdata 健康告警规则
将其他监控系统的告警翻译为 Netdata 格式
审查现有 Netdata 告警配置的逻辑与行为
调整告警的触发条件、严重性或路由策略
npx skills add netdata/netdata --skill health-alert-authoring -g -y
管理Netdata集成流水线，涵盖metadata验证、文档生成及发布流程。指导如何编辑源文件并隔离处理生成的产物，确保CI校验与交付一致性。
修改集成元数据或收集器配置
验证集成文档生成结果
审查集成流水线变更
npx skills add netdata/netdata --skill integrations-lifecycle -g -y
用于在本地隔离环境中构建、运行和预览 Netdata Learn 站点，以验证 PR 中的文档内容。通过创建独立目录和虚拟环境，确保不污染主仓库，支持检查链接、警告及生成页面效果。
用户明确要求在合并前预览或验证 PR 中的文档内容
用户请求在本地构建或检查 Learn 站点的特定 PR 变更
npx skills add netdata/netdata --skill learn-pr-preview -g -y
用于构建、测试、审查和故障排除 Netdata 静态 makeself 安装程序及打包变更，支持多架构交叉编译与部署。
构建静态二进制安装包
排查构建失败或缓存问题
审查打包配置变更
部署到目标主机
npx skills add netdata/netdata --skill packaging-static-installer -g -y
指导开发者创建或更新Netdata拓扑结构的生产者及Function负载，涵盖网络、流媒体、SNMP、vSphere等场景，确保遵循v1 schema规范与开发流程。
添加或迁移拓扑网络连接、流媒体、SNMP、vSphere拓扑
配置关联规则、图表展示或遥测叠加层
修改拓扑生产者代码或验证逻辑
npx skills add netdata/netdata --skill project-create-topology -g -y
用于编写、修改和审查 Netdata 健康告警配置。支持从其他系统迁移告警，调整表达式、生命周期及路由策略，确保生产环境监控准确性与语义等价性。
需要创建或更新 Netdata 健康告警规则
将其他监控系统的告警迁移至 Netdata
审查现有告警配置的逻辑正确性与冲突
npx skills add netdata/netdata --skill project-health-alert-authoring -g -y
用于创建、审查和验证 Netdata Prometheus 采集器图表配置文件。涵盖设计、数据建模、证明及安装流程，确保监控仪表盘具备语义准确性与操作实用性。
创建或重新设计 Prometheus profile
审查 profile 的 schema 或运行时行为
验证指标覆盖率和基数边界
安装或实时测试 profile
npx skills add netdata/netdata --skill project-prometheus-profiles -g -y
Netdata查询引擎的黑盒正确性测试套件，用于运行测试、添加用例、修复bug及验证修复分支。
运行查询引擎正确性测试
添加或扩展测试用例
修复查询引擎Bug并验证
npx skills add netdata/netdata --skill project-query-corpus -g -y
指导编辑 Netdata SNMP 配置文件、拓扑及文档，强调检查 MIB 字段可访问性并严格遵循索引提取与格式规范。
编辑 SNMP Profile YAML
修改 ddsnmp 解析逻辑
更新 SNMP 拓扑配置
npx skills add netdata/netdata --skill project-snmp-profiles-authoring -g -y
指导 Netdata SNMP Trap 配置文件、规则及生成工具的编辑与维护，确保符合分类体系、命名规范与数据完整性。
编辑 SNMP trap profile YAML 文件
修改 trap profile metric rules
运行 OOB trap profile pack 再生成
更新 snmp-trap-profile-gen Go 辅助工具
npx skills add netdata/netdata --skill project-snmp-trap-profiles-authoring -g -y
指导创建或迁移 Go go.d 采集器至 Framework V2，涵盖 CollectorV2、指标存储及图表模板等核心模式，强调代码规范与框架变更纪律。
创建新的 Go go.d 采集器
将现有采集器从 V1 迁移至 V2
修改采集器框架相关代码
npx skills add netdata/netdata --skill project-writing-go-modules-framework-v2 -g -y
管理 Netdata 本地源码镜像的同步、检查与更新，支持跨仓库搜索、代码审查及版本状态验证。
需要查看或比较本地源码状态
需要同步或刷新源码镜像
进行跨仓库的代码搜索或审查
npx skills add netdata/netdata --skill repo-mirror-sources -g -y
用于审查PR评论、执行PR审核分类及处理已授权发现的问题。涵盖GitHub评论、AI机器人反馈、SonarCloud结果和CI失败，支持聚焦检查或完整PR排查。
请求查看PR评论或审核意见
需要修复PR中发现的代码问题
要求对PR进行完整的审核分类
检查特定来源的PR相关问题
npx skills add netdata/netdata --skill repo-pr-reviews -g -y
用于创建、审查和重构 Netdata 技能文件，确保指令准确、触发器合理并消除冗余。
创建新的技能定义
审查现有技能的变更
重构或整理技能结构
修正技能中的错误或过时内容
npx skills add netdata/netdata --skill repo-skill-authoring -g -y
用于自动化审核 SonarCloud 代码质量与安全发现，支持标记误报、确认问题及批量处理规则家族。
review Sonar findings
triage SonarCloud
mark False Positive on Sonar
npx skills add netdata/netdata --skill sonarqube-audit -g -y
用于运行、扩展或审查 Netdata 查询合约语料库的测试套件，涵盖回归测试、修复分支验证及独立预言机管理。
运行查询引擎回归测试
修复分支验证
审查或添加测试用例与固定装置
npx skills add netdata/netdata --skill tests-query-corpus -g -y
Netdata拓扑结构开发技能，指导设计、变更和审查拓扑生产者及payload，涵盖模式定义、验证规则、迁移状态及UI参考，确保数据模型与前端展示的一致性。
修改Netdata拓扑结构定义或Schema
审查拓扑Payload合规性
调整拓扑关联与证据配置
npx skills add netdata/netdata --skill topology-authoring -g -y
用于调查 Netdata 代理崩溃、恐慌和致命错误。通过高效查询和分析 agent-events 数据，辅助开发者定位问题根源，而非通用日志查询。
调查 Netdata 代理崩溃或致命错误
分析 agent-events 捕获数据
审查事件调查脚本或工具变更
npx skills add netdata/netdata --skill triage-agent-events -g -y
用于分析、审查和排查 Codacy 代码质量检查结果及本地分析器问题。支持读取 PR 缺陷、运行本地静态分析、诊断 CLI/API 故障及验证辅助工具，涵盖 CI 失败处理与误报识别。
Codacy CI 构建失败排查
审查 Codacy 发现的质量问题
查询当前 PR 的代码缺陷
运行本地静态代码分析
诊断 Codacy CLI 或 API 异常
npx skills add netdata/netdata --skill triage-codacy -g -y
用于审查和分类GitHub Code Scanning告警，包括CodeQL发现。支持列出、检查、审核及在授权下执行验证性关闭操作，不涉及查询编写或CI配置。
审查安全扫描告警
批量关闭已验证的漏洞
npx skills add netdata/netdata --skill triage-codeql -g -y
用于审查和分类 Coverity Scan 缺陷，支持查看保存的 CID 包、获取实时发现及应用验证后的分类决策。
审查 Coverity 扫描缺陷
应用分类决策
npx skills add netdata/netdata --skill triage-coverity -g -y
用于离线分析SNMP诊断证据和支持包，定位采集、处理或功能缺陷，审查诊断工具变更及解释证据字段。
调查捕获的SNMP诊断数据
审查诊断工具或解释逻辑的代码变更
解释证据字段含义或局限性
npx skills add netdata/netdata --skill triage-snmp-diagnostics -g -y
用于审查或应用SonarCloud问题的分流决策，包括代码异味、漏洞和质量门证据。支持离线审查和基于凭证的在线操作，维护分流矩阵与审计记录。
需要审查SonarQube/SonarCloud发现的问题
需要对安全热点或代码异味进行分流决策
npx skills add netdata/netdata --skill triage-sonarqube -g -y
指导直接通过HTTP访问Netdata Agent API，涵盖指标、日志、拓扑等查询及Bearer认证配置。用于排查连接问题、审查查询脚本或执行诊断任务。
需要直接调用Netdata Agent接口获取监控数据
排查Agent Bearer Token认证失败问题
审查或调试针对Agent的API查询脚本
npx skills add netdata/netdata --skill query-netdata-agents -g -y
提供 Netdata Cloud REST API 的查询与解释能力，涵盖指标、日志、拓扑等13个领域。支持安全执行查询及配置审查，强调凭证管理与状态变更权限控制。
查询 Netdata Cloud 监控指标或日志
解释 API 请求或审查查询脚本
获取网络拓扑或告警信息
npx skills add netdata/netdata --skill query-netdata-cloud -g -y
指导查询、解释和审查 SNMP trap 日志及食谱，涵盖严重性分析、去重、解码错误及自定义 MIB 转换，确保执行安全。
查询 SNMP trap 日志
解释或审查 SNMP trap 记录
转换自定义 MIB
npx skills add netdata/netdata --skill query-snmp-traps -g -y
用于在推送前本地运行 Codacy 分析器以预防 CI 失败，并通过 API 获取和聚类 PR 问题。支持只读查询与 Token 安全封装，旨在加速静态代码审查流程。
用户提及 Codacy、codacy analysis 或 codacy-analysis-cli
用户要求修复 codacy CI 失败或处理 codacy markdownlint 发现
用户请求获取或聚类 PR 上的 codacy issues
npx skills add netdata/netdata --skill codacy-audit -g -y
提供Netdata学习站点的内容发布机制权威参考，涵盖map.yaml路由、ingest.py编排、侧边栏生成及CI流程。用于文档增删改查、页面异常排查及理解内容如何发布至learn.netdata.cloud。
添加、移动、重命名或删除文档页面
学习站点页面显示异常或URL错误
决定在哪个仓库编辑文档
查阅CI/CD流水线配置与部署逻辑
npx skills add netdata/netdata --skill learn-site-structure -g -y
维护Netdata-org代码库的本地镜像，支持AI助手和开发者进行跨仓库搜索与代码审查，避免GitHub API限制。通过脚本自动同步现有仓库并发现新仓库，确保本地数据最新且安全。
需要跨仓库代码搜索或审查
本地镜像过期需更新
添加新的Netdata组织仓库
npx skills add netdata/netdata --skill mirror-netdata-repos -g -y
迭代处理PR评论直至代码整洁。自动拉取人类/AI评审、SonarCloud及CI问题，逐一验证并修复，回复线程并重新触发AI审查，确保PR符合合并标准。
address PR comments
look at the reviews on PR N
deal with the bot comments
there is a coderabbit review
iterate on PR N until clean
npx skills add netdata/netdata --skill pr-reviews -g -y
指导在本地构建 Netdata 静态自解压二进制安装包，支持多架构。涵盖 Docker 构建流程、前置检查、18个构建步骤及常见故障排查，用于测试 PR 或生成离线安装产物。
构建静态二进制包
制作 makeself 安装包
验证 PR 在无工具链环境的表现
复现 CI 静态构建问题
npx skills add netdata/netdata --skill project-build-static-binary -g -y
指导AI编写或修改Netdata数据采集插件的最佳实践，涵盖心智模型、NIDL仪表盘设计、性能优化及各类数据类型的开发规范。
添加新的数据采集器
修改现有采集模块
处理日志或拓扑数据
配置Prometheus抓取
npx skills add netdata/netdata --skill project-writing-collectors -g -y
用于排查Netdata代理崩溃、恐慌和致命错误的调查工具。通过高效查询agent-events数据，结合聚类分析脚本，协助开发者定位故障根因并修复问题。
调查代理崩溃或致命错误
按版本或函数筛选事件以查找回归
npx skills add netdata/netdata --skill query-agent-events -g -y
离线分析 Netdata 支持包，诊断单主机告警、崩溃、数据缺失等问题。通过解读系统配置、日志和状态文件，定位故障根因或判断信息不足，排除 SNMP 和集群级分析场景。
analyse this support bundle
a customer sent a bundle
what does this bundle say
why did this agent crash
why is this collector showing no data
why are alerts not firing
npx skills add netdata/netdata --skill triage-support-bundle -g -y
