JMeter脚本编写Skill

Skill 标识
jmeter-script-writer

让 JMeter 脚本从“能跑一次”走向可维护:按统一流程生成或优化 JMX,补齐参数化、关联与断言。跟着源码结构学会扩展,沉淀团队自己的脚本规范。

扫码添加辅导员,发送 Skill 名称领取源码
本文目录
  1. Skill 概览
  2. 适合谁、用在什么场景
  3. 需要准备什么、能得到什么
  4. 核心能力与使用边界
  5. 实战教程与使用说明
  6. 一、为什么要做这个 Skill
  7. 二、Skill 的目标与边界
  8. 1) 目标能力(做什么)
  9. 2) 边界(不做什么)
  10. 三、最终目录架构
  11. 四、SKILL.md 的架构职责设计
  12. 五、references 五份文档各自做什么
  13. 六、从需求到交付的完整生成流程
  14. 七、为什么这个架构适合长期维护
  15. 1) 可扩展
  16. 2) 可协作
  17. 3) 可治理
  18. 4) 可审计
  19. 八、这次实践的本质价值
  20. 九、推荐模板(精简实战版)
  21. 十、使用注意
  22. 但是如果是如果面向“完整接口项目”(几十到上百接口)长期使用,我建议补下面这些能力,会从“能用”升级到“工程化可复用”。
  23. 我对这个 Skill 的使用感受:

Skill 概览

适合谁、用在什么场景

编写接口或压测脚本、维护团队 JMeter 资产的测试工程师。

需要准备什么、能得到什么

  • 输入材料:接口说明、场景目标、测试数据与可选的已有 JMX 脚本。
  • 交付产物:JMeter 脚本结构、配置说明及脚本检查与优化建议。

核心能力与使用边界

  • 核心能力:围绕新建功能脚本、新建性能脚本、已有脚本优化及故障排查组织任务。
  • 使用边界:实际可运行性需结合 JMeter 环境验证;输入不全先澄清,不生成真实凭据或直接进行生产压测。

实战教程与使用说明

这篇文档完整复盘一个可落地的 JMeter 专用 Skill 是如何设计、实现和验证的。目标不是“写一份说明”,而是给你一套可复用的方法,帮助你后续继续扩展成团队级测试资产。


一、为什么要做这个 Skill

在实际测试工作里,JMeter 脚本常见问题很集中:

  • 脚本能跑但结构混乱,难维护

  • 不同人写法差异大,团队输出不一致

  • 断言、参数化、关联经常漏

  • 新人上手慢,靠口口相传

  • 需求变更后,改脚本成本高

所以这个 Skill 的核心价值是把“个人经验”沉淀成“标准化流程 + 可执行产物”。


二、Skill 的目标与边界

1) 目标能力(做什么)

jmeter-script-writer 聚焦四类任务:

  • 新建功能测试脚本

  • 新建性能测试脚本

  • 优化现有 .jmx 脚本

  • 常见问题排查与修复建议

2) 边界(不做什么)

  • 不伪造真实密钥、账号或生产敏感信息

  • 不鼓励直接对生产做高风险压测

  • 输入不足时先追问,不盲猜业务细节

三、最终目录架构

采用“一主多辅”设计,主文件负责调度,参考文档负责能力拆分:

这个结构的优点:

  • 主逻辑稳定,避免频繁改主文件

  • 扩展能力时只需新增 reference

  • 便于多人协作维护


四、SKILL.md 的架构职责设计

SKILL.md 不是“说明书”,而是 Skill 的“执行协议”。当前设计里它承担了 8 个关键职责。


五、references 五份文档各自做什么


六、从需求到交付的完整生成流程


七、为什么这个架构适合长期维护

1) 可扩展

新增一种能力只需新增 reference,不必重写主逻辑。

2) 可协作

主干和能力文档解耦,团队可并行维护。

3) 可治理

质量门槛、默认参数、边界规则都在文本层固化,减少“口头规范失效”。

4) 可审计

每次输出都有固定结构,便于回放和复盘。


八、这次实践的本质价值

这次不是“写了一个 Skill”,而是完成了一次测试工程能力的产品化:

  • 把隐性经验变成显性标准

  • 把一次性交付变成可复用交付

  • 把个人能力放大成团队能力

如果你后续要继续升级,这个架构已经具备“从个人工具走向团队平台”的基础形态了。

九、推荐模板(精简实战版)

根据如下这个模板去提供相关的内容,即可生成对应的jmeter脚本

【1. 目标】

  • 类型:功能验证 / 性能压测

  • 场景名:如 login_api_test

【2. 接口信息】

  • 接口名称:登录

  • 请求方法:POST

  • 完整接口URL:https://api.lemonban.com/xxxx

  • Content-Type:application/json

【3. 请求头】

  • Content-Type: application/json

【4. 请求体或请求参数】

{

"mobile_phone": "13590371518",

"pwd": "lemon123456"

}

【5. 断言要求】

  • 状态码:200

  • 响应字段断言:包含 "code"

【6. 线程组(不写就用默认)】

  • 线程数:1

  • Ramp-Up:1

  • 循环次数:1

【7. 输出要求】

  • 是否带“查看结果树”:是

  • 保存路径:output/login_api_test.jmx

比如这是我们柠檬班的某个项目的登录接口,生成的jmx脚本:

完成的skill我已经给大家整理好放到这里了~

jmeter-script-writer.zip

脚本输出后,我执行的结果如下:是可以完全执行ok的!skill没问题,可以直接用哦~

十、使用注意

jmeter-script-writer Skill 目前已经具备了“单接口到可执行脚本”的核心闭环,作为 1.0 版本是合格的,尤其是:

  • 有明确输入/输出约定,降低沟通成本

  • 有默认参数,信息不全时也能落地

  • 能区分功能、性能、优化、排障四类任务

  • 强调可执行性和维护性,不只是“讲概念”

但是如果是如果面向“完整接口项目”(几十到上百接口)长期使用,我建议补下面这些能力,会从“能用”升级到“工程化可复用”。

  1. 项目级编排能力
    现在偏“单接口脚本生成”,建议新增“多接口流程编排”(登录->下单->支付->查询),支持按业务链路生成多个 Thread Group/Transaction Controller。

  2. 环境与配置分层
    增加 dev/test/stage/prod 环境切换模板(域名、鉴权、租户、开关),把变量统一放 User Defined Variables 或 properties,避免每次改脚本。

  3. 全局鉴权与会话管理
    规范 token/cookie 的提取、缓存、刷新、失效重登策略(如 401 自动重登录),这是项目级压测里最常见痛点。

  4. 数据工厂能力(参数化升级)
    不只是 CSV 读取,还要有:唯一数据生成、数据池回收、按并发分片、失败数据保存,避免数据冲突影响结果真实性。

  5. 断言体系标准化
    从“状态码+字段存在”升级为分层断言:协议断言、业务断言、SLA 断言(P95、错误率、吞吐),并支持按接口模板复用。

  6. 结果输出与报告自动化
    增加 non-GUI 执行后自动产出 HTML Dashboard、关键指标摘要(TPS/P95/错误TOP),方便 CI/CD 集成和日报周报复用。

  7. 项目脚手架输出
    一键生成目录结构:jmx/、data/、env/、reports/、run.sh,让脚本从“文件”变成“项目”。

  8. 协议覆盖扩展
    除 HTTP 外,逐步支持 WebSocket/gRPC/消息队列(如果你项目用得到),避免 Skill 只能覆盖 REST 场景。

我对这个 Skill 的使用感受:

  • 优点:边界清晰、可执行导向强、默认值设计合理、对新手友好。

  • 短板:项目级复用、自动化集成、复杂场景(鉴权/数据/链路)还不够系统。

如果要体系化,并且所有接口关联起来,那么就需要在我的基础上再去做优化和升级~anyway,目前这个算一个初级1.0的体验版,祝大家体验愉快~

jmeter-script-writer.zip

开始使用 jmeter-script-writer

扫码添加辅导员,发送 Skill 名称,领取源码与配套资料。

同类 Skills