name: issue-report-generator description: 醫療裝置軟體問題報告生成器。根據使用者輸入的缺陷描述自動生成符合規範的問題報告（包含問題現象、復現步驟、環境資訊、嚴重等級、影響分析等），便於提交給開發和測試團隊。觸發詞：生成問題報告、問題報告、缺陷報告、bug 報告、issue report

醫療裝置軟體問題報告生成器

根據使用者輸入的缺陷描述，自動生成符合醫療裝置軟體規範的問題報告。

何時使用

• 使用者報告了軟體缺陷/問題，需要生成正式的問題報告
• 測試人員發現 Bug，需要記錄並提交給開發團隊
• 需要建立符合 Jira/禪道格式的問題單
• 需要評估問題的嚴重等級和影響範圍

處理流程

Step 1: 解析使用者輸入

從使用者描述中提取關鍵資訊： - 問題現象 - 發生場景 - 可能的復現條件 - 涉及的模組/功能

Step 2: 生成結構化模板

使用 scripts/generate_issue_report.py 生成問題報告框架：

scripts/generate_issue_report.py "使用者的問題描述"

指令碼自動判斷嚴重等級： - 高：涉及患者安全、資料丟失、系統崩潰 - 中：功能異常、偶發問題、效能問題 - 低：介面問題、文字錯誤、體驗最佳化

Step 3: 引導使用者補充資訊

來源於7w4.net。

輸出報告後，提示使用者補充缺失欄位： - 軟體/硬體版本號 - 具體復現步驟 - 預期結果 vs 實際結果 - 影響分析

Step 4: 輸出最終報告

生成 Markdown 格式報告，可直接： - 複製到 Jira/禪道 - 傳送郵件給開發團隊 - 歸檔到質量管理系統

問題報告結構

# 🐛 問題報告

## 基本資訊
- 問題標題
- 嚴重等級（高/中/低）
- 報告日期
- 報告人
- 軟體版本
- 硬體版本
- 復現機率

## 問題描述
- 現象
- 復現步驟（1,2,3...）
- 預期結果
- 實際結果

## 影響分析
- 對患者安全的影響
- 對測試結果的影響
- 對使用者體驗的影響

## 附件與備註
- 截圖/日誌位置
- 其他說明

嚴重等級判斷標準

使用示例

使用者輸入：

生成問題報告：試劑倉更換與進核心艙時序衝突，滿載測試時試劑倉 A 耗材用完立即更換會卡住，要等試劑倉 B 判讀完成才能操作

輸出：

# 🐛 問題報告

**報告編號：** ISSUE-20260329-001

## 基本資訊
| 欄位 | 內容 |
|------|------|
| 問題標題 | [待完善] 試劑倉更換與進核心艙時序衝突 |
| 嚴重等級 | 中 |
| 軟體版本 | [待填寫] |
| 復現機率 | [待填寫] |

## 問題描述
**現象：** 滿載測試時，試劑倉 A 耗材用完立即更換會卡住

**復現步驟：**
1. 啟動滿載測試
2. 等待試劑倉 A 耗材用完
3. 立即嘗試更換試劑倉 A
4. 同時核心艙正在判讀結果

**預期結果：** 可以隨時更換耗材
**實際結果：** 更換操作卡住，需等待試劑倉 B 判讀完成

## 影響分析
[待完善]

參考文件

詳見 references/issue-template.md - 完整問題報告模板 詳見 references/severity-guidelines.md - 嚴重等級判斷指南

注意事項

1. 患者安全優先：涉及患者安全的問題自動標記為"高"
2. 可復現性：確保復現步驟清晰、可操作
3. 版本資訊：必須記錄軟體/硬體版本，便於追溯
4. 附件完整：截圖、日誌等證據有助於快速定位問題