jmeter-script-writerlisted
Install: claude install-skill ruhedanghaoyigexuesheng/autotest-skills
# JMeter Script Writer
用于把用户的测试目标快速转成可执行的 JMeter 方案,支持以下一体化能力:
1. 新建功能测试脚本(接口正确性、断言校验)
2. 新建性能测试脚本(并发、爬坡、持续压测)
3. 优化现有脚本(参数化、关联、断言、结构重构)
4. 定位常见问题并给出修复建议
## 输入约定
优先使用用户已有信息,常见输入:
- 接口信息:URL、方法、Header、Body、鉴权方式
- 场景信息:并发数、爬坡时长、持续时间、目标 TPS/响应时间
- 现有脚本:`.jmx` 片段、树结构描述、报错信息
- 数据策略:是否参数化、数据规模、数据循环方式
若用户信息不全,按 `references/input-spec.md` 的最小必需项追问;若用户不想补充,使用默认值并明确标注“默认假设”。
## 输出约定
默认输出 4 个区块,保证可落地:
1. **场景理解与假设**(含缺失信息与默认值)
2. **JMeter 测试计划设计**(Test Plan 树结构)
3. **可执行脚本内容**(可直接保存为 `.jmx` 的 XML 或关键片段)
4. **执行与验收说明**(运行命令、观察指标、通过标准)
当用户只要“快速版”时,输出精简版:设计 + 核心 `.jmx` + 一条运行命令。
## 文件落盘规则
当用户明确要求“直接生成脚本文件”或“保存到 output”时:
1. 默认输出文件路径:`output/<场景名>.jmx`
2. 文件名采用小写下划线,如:`register_api_test.jmx`
3. 在回复中同步给出文件路径、主要节点说明与执行命令
若用户未指定保存路径,仅输出 `.jmx` 内容;若指定了路径,则优先按用户路径保存。
## 能力路由
先识别用户意图,再加载对应参考文档:
- 新建功能脚本 -> `references/function-script-playbook.md`
- 新建性能脚本 -> `references/performance-script-playbook.md`
- 优化/重构脚本 -> `references/optimization-checklist.md`
- 报错定位/稳定性问题 -> `references/troubleshooting-guide.md`
如果意图混合(如“先生成功能脚本,再改造成压测脚本”),按阶段拆分输出,每阶段给独立结果。
## 工作流
1. 识别请求类型:功能脚本 / 性能脚本 / 优化调试 / 混合任务
2. 按最小输入清单补齐信息;无法补齐时声明默认假设
3. 产出测试计划树(线程组、取样器、前后置处理器、断言、监听器)
4. 生成 `.jmx` 内容或可拼装片段,确保命名清晰、结构可维护
5. 给出执行命令、验证步骤、常见失败排查
6. 对性能场景额外输出压测分级建议(冒烟/基线/峰值/稳定性)
## 生成规则
- 优先可执行:避免只给概念,不给可运行内容
- 优先稳定:默认添加必要断言、超时、重试策略建议
- 优先可维护:元素命名包含业务语义,避免 `HTTP Request 1` 这类命名
- 参数化优先:出现重复输入时,默认建议 CSV Data Set Config
- 关联优先:登录态、token、动态 ID 等默认考虑提取与复用
## 输出质量门槛
生成结果至少满足:
- 有明确线程模型(用户数、爬坡、循环或持续时间)
- 有断言策略(状态码、关