跳到主要内容

缺陷报告生成器

收藏0

把报错堆栈与口述复现整理成标准缺陷报告,含严重级别、复现步骤与初步定位,可直接进工单

让 AI 安装

自由如风最新版本 0.1.0更新于 2026-11-02下载 0 次

SKILL.md

缺陷报告生成器#

把零散的报错信息整理成一份可直接进工单的缺陷报告。纯指令技能:不带脚本、不联网、不写任何文件,产出为结构化文本。

报告结构(按序输出)#

  1. 标题:[模块] 现象 + 触发条件,如 [导出] 选择超过一万行时导出超时;
  2. 环境:系统、版本、账号角色、数据规模;缺什么就标注「未知」,不编造;
  3. 复现步骤:编号列表,每步一个动作加该步的可观察结果;
  4. 期望结果与实际结果:各一句;实际结果附关键报错原文;
  5. 复现概率:必现或偶现,附尝试次数;
  6. 严重级别:
    • S1 主流程不可用且无绕行方案;
    • S2 主流程受损但有绕行方案;
    • S3 次要功能异常;
    • S4 体验问题(错别字、样式);
  7. 初步定位:从堆栈最深的业务代码帧往上游读,指出嫌疑最大的模块与假设,明确标注这是假设而非结论;
  8. 附件建议:还需补充的日志、录屏、数据。

写法规则#

  • 每个复现步骤必须可独立执行,不写「正常操作后」这类模糊描述;
  • 堆栈原文完整保留在附录,不在正文截断转述;
  • 不确定的信息写「未知」,禁止臆造版本号或配置;
  • 一份报告只写一个缺陷;发现多个缺陷拆成多份报告。

自检#

发出前对照:拿到这份报告的人,在不追问的情况下能否在十分钟内复现?不能就继续补信息,而不是让对方来问。

用途与依赖

作者没写,这些是平台读文件后整理的,以文件为准。

使用示例

请求:导出 CSV 的时候点了没反应,然后弹了个 504,日志里有一堆 at com.xxx.export.ExportService.run(ExportService.java:88)……帮我写成工单。

预期

输出一份缺陷报告:标题为「[导出] 数据量大时导出请求超时返回 504」;环境部分按用户提供的内容填写,未提供的系统版本和账号角色标注「未知」;复现步骤编号列出「点击导出」「等待响应」「观察页面提示」,每步都注明该步的可观察结果;期望结果是导出成功并下载文件,实际结果写明 504 报错与页面无响应;复现概率按用户说明填写必现或偶现及尝试次数;严重级别依据是否阻断主流程、有无绕行方案判定;初步定位从堆栈最深的业务代码帧 ExportService.run 向上游读取,指出嫌疑模块并明确标注这是假设;附件建议列出还需补充的服务端日志、请求耗时记录和导出数据规模;堆栈原文完整附在附录。

适用场景
  • 手头只有一段报错堆栈和几句口述,需要整理成正式工单
  • 团队要求缺陷报告格式统一,需要按模板补齐环境、步骤和严重级别
  • 需要在提交工单前判断缺陷严重级别(S1–S4)
  • 需要从堆栈中给出初步的嫌疑模块假设,供后续排查参考
  • 复现步骤写得含糊,需要拆成可以独立执行的编号步骤
  • 发现多个问题,需要拆成多份独立报告
输入
  • 报错堆栈原文
  • 用户口述的复现过程
  • 运行环境和版本信息(系统、版本、账号角色、数据规模)
  • 期望结果与实际结果
  • 复现概率(必现或偶现)及尝试次数
  • 补充日志、录屏或数据等附件信息
输出
  • 结构化的缺陷报告文本,可直接粘贴进工单系统
  • 按「[模块] 现象 + 触发条件」格式生成的标题
  • 环境信息,缺失项标注「未知」
  • 编号形式的可执行复现步骤
  • 期望结果与实际结果,实际结果附关键报错原文
  • 复现概率与 S1–S4 严重级别判定
  • 初步定位假设(明确标注为假设)与附件补充建议
运行环境
未说明
依赖
无