Agent Skills
› netdata/netdata
netdata/netdata
GitHub指导Netdata采集器的编写、修改与审查，涵盖Go/C/Rust等多语言插件。提供生命周期管理、指标一致性、性能约束及框架集成规范，确保数据采集的准确性、资源可控性与生产级质量。
Install All Skills
npx skills add netdata/netdata --all -g -y
Skills in Collection (45)
指导Netdata采集器的编写、修改与审查，涵盖Go/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 Framework V2 采集器的实现、迁移和代码审查。涵盖生命周期管理、指标存储、图表引擎及主机范围等核心概念，提供开发规范与参考文档索引。
编写新的 Go 采集器模块
将 V1 采集器迁移至 V2 框架
审查采集器相关代码变更
npx skills add netdata/netdata --skill collectors-go-framework-v2 -g -y
规范 Collector metadata.yaml 的编写、审查与解释，确保集成页面文案准确可读。涵盖字段含义、权限、成本及告警说明，协调 docgen 生成机制与 DynCfg 表单内容。
编写或修改 collector metadata.yaml 内容
审查集成页面的用户可见文案
解释 metadata 字段的含义与默认值
npx skills add netdata/netdata --skill collectors-metadata-yaml -g -y
用于创建、审查和验证 Netdata Prometheus Chart 配置文件，涵盖仪表板设计、收集策略及语义证明。支持脚本编写、数据捕获、安装及在线验证等全流程操作。
创建或重新设计 Prometheus 配置文件
审查配置文件或证明变更
构建测试用例或捕获私有证据
验证配置文件格式与运行时行为
npx skills add netdata/netdata --skill collectors-prometheus-profiles -g -y
用于编写和审查Netdata SNMP轮询配置文件、解析规则及拓扑/许可/BGP行定义。涵盖MIB可访问性检查、索引提取逻辑及格式文档验证，确保数据采集符号与源MIB一致。
需要创建或修改SNMP采集配置文件
审查SNMP OID映射及索引提取逻辑
检查设备特定MIB偏差合规性
npx skills add netdata/netdata --skill collectors-snmp-profiles -g -y
用于编写和审查 Netdata SNMP Trap 配置文件、指标规则及生成器。涵盖 MIB、分类、严重性及压缩策略，确保符合格式与契约规范。
修改 SNMP Trap 配置文件或元数据
审查 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 或分支验证内容，避免污染主仓库。
用户明确要求本地预览、构建或检查文档 PR
需要验证未合并的文档更改效果
npx skills add netdata/netdata --skill docs-learn-pr-preview -g -y
负责 Netdata Learn 文档站点的结构管理，包括页面映射、URL、重定向及 MDX 内容。涵盖审查变更、添加页面及修复链接等任务，确保文档发布与 CI/CD 流程的正确性。
审查或修改 Learn 站点页面、映射关系或重定向配置
排查文档链接失效或构建错误
向 Learn 站点添加新文档页面
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 健康警报。确保语法正确且符合生产策略，通过 NIDL 框架实现跨系统等效性，管理生命周期与路由。
编写或修改 Netdata 健康警报定义
将其他系统的警报转换为 Netdata 格式
审查警报的表达式、生命周期或路由配置
npx skills add netdata/netdata --skill health-alert-authoring -g -y
管理Netdata集成流水线，负责从元数据到页面、目录的生成与交付。涵盖验证、文档一致性检查及IBM/NPM生产者处理，确保源文件与运行时产物隔离，支持新集成添加或现有集成变更的审查与发布。
需要验证或更新Netdata集成元数据
执行集成文档或目录的重新生成与审查
处理IBM.d模块或NPM编目的生成链
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审查处理技能，用于收集、验证并分类GitHub评论、AI机器人反馈、SonarCloud及CI等来源的PR问题。支持只读检查报告或授权后的修复操作，确保审查范围准确且符合项目规范。
请求审查PR评论或反馈
需要执行完整的PR审查分流
要求解决已验证的代码问题
npx skills add netdata/netdata --skill repo-pr-reviews -g -y
用于创建、审查、修改和重构 Netdata 项目中的 Agent Skill 文档。涵盖技能指令编写、触发场景定义、路由规则及知识保留，支持只读审查与受限范围内的内容修正。
需要创建新的 Agent Skill
审查或改进现有 Skill 文档结构
修复 Skill 中的过时信息或重复内容
重构或拆分大型 Skill 知识库
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查询引擎端到端正确性测试套件，用于回归测试、修复验证及用例扩展。支持运行测试、审查变更、添加Fixtures及复现Bug，确保查询结果语义正确。
需要验证查询引擎回归测试
执行或解释测试套件结果
添加或修改测试用例和Fixtures
复现查询引擎Bug
审查测试套件变更
npx skills add netdata/netdata --skill tests-query-corpus -g -y
指导助手设计、修改和审查 Netdata 拓扑生产者及 v1 payload，涵盖数据模型、验证规则及关联展示。提供各组件文档路由与开发工作流规范。
设计或修改 Netdata 拓扑结构定义
审查 topology.v1 payload 合规性
配置拓扑生产者、链接或证据
npx skills add netdata/netdata --skill topology-authoring -g -y
用于调查Netdata代理崩溃、恐慌和致命错误。通过读取agent-events捕获数据，提供高效查询模式、字段解释及结果分析脚本，辅助开发者快速定位和排查大规模集群中的异常事件。
需要调查Netdata代理崩溃或致命错误
分析agent-events捕获数据以定位故障原因
查询和理解AE_*相关字段与时间线
npx skills add netdata/netdata --skill triage-agent-events -g -y
用于审查和分析 Codacy 代码质量发现及本地分析器。支持检查静态分析报告、运行本地 CLI 分析、查询 PR 问题以及诊断 CLI/API 故障，涵盖只读审查与需授权的修复操作。
审查 Codacy 静态分析发现的问题
运行本地代码质量分析
查询 Pull Request 中的代码问题
诊断 Codacy CLI 或 API 故障
npx skills add netdata/netdata --skill triage-codacy -g -y
用于审查和分类 GitHub Code Scanning 告警，执行已授权告警的关闭操作。通过脚本调用 GitHub REST API 列出、检查发现项并应用验证后的决策，不涉及查询编写或 CI 配置。
需要审查 GitHub 代码扫描告警
批量处理或关闭已授权的 CodeQL 发现项
npx skills add netdata/netdata --skill triage-codeql -g -y
用于审查 Coverity Scan 缺陷、生成本地分析包、获取实时数据及应用分类决策。提供脚本辅助缺陷整理与验证，支持手动或多模型审核流程，专注代码静态扫描结果的定级与处理。
审查 Coverity 保存的缺陷报告
解释特定 CID 缺陷详情
准备本地缺陷审查数据包
获取并解析实时扫描发现结果
应用已验证的缺陷分类决策
npx skills add netdata/netdata --skill triage-coverity -g -y
用于离线调查SNMP诊断证据、审查诊断工具变更及解释证据字段的开发工作流。涵盖拓扑缺失、指标异常、BGP/许可证问题及收集缓慢等场景，通过回放和源码追溯定位故障根源。
分析捕获的SNMP支持包或诊断数据
审查诊断工具或证据解释的代码变更
解释特定证据字段含义或局限性
npx skills add netdata/netdata --skill triage-snmp-diagnostics -g -y
用于审查、检查及执行 SonarCloud/SonarQube 代码质量与安全问题的分流决策。支持基于提供证据的离线审查或基于凭证的在线查询，涵盖 Bug、漏洞、代码异味及安全热点的处理，包括确认为误报、确认修复或拒绝修复等操作。
审查 SonarQube 提供的代码问题证据
对 SonarCloud 安全热点进行状态变更
批量处理已知误报模式
修改项目级代码质量规则策略
npx skills add netdata/netdata --skill triage-sonarqube -g -y
用于直接查询 Netdata Agent API 和函数，涵盖指标、日志、拓扑等数据获取。支持解释文档、运行查询及排查认证问题，适用于运维监控场景。
需要直接访问 Netdata Agent 接口查询监控数据
排查 Netdata 代理的 Bearer 认证或配置问题
npx skills add netdata/netdata --skill query-netdata-agents -g -y
用于查询和解释 Netdata Cloud API（指标、日志、拓扑等），支持执行查询或审查配置变更，需本地环境准备及凭证配置。
查询 Netdata Cloud 监控数据
审查或解释 API 调用逻辑
npx skills add netdata/netdata --skill query-netdata-cloud -g -y
用于查询、解释和审查SNMP陷阱日志及配方，支持通过Cloud或Agent执行查询。涵盖安全陷阱分析、去重、自定义MIB转换及字段解码，提供标准化操作指南与安全执行规范。
查询和分析SNMP陷阱日志
审查SNMP陷阱记录
将自定义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 支持包，诊断单主机告警、采集失败、崩溃及性能问题。通过解析 bundle 内容定位根因，排除 SNMP 和集群级故障，辅助技术支持。
分析支持包
客户发送了 bundle
代理为何崩溃
采集器无数据
告警未触发
npx skills add netdata/netdata --skill triage-support-bundle -g -y
