lmeterx-http-loadtest - SKILL.md Agent Skill

name: lmeterx-http-loadtest description: "对业务 HTTP API（REST/GraphQL 等）执行压力测试，自动预检连通性并创建 LMeterX 压测任务。适用于非 LLM、非网页的普通 API 接口。" allowed_tools: - Bash - Read triggers: - /http-loadtest - /lmeterx-http - /压测API

HTTP 业务 API 压测 (lmeterx-http-loadtest)

对普通业务 HTTP API 端点执行负载测试。支持 REST、GraphQL 和任何非 LLM 的 HTTP 接口。

路由规则

使用本 Skill：

用户提供了普通 HTTP API URL（如 /api/users、/api/orders、/graphql）
用户提供了针对业务 API 的 curl 命令
URL 不是 LLM 端点也不是浏览器网页

不要使用本 Skill：

场景	应使用
URL 以 `/v1/chat/completions` 或 `/v1/messages` 结尾	`/llm-loadtest`
用户提到 "LLM"、"大模型"、"OpenAI"、"Claude"	`/llm-loadtest`
URL 是网页（如 `https://www.baidu.com`）	`/web-loadtest`
用户说 "网站/网页/页面"	`/web-loadtest`

执行方式

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

URL 模式：

export LMETERX_AUTH_TOKEN="${LMETERX_AUTH_TOKEN:-lmeterx}"
python ~/.claude/skills/lmeterx-http-loadtest/scripts/run.py \
  --url "<API URL>" \
  --method GET

curl 模式：

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

POST 带请求体：

export LMETERX_AUTH_TOKEN="${LMETERX_AUTH_TOKEN:-lmeterx}"
python ~/.claude/skills/lmeterx-http-loadtest/scripts/run.py \
  --url "<API URL>" \
  --method POST \
  --header "Authorization: Bearer <token>" \
  --body '{"key": "value"}' \
  --concurrent-users 100 \
  --duration 600 \
  --spawn-rate 50

参数说明

参数	默认值	说明
`--url`	(必填，或用 --curl)	API 端点 URL
`--curl`	(必填，或用 --url)	完整 curl 命令字符串
`--method`	POST(有body)/GET(无body)	HTTP 方法
`--header`	[]	请求头（可重复，格式 `Key: Value`）
`--body`	""	请求体字符串
`--cookie`	[]	Cookie（可重复，格式 `Key=Value`）
`--concurrent-users`	50	并发用户数 (1-5000)
`--duration`	300	持续时间/秒 (1-172800)
`--spawn-rate`	30	用户生成速率
`--name`	(自动生成)	任务名称

结果输出

执行完成后向用户报告：

目标信息：Method + URL
预检结果：通过/失败及分类原因
Task ID 及报告地址：{LMETERX_BASE_URL}/http-results/{task_id}

环境变量

变量	默认值	说明
`LMETERX_BASE_URL`	`<YOUR_LMETERX_BASE_URL>`	LMeterX 后端地址
`LMETERX_AUTH_TOKEN`	`<YOUR_AUTH_TOKEN>`	Service Token（X-Authorization 头）