AI Agent Skill

MQTTX CLI 内置了一个 Agent Skill，用于指导 AI 编码 Agent 正确、安全地操作 mqttx 命令。该 Skill 位于 MQTTX 仓库的 skills/mqttx-cli 目录，覆盖连接检查、消息收发、MQTT 5 功能验证、TLS 与 SCRAM 认证、编解码与 Schema、压测、数据模拟、配置和故障排查等场景。

通过 Agent 安装或更新 MQTTX CLI

INSTALL.md 提供了面向 Agent 的安装与更新步骤，包括环境检测、安装渠道选择和版本验证。可以将下面的提示词交给 Agent：

读取 https://raw.githubusercontent.com/emqx/MQTTX/main/INSTALL.md，按照其中的步骤为当前环境安装或更新 MQTTX CLI，并验证命令路径和版本。

安装 Skill

通过 Skills CLI 安装：

npx skills add emqx/MQTTX --skill mqttx-cli

从本地源码安装时，在仓库根目录运行 npx skills add . --skill mqttx-cli。也可以将整个 skills/mqttx-cli 目录（包括 references）复制到 Agent 支持的技能目录，或让 Agent 直接读取其中的 SKILL.md。

Skill 覆盖内容

Skill 的 SKILL.md 会根据任务将 Agent 引导至对应的参考文档，Agent 只需阅读与任务相关的内容：

任务	参考文档
conn、pub、sub、有界检查与收发验证	基础工作流
传输协议、TLS/mTLS、WebSocket 头、凭据、SCRAM	连接与认证
MQTT 3/5、QoS、保留消息、会话、遗嘱、请求/响应、订阅属性	MQTT 功能
文本/二进制输入、交互式行模式、文件、编解码、Protobuf/Avro、随机负载	负载与文件
bench conn、bench pub、bench sub、simulate、ls --scenarios、自定义生成器	压测与数据模拟
init、check、帮助/版本、INI 默认配置、JSON/YAML 选项	配置与工具命令
各命令精确的参数可用性与版本差异说明	能力清单
失败与诊断	故障排查

试一试

安装后，可以这样向 Agent 描述任务：

使用 mqttx-cli skill，验证本地 127.0.0.1:1883 broker 的消息收发。使用 mqttx-test/ 下的唯一 topic，在 15 秒内结束检查，并报告结果。