Community程式設計與開發github.com

replicate

透過系統化的參考檢查、實作與測量比較,精確複製設計、介面、應用程式、網站與服務流程。僅在明確要求複製參考、忠實還原設計或補足先前實作遺漏細節時使用。

replicate 是什麼?

這個技能提供了一套嚴謹的實證驅動流程,用於精確複製使用者提供的參考(如截圖、設計稿、現有應用或網站)。它強調在編寫程式碼前先徹底檢查參考,建立詳細的屬性清單(包括佈局、排版、色彩、狀態、行為與動畫),然後選擇適當的工具進行實作。實作後,技能要求進行系統化的比較與校正,使用疊圖或差異分析,並優先修復結構性差異,再處理細節問題。此技能適用於 Claude Code、Cursor 等支援自訂技能的 AI 代理平台,能有效提升複製任務的保真度與效率,特別適合需要嚴格還原設計細節或服務流程的場景。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/janrtvld/skills/tree/HEAD/replicate

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Replicate (複製)

將保真度轉化為證據驅動的實作循環。檢查參考、盤點細節、實作、比較、修正並驗證。令人信服的第一印象不代表完成:保留那些使參考與眾不同的細微關係與行為。

從使用者的參考開始

  1. 從對話中推斷目標、範圍、平台與預期的差異。此技能適用於截圖、設計檔、元件、現有實作、應用程式、網站或服務。當使用者提供靜態設計時,不需要要求互動式的原始來源。
  2. 在撰寫程式碼前,實際檢查參考。優先使用使用者指定的來源;對於行為,使用已安裝的軟體;對於明確的設計規格,使用設計檔;對於渲染後的外觀,使用全解析度圖片。當來源不一致時,記錄差異並套用使用者指定的優先級,而不是默默地混合它們。
  3. 檢查現有的實作與專案指示。保留正常運作的功能與使用者所做的變更。如果任務是修正保真度,則修正現有設計,而不是發明新的方向。
  4. 僅詢問會阻礙有意義進展的遺漏資訊。如果無法取得原始來源,則利用現有證據繼續進行,並說明哪些部分無法驗證。絕不憑空觀察。
  5. 建立一組有邊界的流程或狀態,以及驗收標準。不要將「複製」解釋為授權購買、發布、聯絡他人、複製憑證或更改不相關的服務資料。

在簡化前先檢查

使用 evidence-template.md 建立一個簡潔的參考盤點清單。對於一個小組件,這可能只有幾行;不要將一個小編輯變成一個大型文件專案。

檢查整個參考,然後檢查各個區域。分別記錄觀察到的事實、測量結果、估計值與未知項。不要因為較容易實作,就用熟悉的預設值取代不尋常的細節。

檢查適用的細節:

  • 佈局:對齊、包含關係、網格、邊距、內距、間距、比例、圖層、裁切、安全區域以及固定/黏性元素。
  • 排版:字體系列、粗細、大小、行高、字距、基線、換行、截斷與對齊。文字長度與實際內容是佈局的一部分。
  • 表面:取樣顏色、漸層、透明度、材質、邊框、圓角處理、陰影、圖稿裁切、圖示形狀/粗細與光學對齊。
  • 狀態:選取、聚焦、按下、載入、空值、錯誤、禁用、展開、捲動與鍵盤可見;如有需要,也包含淺色/深色或響應式變體。
  • 行為:點擊區域、導航、返回行為、狀態保留、搜尋範圍、選單、捲動、過度捲動、拖動與中斷手勢。
  • 動畫:觸發條件、延遲、持續時間、緩動/彈簧、移動距離、過衝、淡入淡出、縮放、錨定、中斷與回到靜止。
  • 服務工作流程:輸入/輸出合約、排序、持久化、重試、錯誤、延遲與使用者可見的副作用。僅視覺相似並不能複製一個服務。

對於靜態參考,首先匹配可觀察到的外觀。將未顯示的互動與響應式行為標記為推斷;選擇合理的行為,但不要聲稱已觀察到。對於互動式參考,探索完整的過渡,而不僅僅是它們的端點。包括快速重複輸入以及部分/取消的手勢(如適用)。

為證據選擇工具

使用可用的工具,而不是假設的工具名稱或功能。在使用前,閱讀適用的工具/技能說明。

  • 設計檔:使用相關的設計整合功能來檢查節點、樣式、資源與約束,以及渲染預覽。盡可能匯出實際授權的資源,而不是近似它們。
  • 應用程式:使用 Argent/裝置工具進行操作、截圖、輔助功能框架與可重複的路徑。預設使用連接的實體 USB 手機,再考慮模擬器。必要時套用平台設定/互動技能。
  • 網站:使用可用的瀏覽器工具進行截圖、視口狀態、互動與佈局檢查。測試相關的響應式寬度與輸入模式。
  • 截圖:以全解析度檢查並裁切區域進行分析。當已知裝置比例時,以邏輯單位進行測量;不要將截圖像素與佈局點混淆。
  • 動畫:使用支援的錄製工具捕捉影片,並檢查影格/連拍照片。測量位置相對於時間的關係,包括最終穩定下來的影格。使用錄影來研究動畫,而不是用它來聲稱顯示 FPS(這無法透過錄影確定)。
  • 效能:對於原生應用程式,使用原生分析器/Instruments;對於網頁應用程式,使用瀏覽器效能工具。閱讀相關的分析技能。動畫/UI 潤飾技能可補充參考證據;它們的一般偏好不得覆蓋要求的設計。
  • 服務:使用已記錄的 API、可用的連接器與受控的測試資料來比較可觀察的合約。避免破壞性探測與不必要的付費請求。

當小測量腳本能解決不確定性時,請使用它們。相較於猜測的顏色、字體、間距或彈簧參數,更偏好可重複的取樣。當現有工具已足夠時,不要為了小比較而安裝大型工具鏈。

實作一個完整的切片

  1. 在擴展之前,先複製一個完整的代表性流程或元件,並使用真實內容。選擇一個能演練重要佈局與狀態轉換的流程。
  2. 一致地編碼共用的測量值。保持元件識別、導航狀態與佈局在轉換過程中穩定。
  3. 在符合參考的情況下,使用原生的/平台機制。僅當觀察或測試顯示不匹配時,才使用較低層級的實作。不要僅僅因為看起來像原生,就假設預設的底部工作表、選單或彈簧參數是匹配的。
  4. 保留文字、資源、排序與獨特的視覺細節。除非被要求,否則不要添加參考中沒有的漸層、裝飾、佔位符章節、文字變更或「改進」。
  5. 在匹配外觀的同時,保持功能行為正確。載入、預處理或動畫不應不必要地阻礙一個本來就可以進行的操作。

比較與修正

在每個有意義的切片之後執行此循環:

  1. 將參考與實作置於可比較的狀態:相同的內容、視口/裝置、比例、主題、捲動位置、鍵盤以及相關的資料/播放狀態。
  2. 捕捉兩者。比較整體構圖,然後比較各個區域。必要時使用疊加/差異分析,並檢查實際圖片,而不僅僅是一個分數。保持排除遮罩的明確性,並僅限於真正可變的區域。
  3. 記錄具體的差異、其證據與嚴重性。首先修復最大的結構性差異,然後是排版/表面,最後是動畫與細微的互動細節。如果後續觀察與之矛盾,重新審視結構。
  4. 對於動畫,比較整個轉換過程,包括第一個影格、取消、過衝、安全區域覆蓋範圍以及最終穩定狀態。尋找閃爍、延遲的背景變化、消失的條列、圖示重新縮放以及內容重建。
  5. 在修正後重複受影響的檢查,以及相關的行為回歸測試。一旦測試通過且沒有新的證據證明需要,就不要繼續重複廣泛的測試。

不要將像素差異視為通用的相似度分數。在定量聲明中,明確說明確切的狀態、裝置/視口、閾值與遮罩。匹配一張截圖並不能建立整個產品的同等性。渲染/字體差異可能是合法的限制;辨識它們,而不是將它們隱藏在寬鬆的閾值背後。

如果看起來正確但感覺不對

將動畫設計與執行效能分開。在隨機更改持續時間或彈簧參數之前,先進行分析。

  • 在變更前後,以可比較的觀察開銷,重複執行相同的代表性工作負載。
  • 在時間敏感的量測期間,避免逐影格截圖/輔助功能查詢。當儀器化改變工作負載時,分別捕捉視覺證據。
  • 調查重複的資料轉換、過度的狀態失效、視圖重建、同步 I/O、解碼、佈局工作以及重複的手勢回呼。
  • 更改已證明的瓶頸,然後驗證效能與外觀。保留視圖/快取是以記憶體換取速度:為它們設定界限,並正確處理失效/生命週期。
  • 報告哪些內容被測量及其限制。影片重新取樣不是顯示 FPS;不同的工作負載不是有效的數值基準線。

以證據完成

完成授權的實作與驗證,而不僅僅是審計或計劃(除非使用者只要求研究)。

在宣告工作完成之前:

  • 每個範圍內的驗收標準都有實作與驗證證據,或有一個明確未解決的限制。
  • 重要的靜態狀態已與參考進行比較;重要的轉換(當可觀察時)已進行演練。
  • 功能檢查涵蓋了變更可能破壞的行為。對於重要的流程,使用可重複的路徑;避免僅重新說明簡單樣式程式碼的測試。
  • 已知的預期差異與缺陷和未知項有所區分。
  • 最終報告說明哪些內容被更改、實際測試了哪些內容以及剩餘的差異。連結有用的比較證據;不要聲稱超過已驗證範圍的「像素完美」或「精確行為」。

請注意主機資源限制。在資源受限的機器上序列化繁重的建置/分析。僅關閉為此任務啟動且不再需要的視窗、應用程式、裝置與服務。保留使用者現有的工作與必需的服務。將機密與個人工作階段資料排除在證據與原始碼控制之外。未經授權,請勿刪除參考證據;保留有用的最終捕捉與測量結果。

呼叫範例

  • /replicate 在現有頁面中匹配此截圖。請特別注意排版與間距。
  • /replicate 實作此設計檔,包括其行動裝置變體。保留現有的結帳行為。
  • /replicate 重建此應用程式的播放器與搜尋流程。在連接的手機上比較兩個應用程式。
  • /replicate 目前的實作遺漏了此設計的細節。檢查兩者並完成保真度修正。
  • /replicate 使用我們的後端重現此服務的匯入工作流程,包括進度、重試與失敗狀態。

相關技能