重現到複製品 是做什麼的?
將觀察到的產品行為轉化為可實作、獨立表達的合約,然後透過重播相同的使用者任務驗證新實作。專注於行為清晰度,而非視覺或程式碼模仿。
界限
此技能支援授權的黑箱觀察和純室風格交接。它本身不建立法律合規性。尊重授權、條款、專利、隱私和合約限制。請勿:
- 繞過身份驗證、付款、速率限制、加密或技術控制;
- 存取使用者未經授權存取的資料或功能;
- 將原始碼、反編譯程式碼、專有資產、商標、文案、隱藏標識符或機密資料複製到實作包中;
- 當同一人或代理看到了受保護的實作細節時,聲稱嚴格的法律純室隔離。
如果嚴格隔離很重要,請分工:一個觀察角色產生標準化的行為包,而一個獨立的實作角色僅接收該包。
選擇請求的結果
澄清需要哪個結果:
- 僅行為包 — 規格和驗收場景。
- 實作交接 — 行為包加上可建置的任務和介面。
- 經過驗證的複製品 — 獨立實作加上重播的一致性測試。
除非使用者要求實作,否則不要將「分析此產品」擴展為建立克隆。
使用以下指令初始化工作包:
python3 scripts/init_replica_pack.py <output-directory> --product "<observed product>" --replica "<new product>"
階段 1:定義範圍和授權
記錄:
- 授權目標和存取方法;
- 預期的獨立產品和使用者;
- 要保留的行為;
- 要排除的行為、品牌、資料和資產;
- 支援的平台和測試環境;
- 執行時期互動或帳戶操作是否需要新的同意;
- 一致性門檻:精確合約、功能等效或故意變更。
建立基於任務的範圍,而不是「複製整個應用程式」。從最小有價值的旅程開始。
階段 2:以使用者身份觀察
對於每個旅程,擷取:
- 起始狀態和先決條件;
- 使用者操作;
- 立即觀察到的回應;
- 結果狀態和持久化資料;
- 錯誤、延遲、限制和復原路徑;
- 證據路徑和環境;
- 認識標籤:
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(可接受差異); - 已揭露未解決的推斷規則;
- 新產品不包含任何複製的受保護資產或身份;
- 使用者可以在預期環境中執行核心旅程;
- 一致性報告連結到可檢查的證據。
最終報告必須說明範圍、授權邊界、觀察到的覆蓋率、推斷、故意差異、不匹配、未驗證的區域以及經過測試的確切實作工件。