App Checklist Issue

app-checklist-issue — APP 回归 Test Execution 快速生成器

固化「APP 回归 Test Execution 创建 + 关联既定 Test 集合」流程，避免每次手动找人/找 JQL。

🎯 目标与适用场景

• 为 APP(v5) 模块创建回归版本的 Xray Test Execution，并指导关联固定的一批历史用例。
• 当前覆盖的模块：
  • Swap & Market
  • DeFi & Perps & 返佣 & Browser
  • 账户模型 & Prime
  • Wallet & 通用

说明：由于当前 Atlassian MCP 未暴露 Xray「向 Test Execution 批量添加 Tests」的 API，本 Skill 只做两件事：

1. 通过 Jira API 帮你创建 Test Execution（含经办人、命名规范）
2. 输出对应模块的 固定 JQL，你在 Xray UI 里用 Add Tests → Existing Tests → JQL 粘贴即可一次性挂完。

🔧 触发指令（你怎么喊）

参数约定

• <version>：APP 版本号，如 6.0.0、6.1.0
• <module>：以下四个固定取值之一（支持中文/英文模糊匹配），或 all：
  • swap / market / Swap & Market
  • defi / perps / 返佣 / browser / DeFi & Perps & 返佣 & Browser
  • wallet / 通用 / Wallet & 通用
  • account / 账户模型 / prime / 账户模型 & Prime
  • all：一次创建四个模块

👤 经办人 & Issue 命名规范

创建的 Issue 类型：Test Execution，项目：OK（OneKey）。

Issue Summary & 修复版本

• Summary 模板：

  回归 APP <version> - <模块名>
  

• Fix Version/s（修复版本）规则：

  • 创建 Issue 时 必须同时写入 Fix Version/s 字段

  • 默认值始终等于指令里的 <version>，例如：

    • 指令：app-checklist-issue 6.1.0 Swap & Market
    • 则 Fix Version/s 设置为：6.1.0

  • 实现方式：调用 createJiraIssue 时，通过 additional_fields 传入：

    {
      "fixVersions": [
        { "name": "App-<version>" }
      ]
    }
    

  • 注意版本名格式为 App-<version>（如 App-6.2.0），不是裸版本号

  • 若该版本在项目中尚不存在，Jira 会按项目配置决定是否自动创建；否则保持失败信息回显给用户。

经办人映射

经办人通过 Jira API lookupJiraAccountId 解析 displayName → accountId，当前约定保持不变，如需变更请更新本表。

🔁 创建 Test Execution 的标准流程

当用户输入：

app-checklist-issue 6.0.0 Swap & Market

助手必须按以下步骤执行（使用 Atlassian MCP）：

1. 解析参数
   • 识别版本号：6.0.0
   • 归一化模块：映射为 Swap & Market
2. 解析经办人
   • 调用 lookupJiraAccountId(cloudId, "andox.zhou")，拿到 accountId
3. 创建 Test Execution
   • 调用 createJiraIssue：

     • projectKey: OK

     • issueTypeName: "Test Execution"

     • summary: 回归 APP 6.0.0 - Swap & Market

     • additional_fields：

       {
         "fixVersions": [
           { "name": "6.0.0" }
         ]
       }
       

     • assignee_account_id: 上一步查到的 accountId

     • description: 简要说明，例如：
       自动创建的回归 Test Execution，用于 APP 6.0.0 Swap & Market 模块回归。

4. 回显信息
   • 输出新建 Issue key（如 OK-51518）及浏览链接
   • 同时输出该模块对应的 JQL 语句，供后续在 Xray UI 里挂用例

📌 JQL 映射

两种 JQL 可用：动态 JQL 在 Xray UI 中使用（自动跟随 folder 变化），固定 JQL 作为备用。

动态 JQL（Xray UI 专用）

testRepositoryPath 仅在 Xray UI 搜索框中生效，Jira REST API 不支持。

固定 JQL（API 兼容，需手动更新）

最后更新：2026-04-13。从 Xray Test Repository 各 folder「View Issues in Navigator」导出。

1️⃣ Swap & Market

issue in (34615,35858,38937,34784,34547,35084,34701,34520,34616,34587,34559,66815,66816,67313,72677,77832,38335,34545,34987,22414,34700,34711,45310,34679,34761,34579,69830,77834,34788,34544,34607,34993,35328,34762,34808,35010,36265,34560,35633,37586,35306,35632,66814,38330,35299,34595,38477,34786,34543,35080,37583,34518,35083,34660,34730,34760,36833,34658,35300,34697,14071,35634,38062,42121,34787,14142,34710,38523,34685,35327,35319,35008,34609,35313,34610,34606,67677,63645,63655,63836,34654,34561,34563,34564,45305,35314,36261,34442,35207,45307,34565,45309,34536,34686,73052,76995)

2️⃣ DeFi & Perps & 返佣 & Browser

issue in (22417,58809,34996,22055,35088,34526,34702,57069,37134,34624,38502,35881,35097,35202,35200,34546,38946,35292,36262,34955,37655,38763,46997,34542,34681,35201,59829,59828,37412,37103,35348,55176,34717,15567,35553,36883,36901,78955,34676,34558,35302,35315,35301,35416,14408,35349)

3️⃣ 账户模型 & Prime

issue in (34519,34780,35291,35296,35294,35293,34618,38429,34549,37102,35942,34555,37131,38939,38945,38947,38414,38415,38423,15449,34554,34637,39218,39256,39286,36894,38579,34523,38543,36198,51517,34583,34581,35076,37145,35101,34703,38571,35074,22413,36223,35178,15560,35882,35100,55369,58220,63656,38570,67680,78078,35148,34743,34580,35871,34577,34578,38998,36197,38886,34785,35646)

4️⃣ Wallet & 通用

issue in (34946,34598,34541,38328,35030,35773,39257,36200,38944,34647,34956,45737,14839,36222,34672,39227,39684,50788,36389,38033,15334,34522,58411,58305,55157,38247,38255,34622,38054,34562,14683,54140,34767,34632,72954,58185,58272,58232,57643,34646,34635,22382,34516,34620,34596,35093,35062,36895,47392,34619,35635,34698,53292,36287,39307,36811,36812,36813,36264,36263,44064,44062,44360,44030,44278,44279,44280,44287,44284,44026,44090,44070,44663,45697,45692,46332,38061,50789,34880,34881,34882,58625,52229,52089,52129,34954,31739,34722,45835,35552,36195)

在 Xray 中挂用例步骤（通用于所有模块）：

1. 打开对应的 Test Execution（如 OK-53150）。
2. 在中部 Tests 面板点击 Add Tests → Existing Tests。
3. 右上切换到 Advanced / JQL 模式。
4. 粘贴上面对应模块的 JQL（动态或固定均可），执行搜索。
5. 列表中全选 → Add，完成关联。

🔄 使用示例

为 6.0.0 版本创建四个回归 Test Execution：

app-checklist-issue 6.0.0 all

只创建单个模块：

app-checklist-issue 6.0.0 swap