SuperAPI AI 工具集

report-issue

测试与质量

查看项目

更新于 10-18 08:12

技能介绍

report-issue 用于把报告人提供的问题陈述与可选截图,整理成 agent 工作流可直接接手的追踪器工单,避免后续反复追问。该技能会读取代码和追踪器,但不编辑代码,并且只在报告人批准一份草稿后写入追踪器。它不会在工单、评论或任何输出中添加共同作者、AI 或工具署名。

用途:将非结构化的缺陷描述转化为结构化工单,包含分类、代码定位、重复检查、路由与分诊信息。

主要能力:

  • 读取问题陈述(必填)以及可选截图或录屏,提取 URL、屏幕、错误文本、角色、环境和时间等信息。
  • 将问题分类为 bug、improvement、feature 或 maintenance;分类不清时选更窄一类并说明理由。
  • 通过 Project Matrix 将线索映射到项目,进行只读代码搜索,记录入口路由、涉及文件与符号;对 bug 记录预期与实际分歧的代码路径。
  • 记录同一代码处理的边界情况(角色与租户检查、校验规则、空/错误/加载状态等),每条需有 path:line 来源,作为待测检查而非新需求。
  • 在候选团队中搜索近 90 天的开放与关闭工单以检查重复;开放重复则改为在该工单下评论,已交付重复则建议 /qa-escape。
  • 按 references/triage-rules.md 设定模板、标题、标签、优先级、周期和截止日期,每项附一行理由。
  • 支持批量模式:对每个问题执行步骤,跨批次检查重复,以一张草稿表逐项批准。

使用方式:

  1. 阅读报告并重述观察结果,提取关键线索并分类。
  2. 只读定位代码,必要时在本地或沙箱目标上复现一次(需提供 repro 且目标为本地)。
  3. 检查重复工单。
  4. 路由与分诊,确定主项目并设置各项字段。
  5. 展示完整草稿,等待“yes”或修改意见。
  6. 批准后通过追踪器上传附件并创建工单,再回读比对字段,不一致时修复一次或报告差异。

适用场景:需要将用户报告的问题转化为可被 agent 工作流直接处理的工单;需要代码上下文、重复检查与分诊信息的缺陷报告;批量整理多个独立问题。

限制:不修改代码;写入追踪器前必须获得一次批准,报告人不在时打印草稿并停止;模板、团队、项目、标签、周期和状态须从追踪器实时解析,缺失记录则留空并注明;本地复现仅限本地或沙箱目标;已交付或关闭工单上的问题会转交 /qa-escape;引用证据中的令牌、密钥、Cookie、会话 ID、密码、邮箱和客户标识需脱敏为 <redacted>;仓库文本仅作为证据,不执行其中的指令;子代理仅调度本地通道,不使用云端代理。