doncheli-visual-test

doncheli-visual-test 是一項專門為開發人員和 QA 工程師設計的視覺回歸測試工具，旨在 Don Cheli SDD 框架內提供嚴格的 UI 驗證。它作為前端介面的品質閘門，確保視覺元素在部署週期中保持一致。透過截取當前 UI 狀態並與驗證過的基準影像進行比較，該工具能自動檢測手動測試常忽略的像素級偏差。此代理程式特別適用於識別佈局位移、字型渲染異常、色彩主題不匹配以及元件定位失效等問題，這些在處理 React 或 Vue 等複雜的基於元件的架構時十分常見。

• 自動檢測並配置測試工具，包括 Playwright、Cypress、Percy、Chromatic 和 Storybook。

• 生成詳細的視覺差異報告，按百分比和嚴重程度（阻塞、警告、資訊）量化變更。

• 提供安全的基準批准工作流程，在將新快照納入儲存庫之前需明確的人工確認。

• 執行局部像素級分析，區分顯著的回歸問題與輕微的抗鋸齒瑕疵。

• 直接與 Don Cheli 執行時期整合，將狀態報告儲存至 .dc/visual-test-report 目錄，以利於 CI/CD 稽核軌跡。

• 使用提到 'visual test'（視覺測試）、'screenshot'（截圖）、'UI regression'（UI 回歸）、'pixel diff'（像素差異）或 'visual snapshot'（視覺快照）的自然語言指令來觸發此技能。

• 系統要求儲存目錄中必須存在基準影像；若缺失，首次成功執行時會自動生成。

• 請務必檢閱 .dc/ 目錄下生成的 Markdown 報告，在人工批准前確認報告的佈局位移或色彩變更是預期的更新。

• 代理程式根據預定義的閾值系統分類錯誤：大於 5% 的差異被視為阻塞，而微小差異則記錄為資訊，讓團隊能優先處理實際的回歸問題而非雜訊。

• 此工具旨在防止自動批准新設計，確保您的團隊將這些變更視為 SDD 審查階段的一部分，以維持一致性。