跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
数据与分析

testany-case

Testany platform case 注册与 CRUD - 将已准备好的 platform case package 注册到平台,并管理 metadata、脚本与生命周期

TestAny-io · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add TestAny-io/testany-agent-skills --skill testany-case

技能说明


name: testany-case description: Testany platform case 注册与 CRUD - 将已准备好的 platform case package 注册到平台,并管理 metadata、脚本与生命周期 argument-hint: "[操作] [描述],如:注册这些 case packages、查看 A1B2C3D4、更新脚本、删除一个 case"

Testany Platform Case Registration & CRUD

本 skill 通过 Testany MCP 工具管理 Testany 平台上的 platform cases。 所有操作都是对 Testany 平台的远程 API 调用,不涉及本地文件系统。

关键前提:

  • Testany case 是可复用原子自动化步骤包
  • Testany 不支持直接执行单条 case
  • 如果用户要真正执行,后续仍需要 testany-pipeline

用户输入: $ARGUMENTS


宿主能力适配

  • 优先使用宿主提供的结构化提问工具(如 AskUserQuestion)一次性收集缺失信息。
  • 如果宿主不支持该工具,则用一条普通消息集中提问相同问题;低风险字段可给出默认值建议。
  • 如果宿主支持 slash command,可推荐相关 workflow 的命令入口;否则直接在当前线程继续对应 workflow。

先统一心智模型

使用本 skill 前,先按 automation-model.md 理解边界:

  • 上游给出的通常是 traditional test scenario
  • testany-case-writing 负责把它拆成 platform cases,并产出脚本、ZIP 与 decomposition
  • 本 skill 负责把这些 platform case packages 注册到 Testany 平台
  • testany-pipeline 负责把 platform cases 组装成可执行 pipeline
  • testany-trigger 负责配置 Plan / Manual Trigger / Gatekeeper

重要结论:

  • 本 skill 的主路径不应该是“现场理解业务场景并写 case”
  • 本 skill 的主路径应该是“消费上游已准备好的 package / metadata / decomposition,完成平台注册与生命周期管理”

职责

  • 注册 testany-case-writing 已产出的 platform case packages
  • 创建 case shell、补齐 case metadata、上传脚本 ZIP
  • 查询、更新、批量更新、删除平台上的 platform cases
  • 在变更后提醒用户检查下游 pipeline 影响面
  • 在可行时触发 dry run 验证 case 是否 ready

不负责的事情

  • 不负责把传统测试场景拆解成 platform cases;这属于 testany-case-writing
  • 不负责创建或更新 pipeline;这属于 testany-pipeline
  • 不负责配置 Plan / Manual Trigger / Gatekeeper;这属于 testany-trigger

操作速查

用户意图操作类型工具
注册新的 platform caseCreatetestany_create_case → testany_update_case → testany_update_case_script
查看 case 详情Readtestany_get_case
查看 case 脚本内容Readtestany_get_case_script
搜索/列出 casesReadtestany_list_cases
列出我的 casesReadtestany_list_my_cases
更新 metadata / scriptUpdatetestany_update_case / testany_update_case_script
删除 caseDeletetestany_delete_case
批量更新 casesBulk Updatetestany_bulk_update_cases
批量删除 casesBulk Deletetestany_bulk_delete_cases
dry run 验证Validatetestany_dry_run_case → testany_get_dry_run_result
查看 dry run 日志Readtestany_get_dry_run_log(拼接出 logUrl + curlCommand,agent 代为执行)

Create(注册新的 platform case)

Phase 0: 先判断输入模式

按以下优先级选择输入模式:

  1. Primary:已有 platform case package

    • 来自 testany-case-writing
    • 已准备好脚本、ZIP、metadata、executor 选择
    • 最适合本 skill
  2. Secondary:已有脚本/ZIP,但 metadata 不完整

    • 可以在本 skill 中补齐名称、可见性、labels、case_meta 等字段
  3. Fallback:只想先创建草稿 shell case

    • 仅当用户明确要求占位、预留 key、先建空壳时使用
    • 不能把它包装成“已经完成自动化落地”

如果用户只有传统测试场景,没有脚本、ZIP、decomposition:

  • 停止直接创建
  • 切到 testany-case-writing

Phase 1: 准备可选项

并行获取:

  • testany_filter_case_runtimes
  • testany_get_my_workspaces
  • testany_get_tenant_config(拿 deployment_type,决定 visibility 默认值,见 case-visibility-policy.md)

如涉及 labels,先:

  • testany_list_labels
  • 如缺失再 testany_create_label

Phase 2: 收集注册所需字段

优先一次性收集以下内容:

字段必填说明
name是platform case 名称
runtime_uuid是运行环境 UUID,推荐 cloudprime
is_private是Global / Private — 受 deployment_type 约束,见 case-visibility-policy.md
workspace_keys条件必填is_private=true 时必填;详见 policy 文档
description建议说明该 platform case 的原子职责
case_labels建议用于目录视图和检索
case_meta条件必填运行所需配置,具体字段见 executors reference
ZIP / 脚本包条件必填若目标是注册 runnable case,通常需要

收集原则:

  • 主路径假设用户已经有 package;本 skill 只做“平台注册与补齐元数据”
  • 如果用户明确只要草稿 case,可暂不上传 ZIP,但必须明确这是占位资产,不可直接执行

Phase 3: 创建 shell case

调用 testany_create_case:

  • name
  • runtime_uuid
  • is_private
  • workspace_keys

Phase 4: 补齐 metadata / 运行配置

调用 testany_update_case 设置:

  • description
  • case_labels
  • environments
  • owned_by
  • case_version
  • case_meta

这里的 case_meta 后端字段名仍然是 trigger_method,但它表示的是 case 级运行入口配置:

  • executor
  • trigger_path
  • trigger_command

它不等于 Plan / Manual Trigger / Gatekeeper 这类 pipeline trigger。

case_meta.environment_variables

case 运行时可见的变量列表,每条有一个 type:

type用途填值方式
env(默认)普通环境变量、relay 输入填 value
output供 pipeline 中其他 case relay 消费填 value(运行时由脚本写入)
secrets引用 workspace 的 Credential Safe 条目填 secret_ref: { workspace_key, credential_safe_key, credential_key };禁止填 value

关于 type=secrets:

  • 声明后,脚本里直接用同名环境变量读取凭证值即可(例:os.getenv("DB_PASSWORD")),不需要额外的取值代码或 SDK
  • 如果用户没有现成的 credential_safe_key / credential_key,用 testany_list_credential_safes → testany_list_credential_keys 两步查询(runtime_uuid 必须与 case 一致;两个工具返回签名 curl,需 agent 代为执行)。详细流程见 executors.md 的"查询 credential_safe_key / credential_key"
  • 读回 case 时,每条 secrets 行附带只读字段 status(valid / blocked / invalid)和 status_reasons[]
    • 非 valid 要向用户报告原因。常见 reason:owner_access_not_satisfied(owner 没访问权)、visibility_not_satisfied(case 可见性收窄)、target_not_found_or_unresolvable(safe/key 不存在)、secret_ref_malformed(引用字段不完整)
  • 写入时不要传 value / status / status_reasons;传了会被后端拒绝
  • 如果 testany_update_case / testany_bulk_update_cases / testany_bulk_append_cases 返回错误码 E400002(case_secrets_feature_disabled),向用户说明:当前 workspace 的 secrets 功能可能未开启,请联系 workspace 管理员

写入注意(整集合替换语义):environment_variables 是整数组替换。若只想新增或修改单条 secret,必须先 testany_get_case 读出现有条目,在内存里合并后再写回;否则其他 env / output / secrets 行会被一并清空。

详细字段规则见:

  • Case 元数据规范
  • Executor 配置详解

Phase 5: 上传脚本 ZIP

如果用户已经准备好脚本包,调用 testany_update_case_script 上传。

如脚本中包含以下能力,提醒用户同步补齐配置:

  • Relay 输出 → 在 case_meta.environment_variables 中声明对应的 type=output 行
  • 凭证 / 敏感值访问 → 在 `case_meta.environmen
阅读完整来源 ↗