SuperAPI AI 工具集

testany-guide

测试与质量

查看项目

更新于 10-16 04:42

技能介绍

用途

Testany 平台参考技能,提供 Testany 平台的核心概念与配置参考,帮助使用者理解平台中的实体关系、标识符规则、Executor 配置、Pipeline YAML 语法以及 MCP Schema 资源。若上游来自 testany-eng,建议优先配合 approved Test Spec 中的 Testany Automation Handoff 一起使用。

主要能力

核心实体关系

技能描述了从传统测试场景到平台执行单元的映射链路:

Traditional Test Scenario │ └──► Testany Platform Case │ └──► Pipeline (执行与编排单元) ──► Execution │ ├──► Plan ├──► Manual Trigger └──► Gatekeeper

快速参考

技能提供以下参考文档入口:

  • 本地包与远程变更完成标准 → delivery-verification.md
  • 跨 skill 完整目标与授权接续 → task-handoff.md
  • 对象边界与职责链 → automation-model.md
  • 实体定义和可见性规则 → concepts.md
  • Executor 配置详解 → executors.md
  • Pipeline YAML 语法 → pipeline-yaml.md

宿主能力适配

testany-bot 通用版按能力而不是按宿主品牌分支:

  • 如果宿主支持结构化提问工具(如 AskUserQuestion),优先一次性收集缺失信息。
  • 如果宿主不支持该工具,则用普通文本在当前对话中提问;低风险字段可给出默认值建议,但必须明确告知用户。
  • 如果宿主支持 slash command / router,可推荐相关 workflow 的命令入口。
  • 如果宿主不支持 slash command,不要阻塞任务;直接在当前线程继续对应 workflow。

标识符格式

类型 格式 示例
Case Key 8 位大写十六进制 A1B2C3D4
Pipeline Key {WS_KEY}-{4-5位大写十六进制} Y2K-0001A
Workspace Key 3 位大写字母数字 Y2K
Execution ID {pipeline_key}-{5位大写十六进制} Y2K-0001A-0000B

MCP Schema Resources

在组装 API payload 前,应先读取对应的 schema resource:

Resource URI 用途
testany://schema/case Case 创建/更新字段定义
testany://schema/pipeline Pipeline YAML 完整 schema
testany://schema/import-git V2 Git 导入(连接 / 浏览 / 同步 / switch / relation / webhook)全量流程与类型

使用方式

该技能以参考文档形式组织,详细内容见 references/ 目录。使用者可根据需要查阅对应的参考文档,例如在配置 Executor 时查阅 executors.md,在编写 Pipeline 时查阅 pipeline-yaml.md,在组装 API payload 前先读取对应的 MCP schema resource。

适用场景

适用于需要对接 Testany 平台进行测试自动化编排、配置与执行的场景,包括理解平台实体关系、配置 Executor、编写 Pipeline YAML、使用 MCP Schema 资源等。

限制

关于该技能的具体安装方式、收费模式、平台支持范围等信息,资料中暂未提供。