lmeterx-llm-loadtest - SKILL.md Agent Skill

name: lmeterx-llm-loadtest description: "对 LLM API（OpenAI/Claude 兼容接口）执行压力测试，自动预检连通性并创建 LMeterX 压测任务。URL 必须以 /v1/chat/completions 或 /v1/messages 结尾。" allowed_tools: - Bash - Read triggers: - /llm-loadtest - /lmeterx-llm - /压测LLM

LLM API 压测 (lmeterx-llm-loadtest)

对 LLM API 端点执行负载测试。支持 OpenAI 兼容 (/v1/chat/completions) 和 Claude 兼容 (/v1/messages) 接口。

路由规则

使用本 Skill：

URL 以 /v1/chat/completions 结尾（OpenAI 兼容）
URL 以 /v1/messages 结尾（Claude/Anthropic 兼容）
用户提到 "LLM"、"大模型"、"OpenAI"、"Claude"、"chat completions"

不要使用本 Skill：

场景	应使用
URL 是网页（如 `https://www.baidu.com`）	`/web-loadtest`
URL 是普通 API（如 `/api/users`、`/graphql`）	`/http-loadtest`
用户说 "网站/网页/页面"	`/web-loadtest`

执行方式

必须通过 Bash 执行脚本，禁止手动构造 HTTP 请求。

获取用户提供的 LLM API URL 或 curl 命令后，在 Bash 中执行：

URL 模式：

export LMETERX_AUTH_TOKEN="${LMETERX_AUTH_TOKEN:-lmeterx}"
python ~/.claude/skills/lmeterx-llm-loadtest/scripts/run.py \
  --url "<LLM API URL>" \
  --header "Authorization: Bearer <api-key>" \
  --body '{"model":"gpt-4","messages":[{"role":"user","content":"Hello"}]}'

curl 模式：

export LMETERX_AUTH_TOKEN="${LMETERX_AUTH_TOKEN:-lmeterx}"
python ~/.claude/skills/lmeterx-llm-loadtest/scripts/run.py \
  --curl '<完整 curl 命令>'

自定义负载参数：

export LMETERX_AUTH_TOKEN="${LMETERX_AUTH_TOKEN:-lmeterx}"
python ~/.claude/skills/lmeterx-llm-loadtest/scripts/run.py \
  --url "<LLM API URL>" \
  --header "Authorization: Bearer <api-key>" \
  --body '{"model":"gpt-4","messages":[{"role":"user","content":"Hi"}]}' \
  --concurrent-users 50 \
  --duration 300 \
  --spawn-rate 30

参数说明

参数	默认值	说明
`--url`	(必填，或用 --curl)	LLM API 端点 URL
`--curl`	(必填，或用 --url)	完整 curl 命令字符串
`--header`	[]	请求头（可重复，格式 `Key: Value`）
`--body`	""	请求体 JSON 字符串
`--model`	(自动从 body 提取)	模型名称
`--stream` / `--no-stream`	true	流式模式
`--concurrent-users`	50	并发用户数 (1-5000)
`--duration`	300	持续时间/秒 (1-172800)
`--spawn-rate`	30	用户生成速率
`--name`	(自动生成)	任务名称
`--test-data`	""	数据集：`""` 不使用数据集，`"default"` 使用内置默认数据集

结果输出

执行完成后向用户报告：

API 类型：OpenAI Chat 或 Claude Chat
预检结果：通过/失败及分类原因
Task ID 及报告地址：{LMETERX_BASE_URL}/results/{task_id}

环境变量

变量	默认值	说明
`LMETERX_BASE_URL`	`https://lmeterx.openxlab.org.cn`	LMeterX 后端地址
`LMETERX_AUTH_TOKEN`	`lmeterx`	Service Token（X-Authorization 头）