SuperAPI AI 工具集

xray-cli

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

用途:xray-cli 是面向 Jira Cloud + Xray 插件的测试管理 CLI(TMS_TOOL),用于在 Jira+Xray 环境中创建与维护测试资产、执行测试并回写结果。仅在 Modality jira-xray 模式下使用;若项目为 jira-native(未装 Xray 插件),不应使用本技能,需改用 /acli 并映射为原生 Jira 事务。

主要能力:认证管理(auth login/logout/status,凭据默认从 .env 读取,Jira 站点来自 .agents/project.yaml,可用标志覆盖);测试管理(test create/list/get,支持 Manual/Generic/Cucumber 类型,add-step/remove-step/update-step,update-gherkin/update-definition/update-type);前置条件(precondition create/update/list/get、add-to-test/remove-from-test);测试执行(exec create/get/list、add-tests/remove-tests、add-set、set-environment);测试运行(run get/list、status、step-status、comment、defect、evidence、step-evidence、evidence-list、evidence-rm);测试计划(plan create/get/list、add-tests/remove-tests、add-set、add-executions);同步修复(exec/plan/set sync 与 repair,默认 dry-run,加 --apply 才写入)。

必要用法:先确认项目处于 jira-xray 模式,再执行命令。示例:bun xray auth status、bun xray test list --project DEMO、bun xray exec create --project DEMO --summary "Sprint 1 Tests"、bun xray import junit --file results.xml --project DEMO。事务引用同时接受 Jira key(如 {{PROJECT_KEY}}-194,需 Jira 凭据)与数字 issueId;仅配置 Xray 凭据时传 Jira key 会报错。列表命令默认 --limit 20 且静默截断,应从头部 (N total) 读取总数。Manual 步骤不会在创建时持久化,须先 create 再用 test add-step 逐步添加。

适用场景:Jira+Xray 项目中的测试用例与步骤维护、前置条件管理、测试执行与计划编排、运行状态与证据回写、JUnit/Cucumber 结果导入,以及 Jira 层与 Xray 层漂移的检测与修复。测试环境在 ATR 执行上为必填。

限制:参数化数据集在 Xray Cloud GraphQL 中只读,无数据集变更命令,共享 Parameter List 需在 UI 管理;请求体上限 20 MB,CLI 会自动分块上传目录;本资料未提供收费、价格与平台信息。