Replicate (複製)
將保真度轉化為證據驅動的實作循環。檢查參考、盤點細節、實作、比較、修正並驗證。令人信服的第一印象不代表完成:保留那些使參考與眾不同的細微關係與行為。
從使用者的參考開始
- 從對話中推斷目標、範圍、平台與預期的差異。此技能適用於截圖、設計檔、元件、現有實作、應用程式、網站或服務。當使用者提供靜態設計時,不需要要求互動式的原始來源。
- 在撰寫程式碼前,實際檢查參考。優先使用使用者指定的來源;對於行為,使用已安裝的軟體;對於明確的設計規格,使用設計檔;對於渲染後的外觀,使用全解析度圖片。當來源不一致時,記錄差異並套用使用者指定的優先級,而不是默默地混合它們。
- 檢查現有的實作與專案指示。保留正常運作的功能與使用者所做的變更。如果任務是修正保真度,則修正現有設計,而不是發明新的方向。
- 僅詢問會阻礙有意義進展的遺漏資訊。如果無法取得原始來源,則利用現有證據繼續進行,並說明哪些部分無法驗證。絕不憑空觀察。
- 建立一組有邊界的流程或狀態,以及驗收標準。不要將「複製」解釋為授權購買、發布、聯絡他人、複製憑證或更改不相關的服務資料。
在簡化前先檢查
使用 evidence-template.md 建立一個簡潔的參考盤點清單。對於一個小組件,這可能只有幾行;不要將一個小編輯變成一個大型文件專案。
檢查整個參考,然後檢查各個區域。分別記錄觀察到的事實、測量結果、估計值與未知項。不要因為較容易實作,就用熟悉的預設值取代不尋常的細節。
檢查適用的細節:
- 佈局:對齊、包含關係、網格、邊距、內距、間距、比例、圖層、裁切、安全區域以及固定/黏性元素。
- 排版:字體系列、粗細、大小、行高、字距、基線、換行、截斷與對齊。文字長度與實際內容是佈局的一部分。
- 表面:取樣顏色、漸層、透明度、材質、邊框、圓角處理、陰影、圖稿裁切、圖示形狀/粗細與光學對齊。
- 狀態:選取、聚焦、按下、載入、空值、錯誤、禁用、展開、捲動與鍵盤可見;如有需要,也包含淺色/深色或響應式變體。
- 行為:點擊區域、導航、返回行為、狀態保留、搜尋範圍、選單、捲動、過度捲動、拖動與中斷手勢。
- 動畫:觸發條件、延遲、持續時間、緩動/彈簧、移動距離、過衝、淡入淡出、縮放、錨定、中斷與回到靜止。
- 服務工作流程:輸入/輸出合約、排序、持久化、重試、錯誤、延遲與使用者可見的副作用。僅視覺相似並不能複製一個服務。
對於靜態參考,首先匹配可觀察到的外觀。將未顯示的互動與響應式行為標記為推斷;選擇合理的行為,但不要聲稱已觀察到。對於互動式參考,探索完整的過渡,而不僅僅是它們的端點。包括快速重複輸入以及部分/取消的手勢(如適用)。
為證據選擇工具
使用可用的工具,而不是假設的工具名稱或功能。在使用前,閱讀適用的工具/技能說明。
- 設計檔:使用相關的設計整合功能來檢查節點、樣式、資源與約束,以及渲染預覽。盡可能匯出實際授權的資源,而不是近似它們。
- 應用程式:使用 Argent/裝置工具進行操作、截圖、輔助功能框架與可重複的路徑。預設使用連接的實體 USB 手機,再考慮模擬器。必要時套用平台設定/互動技能。
- 網站:使用可用的瀏覽器工具進行截圖、視口狀態、互動與佈局檢查。測試相關的響應式寬度與輸入模式。
- 截圖:以全解析度檢查並裁切區域進行分析。當已知裝置比例時,以邏輯單位進行測量;不要將截圖像素與佈局點混淆。
- 動畫:使用支援的錄製工具捕捉影片,並檢查影格/連拍照片。測量位置相對於時間的關係,包括最終穩定下來的影格。使用錄影來研究動畫,而不是用它來聲稱顯示 FPS(這無法透過錄影確定)。
- 效能:對於原生應用程式,使用原生分析器/Instruments;對於網頁應用程式,使用瀏覽器效能工具。閱讀相關的分析技能。動畫/UI 潤飾技能可補充參考證據;它們的一般偏好不得覆蓋要求的設計。
- 服務:使用已記錄的 API、可用的連接器與受控的測試資料來比較可觀察的合約。避免破壞性探測與不必要的付費請求。
當小測量腳本能解決不確定性時,請使用它們。相較於猜測的顏色、字體、間距或彈簧參數,更偏好可重複的取樣。當現有工具已足夠時,不要為了小比較而安裝大型工具鏈。
實作一個完整的切片
- 在擴展之前,先複製一個完整的代表性流程或元件,並使用真實內容。選擇一個能演練重要佈局與狀態轉換的流程。
- 一致地編碼共用的測量值。保持元件識別、導航狀態與佈局在轉換過程中穩定。
- 在符合參考的情況下,使用原生的/平台機制。僅當觀察或測試顯示不匹配時,才使用較低層級的實作。不要僅僅因為看起來像原生,就假設預設的底部工作表、選單或彈簧參數是匹配的。
- 保留文字、資源、排序與獨特的視覺細節。除非被要求,否則不要添加參考中沒有的漸層、裝飾、佔位符章節、文字變更或「改進」。
- 在匹配外觀的同時,保持功能行為正確。載入、預處理或動畫不應不必要地阻礙一個本來就可以進行的操作。
比較與修正
在每個有意義的切片之後執行此循環:
- 將參考與實作置於可比較的狀態:相同的內容、視口/裝置、比例、主題、捲動位置、鍵盤以及相關的資料/播放狀態。
- 捕捉兩者。比較整體構圖,然後比較各個區域。必要時使用疊加/差異分析,並檢查實際圖片,而不僅僅是一個分數。保持排除遮罩的明確性,並僅限於真正可變的區域。
- 記錄具體的差異、其證據與嚴重性。首先修復最大的結構性差異,然後是排版/表面,最後是動畫與細微的互動細節。如果後續觀察與之矛盾,重新審視結構。
- 對於動畫,比較整個轉換過程,包括第一個影格、取消、過衝、安全區域覆蓋範圍以及最終穩定狀態。尋找閃爍、延遲的背景變化、消失的條列、圖示重新縮放以及內容重建。
- 在修正後重複受影響的檢查,以及相關的行為回歸測試。一旦測試通過且沒有新的證據證明需要,就不要繼續重複廣泛的測試。
不要將像素差異視為通用的相似度分數。在定量聲明中,明確說明確切的狀態、裝置/視口、閾值與遮罩。匹配一張截圖並不能建立整個產品的同等性。渲染/字體差異可能是合法的限制;辨識它們,而不是將它們隱藏在寬鬆的閾值背後。
如果看起來正確但感覺不對
將動畫設計與執行效能分開。在隨機更改持續時間或彈簧參數之前,先進行分析。
- 在變更前後,以可比較的觀察開銷,重複執行相同的代表性工作負載。
- 在時間敏感的量測期間,避免逐影格截圖/輔助功能查詢。當儀器化改變工作負載時,分別捕捉視覺證據。
- 調查重複的資料轉換、過度的狀態失效、視圖重建、同步 I/O、解碼、佈局工作以及重複的手勢回呼。
- 更改已證明的瓶頸,然後驗證效能與外觀。保留視圖/快取是以記憶體換取速度:為它們設定界限,並正確處理失效/生命週期。
- 報告哪些內容被測量及其限制。影片重新取樣不是顯示 FPS;不同的工作負載不是有效的數值基準線。
以證據完成
完成授權的實作與驗證,而不僅僅是審計或計劃(除非使用者只要求研究)。
在宣告工作完成之前:
- 每個範圍內的驗收標準都有實作與驗證證據,或有一個明確未解決的限制。
- 重要的靜態狀態已與參考進行比較;重要的轉換(當可觀察時)已進行演練。
- 功能檢查涵蓋了變更可能破壞的行為。對於重要的流程,使用可重複的路徑;避免僅重新說明簡單樣式程式碼的測試。
- 已知的預期差異與缺陷和未知項有所區分。
- 最終報告說明哪些內容被更改、實際測試了哪些內容以及剩餘的差異。連結有用的比較證據;不要聲稱超過已驗證範圍的「像素完美」或「精確行為」。
請注意主機資源限制。在資源受限的機器上序列化繁重的建置/分析。僅關閉為此任務啟動且不再需要的視窗、應用程式、裝置與服務。保留使用者現有的工作與必需的服務。將機密與個人工作階段資料排除在證據與原始碼控制之外。未經授權,請勿刪除參考證據;保留有用的最終捕捉與測量結果。
呼叫範例
/replicate 在現有頁面中匹配此截圖。請特別注意排版與間距。/replicate 實作此設計檔,包括其行動裝置變體。保留現有的結帳行為。/replicate 重建此應用程式的播放器與搜尋流程。在連接的手機上比較兩個應用程式。/replicate 目前的實作遺漏了此設計的細節。檢查兩者並完成保真度修正。/replicate 使用我們的後端重現此服務的匯入工作流程,包括進度、重試與失敗狀態。