| name | test-confirmation |
| description | Use when user wants to start a test cycle, record API test results, or generate a test checklist for BestPartner. Triggered by "執行測試", "開始測試", "測試確認表", "API 測試", "回歸測試", "煙霧測試", "test confirmation", "run tests". |
BestPartner 測試確認表產生器
Overview
每次測試週期建立一份帶日期的確認記錄檔。必須基於現有模板 ./test-confirmation-checklist.md，並使用帶日期的命名，不得另行設計格式。
When to Use
- 使用者說「執行測試」、「開始測試」、「建立測試確認表」
- 使用者要記錄本次 API 測試結果
- 進行定期回歸測試前
Process（必須依序執行）
Step 1：詢問 metadata
測試日期與檔名自動取當下時間，不需詢問使用者。
向使用者確認以下項目：
- 測試環境（dev / sit）
- LLM 平台（OpenAI / Ollama / Anthropic / Gemini / Grok / OpenRouter，可多選）
※ 若找不到對應的 LLM 設定資料，請同時提供 llm_setting id
Step 2：建立帶日期時間的新檔案
檔名格式固定：docs/test-confirmations/test-confirmation-YYYYMMDDHHmm.md
例：當下時間為 2026-04-04 14:30 → docs/test-confirmations/test-confirmation-202604041430.md
重要：以 .claude/skills/test-confirmation/test-confirmation-checklist.md 的完整內容為基礎複製，不要自行設計表格格式。
Step 3：填入 metadata
只修改「測試週期資訊」表格：
| 測試日期 | YYYY-MM-DD HH:mm |
| 測試環境 | dev 或 sit |
| LLM 平台 | [平台名稱] |
| LLM Setting ID | [id，若找不到平台資料時填入，否則留空] |
其餘所有模組表格的「狀態」與「備註」欄位保持空白，供測試人員現場填寫。
Step 4：告知使用者
回報：
- 建立的檔案路徑
- 狀態填寫符號說明（✅ / ❌ / ⏭️ / —）
- 提醒測試完成後更新「測試結果摘要」統計表
- 提醒 ❌ 項目需在「問題追蹤區」記錄
Step 5：重新編譯專案（測試前必要步驟）
在 bestpartner-service 目錄執行：
./gradlew clean build -x test -Dquarkus.package.type=uber-jar -Dorg.gradle.daemon=false -Dquarkus.profile=dev
確認編譯成功（BUILD SUCCESSFUL）並產生 jar 檔案。若失敗，立即停止測試並回報錯誤。
⚠️ 若未重新編譯即啟動服務，視同測試流程違規。
Step 6：強制重啟服務（測試前必要步驟）
停止現有服務（port 80），重新啟動並確認服務已正常回應（HTTP 200）後才開始測試。
⚠️ 若未重啟服務即開始測試，視同測試流程違規。
Step 7：逐案執行循環（每個測試案例都必須照此順序）
- 讀入模組檔案：開啟對應的
modules/test-module-{MODULE}.md 檔案（見 checklist 「模組測試清單」章節）
- 執行測試：對該模組每個案例依序執行：
- 準備 curl 指令（根據模組檔案中的 curl 範本）
- 執行 curl 指令，取得 HTTP status code 與 response body
- 立即寫入確認表：附上完整的 curl 記錄和 response（不得使用佔位符、不得省略或截斷）
- 標記狀態（✅ / ❌ / ⏭️）
⚠️ 必須先寫入 curl 記錄，再標記狀態；狀態欄填寫前若無記錄，視同違規。
Step 7.5：模組完成後立即更新測試結果摘要（強制執行，不可延後）
每完成一模組的所有測試案例後，必須立即依 test-confirmation-checklist.md 中的「模組完成檢查清單」逐項勾選，並更新摘要表的統計數字與 Pass 率。
⚠️ 不可等到所有模組測完才統一更新；違反視同測試流程違規。詳細規則與範例見 checklist「模組完成檢查清單」章節。
Step 8：測試完成後關閉服務
所有測試案例執行完畢後，必須強制關閉服務。
執行順序：
- 確認所有測試已記錄至確認表
- 強制停止服務（port 80）
- 確認服務已停止，不再回應請求
⚠️ 測試完成後不得遺留服務在背景執行。
API 維護規則
任何時候 API 發生新增、修改或刪除，必須同時更新 checklist 模板。詳細規則見 api-maintenance.md。
常見錯誤
步驟內 ⚠️ 違規警告為必讀，本表僅列出步驟未涵蓋的概念性錯誤。
| 錯誤 | 正確做法 |
|---|
建立 api-test-checklist.md 固定名稱 | 使用帶日期的 docs/test-confirmations/test-confirmation-YYYYMMDDHHmm.md |
| 自行設計表格格式 | 從 .claude/skills/test-confirmation/test-confirmation-checklist.md 完整複製 |
| 只列出主要 7 個模組 | 必須包含整合測試與安全性測試（共 12 個模組） |
| 先建檔再詢問 metadata | 先詢問 metadata（Step 1），再建立檔案（Step 2） |
| 先標記狀態才記錄 curl | 先執行 curl 並寫入完整記錄，才能標記狀態（Step 7） |
| response body 只記錄摘要或省略 | 必須記錄完整 response body 原始內容，不得截斷（Step 7） |
