MQTTX AI Agent Skill 正式发布
AI 编码 Agent 已经能写出像样的 MQTT 代码，但要让它们正确调用 mqttx 命令，仍然是另一回事：不同命令的参数并不相同，TLS 和认证选项很容易配置错，压测和数据模拟也需要有边界、可复现的参数。如果 Agent 靠猜测来使用 CLI，轻则浪费时间，重则留下没有退出的进程，或者给出一份不可信的结果。
MQTTX AI Agent Skill 正是为了解决这个问题。它位于 MQTTX 仓库中，使用 MQTTX 团队维护的同一套文档，指导 AI 编码 Agent 正确、安全地操作 mqttx 命令。
Skill 覆盖的内容
Skill 围绕 Agent 真正会执行的任务来组织。它的 SKILL.md 会根据任务把 Agent 引导到对应的参考文档，Agent 只需要阅读与当前任务相关的内容，而不必把整份 CLI 手册塞进上下文。
- 基础工作流：
conn、pub、sub，以及有边界的连接检查和消息收发验证。 - 连接与认证：传输协议选择、TLS 与双向 TLS、WebSocket 请求头、凭据和 SCRAM 认证。
- MQTT 功能：MQTT 3 与 MQTT 5 的行为、QoS、保留消息、会话、遗嘱、请求/响应和订阅属性。
- 负载与文件：文本和二进制输入、交互式行模式、从文件读取、编解码、Protobuf 与 Avro Schema，以及随机负载。
- 压测与数据模拟：
bench conn、bench pub、bench sub、simulate、ls --scenarios和自定义生成器。 - 配置与工具命令：
init、check、帮助与版本输出、INI 默认配置，以及 JSON 或 YAML 选项。 - 能力清单：各命令精确的参数可用性，以及不同版本之间的差异说明。
- 故障排查：失败场景下的诊断建议。
通过 Agent 安装 MQTTX CLI
MQTTX 仓库提供了一份面向 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 的 SKILL.md。
试一试
安装好 CLI 和 Skill 之后，可以这样向 Agent 描述任务：
使用 mqttx-cli skill，验证本地 127.0.0.1:1883 broker 的消息收发。使用 mqttx-test/ 下的唯一 topic，在 15 秒内结束检查，并报告结果。
Agent 会据此选择合适的命令和参数，执行检查，并报告结果。