优测后台智能用例生成
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c73acbc2/utest-generate-test-plan;并按 SKILL 说明将 scripts 解压到技能目录后再加载。
技能介绍
解决什么问题
在优测(Utest)上维护接口与链路用例,常见痛点是:协议类型多(HTTP、RPC、QUIC、Dubbo、SSE 等)、testcase/trace JSON 结构深、断言字段与枚举(如 position、operator、checkType)稍有偏差就无法上传或调试。手工从代码、Proto 或需求文档拼节点、北极星寻址和 checkList,既慢又容易把业务参数填成占位值。
技能如何工作
本技能把对话意图路由到固定闭环,而不是泛泛「写测试」:
- 生成/修改场景:按协议按需读取
references分支文档,构建符合优测结构的用例;服务寻址优先sys_polarisDiscover,RPC/QUIC 场景强制校验protoFile.app_server_name。 - 本地优先:先生成并落盘到指定目录(默认
testcase/),再询问是否上传;断言严格对齐assert_obj,结构 JSON 会剔除无意义的空对象/空数组字段。 - 平台与运维侧:支持保存/批量上传测试场景、本地
case debug、环境拉取/保存、数据集绑定环境,以及申请 UIN;配套 CLI 脚本(需与 Skill 同目录的scripts)完成热更新与上传,默认不走 MCP,除非用户明确提到 MCP 或utest-mcp。
参数值上有一条硬线:不能只凭 schema 的 required 填请求;凡影响路由、鉴权、资源定位或能否真正发请求的字段,无法从代码/样例 100% 确认 时会进入 ask 模式,一次性列出缺失项,避免生成「看起来完整但跑不通」的用例。
边界与注意点
测试任务执行(跑任务、接口测试任务、任务 UUID、执行组等)已从此 Skill 下线,命中后应改用 Knot 上的优测任务管理 Skill;本 Skill 仍负责用例 JSON 的生成、调试与上传。
多阶段诉求(如「生成并上传」)会串行处理:先完成生成,再读上传/调试文档,不会一次性把所有 reference 灌进上下文。协议未确认前禁止默认按某一协议生成;${a2} 为执行期内置变量,不得写入用例变量定义。
使用场景
- 新服务接入优测时,依据仓库 Proto 与 Go 注册逻辑生成 RPC/QUIC 节点,落盘到 `testcase/` 再决定是否上传。
- 平台校验失败或断言枚举不匹配时,对本地优测 JSON 执行 case debug,修正 `checkList` 与 trace 结构后再保存。
- 迭代一批 HTTP/Dubbo/SSE 场景后,将本地多个用例文件批量保存或同步到优测,而非在对话里手工粘贴 JSON。
- 多环境联调前拉取远端 env、在本地改配置后 save 上传,或把已有 CSV 数据集绑定到指定测试环境。
适合人员
- 在优测维护核心接口链路、需要把代码/Proto/需求转成可上传 trace 与断言的后台或接口测试工程师
- 负责断言与节点结构排错、上传前必须在本地反复调试 JSON 的优测用例维护同学
- 管理测试环境发布、需要 pull/save 环境配置并把数据集绑定到 env 的测试平台或 QA 运维
- 新协议类型(QUIC/Dubbo/SSE 等)接入时,无法 100% 确认路由与业务参数、需要结构化 ask 补齐字段的测试开发