自动修复 Jira Bug 并部署

适用场景

用户提供一个 Jira issue 链接（如 https://jira.meitu.com/browse/ROB-2681），要求自动修复该 bug、部署到 pre 环境并更新 Jira 状态。

前置条件

当前工作区为目标前端项目仓库，且在开发分支上
工作区无未提交更改（先 git status 检查）
Omnibus MCP Server 已启用（提供 Jira 工具）
merge-dev-to-pre-or-beta skill 可用

操作流程

按顺序执行以下 6 个步骤，每步完成后再进入下一步。

步骤 1：解析 Jira 链接并获取 Bug 详情

从用户提供的链接中提取 issue key（如 ROB-2681）。

调用 jira_get_issue 获取 issue 详情（expand 设为 editmeta,transitions）：

CallMcpTool: server=user-Omnibus, toolName=jira_get_issue
arguments: { "issueKey": "<ISSUE_KEY>", "expand": "editmeta,transitions" }

调用 jira_get_attachments 获取附件列表（截图、视频等）：

CallMcpTool: server=user-Omnibus, toolName=jira_get_attachments
arguments: { "issueKey": "<ISSUE_KEY>" }

从返回结果中提取以下关键信息：
- 标题（summary）
- 描述（description）— bug 的文字描述
- 重现步骤（通常在 description 或自定义字段中）
- 期望结果与实际结果
- 附件（截图/视频 URL）— 尝试通过 WebFetch 或 Read 工具查看图片内容
- editmeta — 记录可编辑字段及其 allowedValues，后续更新状态时需要
- transitions — 记录可用的状态流转及其 ID，找到「已解决」对应的 transitionId

步骤 2：分析 Bug 是否属于本项目代码问题

根据步骤 1 获取的信息，结合项目代码进行分析：

理解 bug 描述：仔细阅读标题、描述、重现步骤、期望/实际结果
查看附件：如有截图或视频，通过工具查看以理解 bug 现象
通过关键词定位代码：先根据下方「关键词 → 代码位置映射」缩小搜索范围，再用 SemanticSearch / Grep / Glob 精确定位
判断归属：

| 判断结果 | 后续动作 | |---------|---------| | 是本项目前端代码 bug | 继续步骤 3 | | 非本项目 bug（后端/其他项目/配置/环境问题） | 停止流程，通知用户原因，并建议转给对应负责方 | | 信息不足无法判断 | 暂停流程，向用户说明需要补充的信息 |

关键词 → 代码位置映射

根据 bug 描述中的关键词，快速定位到对应的代码区域：

业务模块

| 关键词 | 代码位置 | 说明 | |--------|---------|------| | 工作流、流程、flow、SOP | packages/roboneo-sdk/src/pages/RoboneoFlow 及子组件 | 工作流相关页面与逻辑 | | 画布、canvas、无限画布、拖拽 | packages/roboneo-sdk/src/pages/RoboneoCanvas 及子组件 | 画布相关页面与逻辑 | | Agent、智能体、对话 | packages/roboneo-sdk/src/pages/RoboneoAgent 及子组件 | Agent 相关页面与逻辑 | | Agent 分享封面、分享封面页、share cover | packages/roboneo-sdk/src/pages/RoboneoShareCover 及子组件 | Agent 分享封面页 | | Agent 分享、分享页、share | packages/roboneo-sdk/src/pages/RoboneoShare 及子组件 | Agent 分享页 | | 工作流分享、流程分享、flow share | packages/roboneo-sdk/src/pages/RoboneoFlowShare 及子组件 | 工作流分享页 |

SDK / npm 包

| 关键词 | npm 包 | 说明 | |--------|--------|------| | 登录、注册、账号、鉴权、token | @meitu/account 相关包 | 账号 SDK | | 订阅、会员、付费、套餐、权益 | @meitu/subscribe 相关包 | 订阅 SDK | | 客服、反馈、工单、帮助 | @meitu/feedback 相关包 | 客服 SDK | | JSBridge、端能力、Native、app 交互 | @meitu/hogger 相关包 | App 交互 SDK | | 画布引擎、infinite-canvas、缩放、平移 | @meitu/whee-infinite-canvas 相关包 | 画布 SDK | | 上传、文件上传、图片上传、upload | @meitu/upload 相关包 | 上传 SDK |

定位策略：

先匹配关键词确定模块/SDK 范围
若命中业务模块 → 在对应目录下搜索
若命中 SDK 包 → 先在 node_modules/<包名> 中查看接口定义，再在项目代码中搜索该包的调用处
若 bug 涉及 SDK 包内部逻辑（非调用方式问题）→ 该 bug 可能不属于本项目，停止流程并通知用户

步骤 3：修复 Bug

确认是本项目前端代码 bug 后，进行修复：

定位根因：根据步骤 2 的分析结果，精确定位出问题的代码位置
制定修复方案：在修改前先向用户简要说明修复思路
实施修复：使用编辑工具修改代码
检查质量：
- 使用 ReadLints 检查修改后的文件是否有 linter 错误
- 确认修复不会引入新问题
记录修复信息（供后续填写 Jira 使用）：
- BUG_CAUSE：bug 产生原因（简明扼要）
- BUG_SOLUTION：bug 解决方案（简明扼要）
- BUG_IMPACT：bug 影响范围（如：影响哪些页面/功能/用户群）

完成修复后，等待用户确认代码无误（用户 keep 所有改动）后再进入步骤 4。

步骤 4：生成 Commit 并提交

用户确认全部代码改动后：

执行 git status 和 git diff 查看变更
生成 commit message，格式：

fix(<模块>): <简短描述>

<ISSUE_KEY>: <bug 标题>
- 原因: <BUG_CAUSE>
- 方案: <BUG_SOLUTION>

提交 commit：

git add <changed_files>
git commit -m "<commit_message>"

步骤 5：合并到 pre 环境

调用 merge-dev-to-pre-or-beta skill，目标分支为 pre。

执行该 skill 的完整流程：

记录当前开发分支并拉取最新
切换到 pre 分支并拉取最新
合并开发分支到 pre 并推送
切回开发分支
同步开发分支到远端

步骤 6：更新 Jira Bug 状态

合并成功后，更新 Jira issue：

6.1 流转状态为「已解决」

先从步骤 1 获取的 transitions 中找到「已解决」/「Resolved」对应的 transitionId。

调用 jira_transition_issue：

CallMcpTool: server=user-Omnibus, toolName=jira_transition_issue
arguments: {
  "issueKey": "<ISSUE_KEY>",
  "transitionId": "<RESOLVED_TRANSITION_ID>",
  "fields": { ... },  // 根据 editmeta 填写必填字段
  "comment": "AI 自动修复并已部署到 pre 环境。\n原因: <BUG_CAUSE>\n方案: <BUG_SOLUTION>\n影响范围: <BUG_IMPACT>"
}

transition 时的 fields 需要根据步骤 1 获取的 editmeta 来构建，常见必填字段：

bug 产生原因（对应 customfield，从 editmeta 中查找字段名包含「原因」的字段）
bug 解决方案（对应 customfield，从 editmeta 中查找字段名包含「方案」或「解决」的字段）
bug 影响范围（对应 customfield，从 editmeta 中查找字段名包含「影响」或「范围」的字段）

如果这些字段是 option 类型，从 allowedValues 中选择最匹配的值。如果是 string 类型，直接填入文本。

6.2 更新 issue 标签

调用 jira_update_issue 为 issue 添加标签 AI解决：

CallMcpTool: server=user-Omnibus, toolName=jira_update_issue
arguments: {
  "issueKey": "<ISSUE_KEY>",
  "fields": {
    "labels": ["AI解决", ...原有labels]
  }
}

注意：labels 是数组，需要保留原有标签并追加 AI解决，不要覆盖。

流程中断处理

| 中断情况 | 处理方式 | |---------|---------| | bug 不属于本项目 | 停止流程，通知用户并说明原因 | | 信息不足无法分析 | 暂停流程，向用户说明需要补充的信息 | | 修复方案不确定 | 向用户说明多种方案，由用户选择后继续 | | 用户未 keep 代码改动 | 等待用户确认后再提交 commit | | 合并冲突 | 尝试解决冲突，如无法自动解决则通知用户手动处理 | | Jira 状态流转失败 | 通知用户手动操作，提供需要填写的信息 |

注意事项

修复代码时以前端代码为主，项目技术栈请根据实际仓库判断（React / React Native / Vue 等）
commit message 使用 Conventional Commits 风格
操作 Jira 前务必先通过 jira_get_issue（expand=editmeta,transitions）获取元数据
更新 labels 时保留原有标签，追加 AI解决
整个流程中保持向用户汇报进度