测试专用Skills包标准化使用手册

手册目的：规范4个测试专用Skills包（Excel用例、Xmind用例、API测试用例、JMeter脚本）的使用流程，明确输入规范、输出标准、工具导入步骤及常见问题解决方案，帮助团队成员快速上手、高效落地，减少沟通成本和操作失误。

适用人群：全体测试人员（手工测试、接口测试、性能测试相关）

核心原则：输入极简规范、输出直接可用、步骤清晰无冗余，彻底解决“格式转换、中转适配”的核心痛点。

一、Excel用例Skills包

1.1 核心说明

功能：根据输入的测试需求/用例信息，直接输出标准Excel用例文件，无需手动调整格式、排版，可直接用于用例管理、评审、执行。

适配工具：Microsoft Excel 2016及以上版本、WPS Excel（全版本）

1.2 输入示例（极简规范）

输入格式：测试模块+用例核心信息（用换行分隔，无需排版）

示例：

测试模块：用户登录模块

用例1：正确账号密码登录；前置条件：用户已注册、系统正常运行；操作步骤：1.打开登录页 2.输入正确账号（test123） 3.输入正确密码（Test@123） 4.点击登录按钮；预期结果：登录成功，跳转至首页，显示用户名test123

用例2：错误密码登录；前置条件：用户已注册、系统正常运行；操作步骤：1.打开登录页 2.输入正确账号（test123） 3.输入错误密码（123456） 4.点击登录按钮；预期结果：登录失败，提示“账号或密码错误”

1.3 输出样例

输出文件：Excel用例_用户登录模块.xlsx（文件名自动包含测试模块，便于区分）

文件内容（标准列，无需修改）：用例编号（自动生成）、测试模块、用例标题、前置条件、操作步骤、预期结果、优先级（默认中等，可手动修改）、执行状态（默认未执行）。

1.4 工具导入/使用步骤

1. 接收Skills包输出的Excel文件，保存至本地测试用例文件夹（建议按“项目-模块”分类存放）；

2. 直接双击文件，用Excel/WPS打开即可使用，支持直接编辑（修改优先级、填写执行状态等）；

3. 若需同步至用例管理工具（如TestRail），直接从Excel复制内容，粘贴至工具对应字段即可（因输出格式标准化，无需调整排版）。

1.5 常见问题（FAQ）

• 问题1：打开Excel文件提示“格式错误”？ 解决方案：检查本地Excel/WPS版本，升级至2016及以上；若仍异常，重新调用Skills包生成文件（大概率是文件传输过程中损坏）。

• 问题2：输出的用例缺少“优先级”列？ 解决方案：无需手动添加，Skills包默认生成该列，若未显示，在Excel中调整“列宽”或“取消隐藏”即可。

• 问题3：输入多个用例后，输出文件中用例顺序错乱？ 解决方案：输入时按“用例执行顺序”排列，Skills包将按输入顺序生成用例，无需后续调整。

二、Xmind用例Skills包

2.1 核心说明

功能：根据输入的测试需求/用例梳理思路，直接生成可编辑的Xmind脑图文件，无需先生成文本再手动绘制脑图，提升用例梳理、思路拆解效率。

适配工具：Xmind 8及以上版本、Xmind ZEN（全版本）

2.2 输入示例（极简规范）

输入格式：测试需求+模块拆分+核心用例节点（用换行/层级分隔，无需手动排版脑图结构）

示例：

测试需求：用户登录模块测试（覆盖正常登录、异常登录、记住密码功能）

一级节点：用户登录模块

二级节点1：正常登录（子节点：正确账号密码、记住密码登录）

二级节点2：异常登录（子节点：错误密码、空账号、空密码、账号未注册）

二级节点3：边界场景（子节点：账号含特殊字符、密码长度临界值、连续多次登录失败）

2.3 输出样例

输出文件：Xmind用例_用户登录模块.xmind（文件名自动包含测试模块）

文件内容（自动生成层级）：中心主题（测试需求）→ 一级节点（测试模块）→ 二级节点（测试场景）→ 三级节点（具体用例/校验点），脑图样式默认简洁版（可手动修改颜色、布局）。

2.4 工具导入/使用步骤

1. 接收Skills包输出的Xmind文件，保存至本地（建议与对应Excel用例存放在同一文件夹）；

2. 打开本地Xmind软件，点击“文件→打开”，选择该Xmind文件，即可直接编辑（添加/删除节点、修改样式、添加备注等）；

3. 若需分享给团队，直接发送该文件即可（所有Xmind版本均兼容，无需转换格式）；

4. 若需基于脑图生成Excel用例，可在Xmind中导出“Excel格式”（辅助功能，核心仍以Skills包直接输出的Excel为准）。

2.5 常见问题（FAQ）

• 问题1：Xmind文件无法打开？ 解决方案：检查本地Xmind版本，若低于8.0，升级软件；若版本正常，重新生成文件（排除文件损坏）。

• 问题2：输出的脑图层级混乱？ 解决方案：输入时明确层级（如用“一级/二级”标注），Skills包将按输入层级生成脑图；若仍混乱，可在Xmind中手动拖拽调整节点顺序。

• 问题3：脑图中无法添加备注？ 解决方案：双击对应节点，点击Xmind软件右侧“备注”图标，即可添加（Skills包仅生成核心节点，备注需手动补充，不影响核心使用）。

三、API测试用例Skills包

3.1 核心说明

功能：根据输入的接口信息，直接输出标准Postman JSON文件，无需手动在Postman中录入接口地址、请求方式、入参等信息，导入即可执行接口测试。

适配工具：Postman（桌面版8.0及以上、网页版全版本）

3.2 输入示例（极简规范）

输入格式：接口基础信息+请求信息+校验规则（用换行分隔，关键信息标注清晰）

示例：

接口名称：用户登录接口

接口地址：https://test.xxx.com/api/user/login

请求方式：POST

请求头：Content-Type: application/json

请求体（JSON）：{“username”:“test123”,“password”:“Test@123”}

校验规则：状态码200、响应体包含"code":200、响应体包含"username":“test123”、响应时间≤500ms

环境变量：baseUrl=https://test.xxx.com（可选，用于多环境切换）

3.3 输出样例

输出文件：Postman_API用例_用户登录接口.json（文件名自动包含接口名称）

文件内容（标准Postman导出格式）：包含接口集合（Collection）、接口信息（地址、请求方式、请求头、请求体）、响应校验规则（Tests脚本，自动生成）、环境变量（若输入中提供），导入后可直接执行。

3.4 工具导入/使用步骤

1. 打开Postman软件（桌面版/网页版），登录个人/团队账号（便于同步接口用例）；

2. 点击左侧“Collections”（集合）→ 右上角“Import”（导入）按钮；

3. 在弹出的窗口中，选择“Upload Files”，找到Skills包输出的JSON文件，点击“Import”，完成导入；

4. 导入后，找到对应接口集合，点击接口名称，切换至“Body”和“Tests”标签，确认信息无误（无需修改，Skills包已标准化配置）；

5. 点击“Send”按钮，即可执行接口测试，测试结果将在“Test Results”中显示（自动校验状态码、响应体等）。

3.5 常见问题（FAQ）

• 问题1：导入JSON文件提示“格式错误”？ 解决方案：检查输入的接口信息是否规范（如请求体JSON格式是否正确，无语法错误），重新调用Skills包生成文件；若输入无误，更新Postman版本后重新导入。

• 问题2：导入后接口执行失败，提示“环境变量未定义”？ 解决方案：若输入时未提供环境变量，直接修改接口地址为完整地址（删除{{baseUrl}}）；若提供了环境变量，在Postman中创建对应环境，配置baseUrl变量值后重新执行。

• 问题3：响应校验失败（实际状态码正确，但Tests提示失败）？ 解决方案：打开Postman的“Tests”标签，检查自动生成的校验脚本，若校验规则与实际需求不符（如响应体字段名称差异），手动修改脚本即可（Skills包按输入的校验规则生成，若输入有误需同步调整）。

• 问题4：导入后请求头缺失？ 解决方案：检查输入时是否填写请求头，若未填写，Skills包默认不生成；可重新调用Skills包补充输入请求头，或在Postman中手动添加。

四、JMeter脚本Skills包

4.1 核心说明

功能：根据输入的压测需求、接口信息，直接生成可运行的JMeter脚本（jmx文件），无需手动搭建测试计划、添加线程组、配置采样器等，导入JMeter即可启动性能压测。

适配工具：JMeter 5.0及以上版本（推荐5.4.1版本，兼容性最佳）

4.2 输入示例（极简规范）

输入格式：压测基础信息+接口信息+压测参数（用换行分隔，关键参数明确）

示例：

压测名称：用户登录接口性能压测

接口信息：POST https://test.xxx.com/api/user/login，请求头Content-Type: application/json，请求体{“username”:“test123”,“password”:“Test@123”}

压测参数：线程数50，循环次数100， ramp-up时间10秒（线程启动时间），压测时长（可选）：无（按循环次数执行）

响应校验：状态码200，响应时间≤1000ms，错误率≤1%

参数化（可选）：用户名从CSV文件读取（CSV文件路径：D:\jmeter\data\username.csv）

4.3 输出样例

输出文件：JMeter脚本_用户登录接口压测.jmx（文件名自动包含压测名称）

文件内容（标准JMeter脚本格式）：包含测试计划、线程组（按输入参数配置）、HTTP请求（接口信息完整配置）、响应断言（按校验规则配置）、查看结果树、聚合报告（常用监听器，便于查看压测结果），若输入参数化需求，将自动配置CSV数据文件配置元件。

4.4 工具导入/使用步骤

1. 打开本地JMeter软件（5.0及以上版本），点击“文件→打开”；

2. 找到Skills包输出的jmx文件，选中后点击“打开”，完成脚本导入（导入后自动加载所有配置，无需手动补充）；

3. 导入后检查关键配置：线程组（线程数、循环次数、ramp-up时间）、HTTP请求（接口地址、请求体）、断言规则，确认与输入一致；

4. 若有参数化配置，确认CSV文件路径正确（若路径变更，双击“CSV数据文件配置”元件，修改“文件名”路径即可）；

5. 点击顶部“运行”按钮（绿色三角形），启动压测；压测完成后，在“查看结果树”中查看接口执行详情，在“聚合报告”中查看压测指标（响应时间、错误率等）。

4.5 常见问题（FAQ）

• 问题1：JMeter打开jmx文件提示“脚本版本不兼容”？ 解决方案：升级JMeter至5.0及以上版本（推荐5.4.1），重新导入；若无法升级，重新调用Skills包，生成适配低版本的脚本（需备注说明JMeter版本）。

• 问题2：压测时提示“接口连接失败”？ 解决方案：检查接口地址是否正确（是否为压测环境地址）、本地网络是否能访问该接口；若接口正常，检查JMeter中是否有代理配置，关闭无关代理后重新运行。

• 问题3：参数化配置后，提示“文件找不到”？ 解决方案：检查CSV文件路径是否正确（建议使用绝对路径），确保文件存在且格式正确（UTF-8编码，无乱码）；若路径无误，重新配置“CSV数据文件配置”元件的路径。

• 问题4：压测结果中错误率过高，但单独执行接口正常？ 解决方案：检查线程数是否过高（超出接口承载能力），调整线程数和ramp-up时间；或检查断言规则是否过严（如响应时间阈值设置过小），修改断言后重新压测。

• 问题5：监听器中无压测数据？ 解决方案：确认脚本已正确运行（底部状态栏显示“运行中”/“已完成”）；若未运行，检查线程组配置（是否勾选“运行线程组”），重新启动压测。

五、通用注意事项

• 所有Skills包的输入信息需准确、简洁，避免冗余描述（如无需说明“我需要生成XX文件”，直接输入核心信息即可），否则可能影响输出准确性。

• 输出文件建议按“项目名称-模块/接口名称-文件类型”的规则存放，便于团队查找和管理（如：电商项目-用户登录-Excel用例.xlsx）。

• 若需修改输出内容，优先重新调用Skills包补充/调整输入信息，生成新文件；若仅需小幅修改（如Excel用例修改优先级、JMeter调整线程数），可直接在对应工具中编辑。

• 若遇到未在FAQ中提及的问题，及时反馈给技能包维护人员，同步更新手册。

六、附则

本手册将根据Skills包的迭代升级、团队使用反馈，定期更新（更新记录将同步至手册末尾），确保内容与实际使用场景一致。

手册维护人：XXX 联系方式：XXX

更新时间：2026年X月X日