SuperAPI AI 工具集

triage-issue

编程与开发

查看项目

更新于 10-15 14:28

技能介绍

用途

triage-issue 用于自动分诊缺陷报告和错误信息。它通过搜索 Jira 中的重复问题、识别相似的过往问题,帮助用户创建结构良好的缺陷工单,或为已有问题补充上下文信息。该技能旨在消除手动查重工作,确保缺陷被正确记录并附带相关的历史背景。

主要能力

  • 从错误信息中提取关键要素:错误签名(错误类型、错误码、关键错误文本)、上下文(受影响组件、环境、用户操作)、症状(可观察行为、影响)。
  • 在 Jira 中执行多角度搜索:分别以错误、组件、症状为焦点运行多次 JQL 查询,以捕获使用不同措辞的重复问题。
  • 分析搜索结果并判定重复程度:高置信度重复(>90%)、可能重复(70-90%)、可能相关(40-70%)、可能是新问题(<40%)。
  • 检查修复历史:提取修复人、修复方式、修复时间,并识别是否出现回归。
  • 向用户呈现发现并等待决定,不擅自执行操作。
  • 根据用户选择,向已有问题添加评论,或创建新的 Jira 问题。
  • 创建问题时检查项目可用的问题类型和必填字段。

使用方式

该技能遵循 6 步工作流:

  1. 提取关键信息:分析缺陷报告或错误信息,识别搜索词。
  2. 搜索重复项:使用提取的关键词在 Jira 中执行多次针对性搜索。
  3. 分析搜索结果:评估结果,判断是重复还是新问题。
  4. 向用户呈现发现:展示匹配的问题、相似点、差异点和建议,等待用户决定。
  5. 执行用户决定:向已有问题添加评论,或创建新问题。
  6. 提供总结:确认已执行的操作。

搜索时使用关键术语而非完整错误信息,按创建或更新时间倒序排列以优先查看近期问题,并包含已解决的问题以查找修复历史。

添加评论时,评论结构包含报告人、日期、错误详情、上下文、附加说明。 创建问题时,摘要格式为「[组件] [错误类型] - [简要症状]」,描述结构包含问题描述、错误详情、环境、复现步骤、预期行为、实际行为、用户影响、附加上下文、相关问题。

适用场景

  • 用户需要分诊错误信息、缺陷报告或问题,判断是否为重复并采取相应措施。
  • 需要查找某个错误是否已被报告、由谁修复、如何修复。
  • 需要创建结构规范的缺陷工单,并引用相关历史问题。
  • 需要识别疑似回归问题。

限制

  • 该技能依赖 Jira 和 Atlassian MCP Server 环境,需要提供 cloudId、项目键等信息。
  • 若用户未指定项目,技能会询问应搜索哪个 Jira 项目。
  • 若缺陷报告缺少关键细节(如具体错误信息、系统部分、环境),技能会要求用户补充。
  • 创建问题时若项目有自定义必填字段,技能会要求用户提供相应值。
  • 技能在采取任何操作前必须向用户呈现发现并等待决定。
  • 关于该技能的具体收费、价格、平台支持范围等信息,资料中暂未提供。