jmeter-script-writer

name	jmeter-script-writer
description	生成与优化 JMeter 脚本（.jmx）及配套执行说明。当用户提到 JMeter、压测脚本、接口压测、参数化、关联、断言、线程组、性能测试、脚本调优时使用。

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 等默认考虑提取与复用

输出质量门槛

生成结果至少满足：

• 有明确线程模型（用户数、爬坡、循环或持续时间）
• 有断言策略（状态码、关键字段、错误信息）
• 有数据策略（固定值或参数化）
• 有执行方式（GUI 或非 GUI 命令）
• 有结果判定标准（至少一个成功阈值）

默认参数（用户未指定时）

• 协议：https
• HTTP 超时：连接 3000ms，响应 10000ms
• 线程组（功能验证）：1 用户，循环 1 次
• 线程组（性能基线）：20 用户，爬坡 30s，持续 5 分钟
• 断言：HTTP 200 + 关键业务字段断言

边界与限制

• 不伪造真实鉴权密钥、账号密码、生产域名
• 若用户提供敏感信息，提醒脱敏后再共享
• 对高风险压测（生产环境）必须提示风险与保护措施

快速触发示例

• “帮我按这个接口文档生成 JMeter 脚本，带参数化和断言”
• “做一个 200 并发、10 分钟的下单压测脚本，目标 P95 < 500ms”
• “这份 .jmx 太乱了，帮我重构并加 token 关联”
• “JMeter 报错 401，帮我排查脚本哪里有问题”
• “直接生成 jmeter 脚本文件，放到 output 目录”