用途:该技能用于与 Zephyr Squad (Legacy) 交互,这是一款直接集成在 Jira 中的测试管理工具,帮助团队在 Atlassian 生态内规划、执行和跟踪测试工作。官方 API 文档见 https://support.smartbear.com/zephyr-squad/api-docs/。
主要能力:围绕测试周期(Test Cycle)、测试执行(Test Execution)、测试步骤(Test Step)、文件夹(Folder)、项目(Project)和用户(User)等对象进行操作。内置动作包括 ZQL 搜索(zql-search)、获取执行状态(get-execution-statuses)、更新步骤结果(update-step-result)、创建/列出/删除文件夹、创建/获取/更新/删除测试步骤、创建/获取/更新/删除测试执行、按周期列出执行、创建/获取/更新/删除测试周期、按项目和版本列出测试周期等。
使用方式:先安装 Membrane CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成后执行 membrane login complete <code>。建立连接:membrane connection ensure "https://smartbear.com/test-management/zephyr-squad/" --json,若状态为 BUILDING 可用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}'。动作未覆盖时可代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--rawData、--query、--pathParam 等选项。
适用场景:需要在 Jira 内批量管理测试周期与执行、更新测试步骤结果、按 ZQL 查询执行记录等测试管理自动化任务。
限制:认证与凭据刷新由 Membrane 处理,不应向用户索取 API 密钥或令牌;具体动作参数与返回结构需通过 action list 查询获得。资料未提供价格、平台支持范围及速率限制等信息。