Agent Skills
返回列表
优测后台智能用例生成

优测后台智能用例生成

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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 补齐字段的测试开发