visual-regressionlisted

Transitional standalone visual regression guard using before/after screenshot comparison. Two modes: SIT (compare staging vs local dev) or Local (compare git-stashed base vs current changes). No long-lived baselines — captures fresh screenshots each run and deletes after comparison. Config-driven from workspace-config.yaml. Use when: "跑 visual regression", "檢查畫面", "頁面有沒有壞", "visual test", "screenshot test", "畫面測試", "截圖比對", "有沒有跑版", "畫面壞了嗎", "UI 有沒有問題", "check if pages look right", for standalone manual investigation. Engineering / verify-AC Layer C uses scripts/run-visual-snapshot.sh instead.
HsuanYuLee/polaris · ★ 4 · AI & Automation · score 77

Install: claude install-skill HsuanYuLee/polaris

# Visual Regression > Transitional manual guard. Engineering 與 verify-AC 的 native Layer C evidence > authority 是 `scripts/run-visual-snapshot.sh`，不是此 standalone skill。 Before/after screenshot comparison guard。每次執行都抓 fresh before / after screenshots，使用 Playwright diff，分析後刪除 temporary snapshots 與 test results；不維護 long-lived baselines。 ## Contract VR 的測試單位是 domain，不是 repo。頁面由 configured URL paths 定義；不可因「頁面不在目前 repo」而 skip。合法 skip 僅限 config 缺漏、dependency declined、clean local tree、 smart-skip 判斷無 visual impact、fixture 未建立、已知 SSR hang、環境依賴缺失。 VR 在 quality chain 中回答：「既有頁面是否仍 visually intact？」它不取代 Local CI Mirror，也不取代 feature behavior verification。 ## Reference Loading 依執行情境讀取： | Situation | Load | |---|---| | Any VR run | `visual-regression-principles.md`, `visual-regression-preflight-flow.md`, `visual-regression-config.md`, `workspace-config-reader.md` | | Screenshot execution | `visual-regression-capture-flow.md`, `dependency-consent.md` | | Fixtures enabled | `api-contract-guard.md`, `visual-regression-fixture-flow.md`, `epic-folder-structure.md` | | Analysis or JIRA report | `visual-regression-analysis-reporting.md`, `vr-jira-report-template.md`, `workspace-language-policy.md` | | Engineering / verify-AC Layer C | Do not run this skill; use `scripts/run-visual-snapshot.sh` via `engineer-delivery-flow.md` or verify-AC references | JIRA report、Slack summary，或任何 external write body 送出前，必須依 `workspace-language-policy.md` 或 external write gate 驗證語言。 ## Flow 1. 解析 domain