| name | qa-signoff |
| description | Release 上線前的 QA 放行門（go/no-go gate）。彙整各方訊號——測試通過率、未關 P0/P1 bug、回歸結果、security/compliance/a11y/效能/離線各 gate 的 blocker 數、flaky 狀態、跨平台一致性——算出 readiness 分數，套 hard/soft gate 規則產出 go / no-go 決策，並生成可簽核的 sign-off 文件（含風險聲明 + 條件式放行）。當使用者提到「放行 / sign-off / signoff / go no-go / release readiness / 上線檢查 / 出版檢查表 / QA gate / release gate / 可以上線嗎 / 放行決策 / readiness 評分」時觸發。配套：regression-test（前置，產回歸結果）、smoke-test-analyzer（測試分層通過率）、flaky-test-hunter（flaky 不該擋放行）、security-scan / compliance-test / a11y-audit（各 gate 來源）、publish-regression（放行後發報告）。 |
| disable-model-invocation | false |
| allowed-tools | Read, Grep, Glob, Write, Edit, Bash |
| argument-hint | [版本號] [--platform=ios|android|both] [--strict] |
qa-signoff
⚙️ 執行前先讀 modules/config-loader.md。
為什麼需要這個 skill
Release 流程裡：
regression-test 產回歸測試計劃（要測什麼）- 各 skill 跑出各自的 gate 報告（security / compliance / a11y / 效能 / 離線）
publish-regression 發測試報告
但中間最關鍵的「這個版本到底能不能上線？依據什麼？誰簽的？」——這個放行決策沒有 skill 串起來。它通常散在某人腦袋、某個 Slack 訊息、某張手動 checklist。
這是 regression-test → publish-regression 之間缺的最後一塊：把放行從「感覺可以」變成「可量化、可追溯、有簽核」。
→ 本 skill 彙整訊號 → 算 readiness → 套 gate → 產 go/no-go + sign-off 文件。
適用場景
- ✅ 每次 release / hotfix 上線前的最後一道 QA 關
- ✅ 需要可追溯放行紀錄（稽核 / 合規 / 事後檢討）
- ✅ 多人 / 多平台 release，要一份權威的 readiness 真相
- ✅ 想把「上線前檢查」標準化、不靠某個人記得
不適用場景
- ❌ 規劃要測什麼 — 用
regression-test
- ❌ 發測試報告到 dashboard — 用
publish-regression
- ❌ 找出 flaky test — 用
flaky-test-hunter（但本 skill 會引用其結果）
彙整的放行訊號
| 訊號 | 來源 | 預設 gate |
|---|
| 測試通過率 | smoke / regression 結果 | soft（< 門檻扣分） |
| 未關 P0 bug | JIRA | 🔴 hard（>0 直接 no-go） |
| 未關 P1 bug | JIRA | soft（扣分 + 列風險） |
| Security blocker | security-scan | 🔴 hard |
| Compliance blocker | compliance-test | 🔴 hard |
| a11y Critical | a11y-audit | soft（依產業可升 hard） |
| 效能迴歸 | mobile-resource-test | soft |
| 離線韌性 fail（寫丟失/重複） | offline-mode-test | soft（金流類可升 hard） |
| Flaky 比率 | flaky-test-hunter | 參考（不擋放行，flaky ≠ 真失敗） |
| 跨平台一致 | iOS vs Android 結果 | soft |
| 自動化覆蓋 | smoke-test-analyzer | 參考 |
Hard gate vs Soft gate
- Hard gate：任一不過 → 直接 no-go，不看分數（P0 bug / security / compliance blocker）
- Soft gate：扣 readiness 分數 + 列入風險，但可由有權限者條件式放行（conditional go）
護欄：flaky test 永遠不是 hard gate——重跑就過的不穩定測試不該擋上線（交給 flaky-test-hunter quarantine）。
執行流程
Phase 1: 蒐集訊號
ls .claude/compliance/compliance-report.md 2>/dev/null
ls .claude/perf/mobile-resource-report.md 2>/dev/null
ls .claude/offline/offline-resilience-report.md 2>/dev/null
grep -rl "Critical\|Blocker" .claude/ 2>/dev/null
find . -name "*.xml" -path "*test-results*" 2>/dev/null
缺的訊號標「未提供」，不假設通過（保守：未知 = 風險）。
Phase 2: 套 gate 規則 + 算 readiness
hard_gates = [P0_open > 0, security_blocker > 0, compliance_blocker > 0]
if any(hard_gates): decision = NO-GO # 不看分數
readiness = 100
- 每個 soft gate 未達 → 依權重扣分
- P1 open bug 每個 -X
- 測試通過率每低 1% -Y
decision = GO if readiness >= threshold and no hard gate
= CONDITIONAL-GO if 接近門檻且風險可接受
= NO-GO otherwise
Phase 3: 產 sign-off 文件
qa-signoff-{version}.md：
# QA Sign-off · v3.2.0 · 2026-06-02
## 🎯 決策：⚠️ CONDITIONAL GO
Readiness: 84 / 100（門檻 80）
## 🚦 Gate 結果
| Gate | 類型 | 狀態 | 說明 |
|------|------|------|------|
| P0 open bug | 🔴 hard | ✅ 0 | — |
| Security blocker | 🔴 hard | ✅ 0 | semgrep clean |
| Compliance blocker | 🔴 hard | ✅ 0 | GDPR/PCI pass |
| P1 open bug | soft | ⚠️ 2 | PROJ-1234 / PROJ-1240（已列風險） |
| 回歸通過率 | soft | ✅ 98.2% | 218/222 |
| a11y Critical | soft | ⚠️ 1 | 對比度（非阻擋，已開單 P1） |
| 效能迴歸 | soft | ✅ | 冷啟動 +120ms（容忍內） |
| 離線韌性 | soft | ✅ | 8/8 場景 pass |
| Flaky 比率 | 參考 | 1.4% | 4 條 quarantine（不擋放行） |
## ⚠️ 已接受風險（Conditional Go 條件）
- PROJ-1234（P1）：邊緣帳號設定頁 crash — 影響 < 0.5% 用戶，hotfix 排下版
- a11y 對比度：商品價格對比 4.2:1（< 4.5）— 下版修
## 📋 上線後監控項
- [ ] 監控 PROJ-1234 相關 crash 率
- [ ] 觀察冷啟動 p90（已 +120ms）
## ✍️ 簽核
| 角色 | 姓名 | 決定 | 時間 |
|------|------|------|------|
| QA Lead | {待簽} | | |
| Release Owner | {待簽} | | |
## 📎 證據連結
- 回歸報告 · security-scan 報告 · compliance 報告 · 測試 CI run
Phase 4: 通知 + 歸檔
- 發 sign-off 摘要通知（依
config.notifications.enabled_channels 可多管道）：
- 歸檔到
.claude/signoff/（可追溯）
- NO-GO 時：自動列出「要放行還缺什麼」清單（NO-GO 通知一定要發）
Phase 5: 與發布銜接
- GO / CONDITIONAL-GO → 觸發
publish-regression 發布報告
- NO-GO → 擋住，回
bug-report / 各 gate skill 補洞
⚠️ 安全護欄
- ✅ 未提供的訊號視為風險（不假設通過）——報告明確標「未驗證」
- ✅ Flaky 不擋放行（重跑就過 ≠ 真失敗）但要顯示比率供判斷
- ✅ Hard gate 不可被分數蓋過（P0/security/compliance 不過就是 no-go）
- ✅ CONDITIONAL-GO 必須記錄已接受風險 + 監控項 + 簽核人（不可空白放行）
- ❌ 不自動「簽核」——決策可自動算，但簽名一定是人
♿ a11y 必檢（本 skill 專屬）
設定依賴
| 設定 Key | 用途 | 預設 |
|---|
qa_signoff.readiness_threshold | GO 的最低分數 | 80 |
qa_signoff.hard_gates | 硬性放行門（任一不過即 no-go） | p0_bug / security_blocker / compliance_blocker |
qa_signoff.soft_gate_weights | 各 soft gate 扣分權重 | 見預設 |
qa_signoff.signoff_roles | 必須簽核的角色 | QA Lead / Release Owner |
qa_signoff.block_on_flaky | flaky 是否擋放行 | false（建議保持） |
jira.project_key / slack.release_channel_id | 撈 bug / 發通知 | — |
範例
詳見 examples.md
