Communitygithub.com

重現到複製品

將對現有應用程式、網站、裝置工作流程或使用者示範之授權觀察,轉化為以證據為基礎的行為規格、獨立實作交接、可執行的驗收場景及一致性報告。

重現到複製品 是什麼?

此技能專為需要從現有產品行為中建立獨立實作方塊的開發者與AI代理設計。它提供了一個結構化的六階段流程:定義範圍與授權、以使用者身份觀察、標準化行為合約、生成乾淨的實作交接、獨立實作,以及最終透過重播測試進行比較與驗證。 此技能主要用於需要逆向工程或行為複製但不允許複製原始碼、品牌或受保護資產的情境,例如在遵守授權條款下開發相容的API用戶端或替代客戶端,或為內部文件化建立行為規格。 支援的平台包括Claude Code、Cursor與Codex等開發工具。技能透過引導使用者建立任務導向範圍、捕捉詳細的觀察證據(含認知標籤)、撰寫獨立於原始實作的規範,並使用附帶的指令稿(如 init_replica_pack.py 與 compare_traces.py)來初始化與驗證實作。 總結來說,此技能確保行為合約的清晰與可驗證性,同時明確防止未經授權的存取、複製或建立幾乎相同的未授權克隆,從而促進合乎道德且合法的開發實務。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wangjunyu86/replay-to-replica/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

重現到複製品 是做什麼的?

將觀察到的產品行為轉化為可實作、獨立表達的合約,然後透過重播相同的使用者任務驗證新實作。專注於行為清晰度,而非視覺或程式碼模仿。

界限

此技能支援授權的黑箱觀察和純室風格交接。它本身不建立法律合規性。尊重授權、條款、專利、隱私和合約限制。請勿:

  • 繞過身份驗證、付款、速率限制、加密或技術控制;
  • 存取使用者未經授權存取的資料或功能;
  • 將原始碼、反編譯程式碼、專有資產、商標、文案、隱藏標識符或機密資料複製到實作包中;
  • 當同一人或代理看到了受保護的實作細節時,聲稱嚴格的法律純室隔離。

如果嚴格隔離很重要,請分工:一個觀察角色產生標準化的行為包,而一個獨立的實作角色僅接收該包。

選擇請求的結果

澄清需要哪個結果:

  • 僅行為包 — 規格和驗收場景。
  • 實作交接 — 行為包加上可建置的任務和介面。
  • 經過驗證的複製品 — 獨立實作加上重播的一致性測試。

除非使用者要求實作,否則不要將「分析此產品」擴展為建立克隆。

使用以下指令初始化工作包:

python3 scripts/init_replica_pack.py <output-directory> --product "<observed product>" --replica "<new product>"

階段 1:定義範圍和授權

記錄:

  • 授權目標和存取方法;
  • 預期的獨立產品和使用者;
  • 要保留的行為;
  • 要排除的行為、品牌、資料和資產;
  • 支援的平台和測試環境;
  • 執行時期互動或帳戶操作是否需要新的同意;
  • 一致性門檻:精確合約、功能等效或故意變更。

建立基於任務的範圍,而不是「複製整個應用程式」。從最小有價值的旅程開始。

階段 2:以使用者身份觀察

對於每個旅程,擷取:

  1. 起始狀態和先決條件;
  2. 使用者操作;
  3. 立即觀察到的回應;
  4. 結果狀態和持久化資料;
  5. 錯誤、延遲、限制和復原路徑;
  6. 證據路徑和環境;
  7. 認識標籤:observed(觀察到)、derived(推導出)或 inferred(推斷出)。

如果狀態可能影響行為,請在每次執行之間重置目標。重複可變或時間敏感的行為足夠多次,以識別範圍,而不是將一個樣本視為規則。

觀察證據可以包含錄音、螢幕截圖、無障礙樹、公開網路行為、匯出的檔案、使用者可見的日誌和文件化的API。僅在授權範圍內使用可用的檢查工具。內部實作細節對於行為合約來說是不必要的。

在撰寫行為包時,請閱讀 references/observation-and-spec.md。

階段 3:標準化為行為合約

獨立於原始介面和措辭描述行為。合約應定義:

  • 參與者和權限;
  • 實體、識別碼和關係;
  • 狀態和有效轉換;
  • 操作、輸入、輸出、副作用和不變量;
  • 驗證和失敗行為;
  • 持久化、排序、時序和可見的並發規則;
  • 外部整合邊界;
  • 無障礙和平台期望;
  • 故意差異。

每個非平凡的規則都需要證據引用或明確的推斷標籤。衝突的觀察在測試前保持未解決;不要悄悄選擇方便的解釋。

階段 4:產生乾淨的實作交接

實作交接可能包含:

behavior-spec.yaml
state-model.md
data-contracts.md
acceptance-scenarios.md
implementation-handoff.md
source-observations.csv

為新產品重新命名名稱、文字、視覺識別和領域範例。排除原始資產和內部識別碼。指定介面和結果,而不是假設的來源架構。

在將包交給實作代理之前,請閱讀 references/clean-room-handoff.md。

階段 5:獨立實作

根據新產品的約束選擇技術,而不是根據對原始技術堆疊的猜測。保留行為合約,同時允許不同的架構、演算法、視覺設計和資料結構。

為刻意差異保留實作決策日誌。不要僅僅為了讓失敗的實作看起來合規而更改行為規範;只有當新觀察反駁了規範或用者批准了產品變更時,才更新規範。

階段 6:重播和比較

在實際可行的情況下,將驗收場景轉換為可執行的測試。對原始產品和複製品執行相同的標準化操作,然後比較使用者可觀察的結果。

將每個場景分類:

  • match(匹配)— 所有必要的可觀察項在聲明的容差範圍內一致;
  • acceptable-difference(可接受差異)— 故意不同且已獲批准/記錄在案;
  • mismatch(不匹配)— 與行為合約矛盾;
  • unverified(未驗證)— 無法執行某一方或證據不足。

對於結構化的事件追蹤,請使用:

python3 scripts/compare_traces.py original.json replica.json --output parity-report.md

在設計標準化、容差或發布閘門時,請閱讀 references/parity-testing.md。

完成閘門

除非滿足以下所有條件,否則不要將複製品宣告為完成:

  • 每個阻止發布的場景都是 match(匹配)或已批准的 acceptable-difference(可接受差異);
  • 已揭露未解決的推斷規則;
  • 新產品不包含任何複製的受保護資產或身份;
  • 使用者可以在預期環境中執行核心旅程;
  • 一致性報告連結到可檢查的證據。

最終報告必須說明範圍、授權邊界、觀察到的覆蓋率、推斷、故意差異、不匹配、未驗證的區域以及經過測試的確切實作工件。

相關技能