Communitygithub.com

リプレイ&レプリカ

既存のアプリ、Webサイト、デバイス、ワークフローの許可された観察を、エビデンス付きの振る舞い仕様、独立した実装ハンドオフ、実行可能な受入シナリオ、およびパリティレポートに変換します。

リプレイ&レプリカ とは?

このスキルは、観察された製品の振る舞いを、クリーンルーム方式の実装ハンドオフパッケージとして形式化するためのワークフローを提供します。観察(許可された操作、アクセシビリティツリー、公開APIなど)を元に、UIやコードを模倣することなく、入力、出力、状態遷移を明確に定義した「振る舞い契約(behavior contract)」を作成します。このスキルは、法律顧問ではなく、ユーザーがエビデンス付きの仕様とパリティテストを構造化するのを支援するツールとして機能します。Claude Code、Cursor、CodexなどのAIエージェントに適しており、フェーズに沿って、スコープ定義、観察の標準化、実装ハンドオフの生成、独立した実装、そして観察とレプリカの振る舞いを比較するリプレイテストを実行します。このプロセスは、ソースコード、ブランディング、秘密情報のコピーを防ぎ、特許、プライバシー、ライセンスに準拠するように設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wangjunyu86/replay-to-replica/tree/HEAD

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

リプレイ&レプリカ は何をしますか?

観察された製品の振る舞いを、実装可能で独立した契約に変換し、同じユーザータスクをリプレイすることで新しい実装を検証します。視覚的またはコードの模倣ではなく、振る舞いの明確さを最適化します。

境界

このスキルは、許可されたブラックボックス観察とクリーンルームスタイルのハンドオフをサポートします。それ自体が法的コンプライアンスを確立するものではありません。ライセンス、規約、特許、プライバシー、および契約上の制限を尊重してください。以下の行為は行わないでください。

  • 認証、支払い、レート制限、暗号化、または技術的制御をバイパスすること。
  • ユーザーがアクセスを許可されていないデータや機能にアクセスすること。
  • ソースコード、逆コンパイルされたコード、プロプライエタリアセット、商標、コピーライティング、隠された識別子、または機密データを実装パッケージにコピーすること。
  • 同じ人物またはエージェントが保護された実装詳細を確認した場合に、厳密な法的クリーンルーム分離を主張すること。

厳密な分離が重要な場合は、作業を分割します。観察役は正規化された振る舞いパッケージを作成し、別の実装役はそのパッケージのみを受け取ります。

必要な結果を選択

必要な結果を明確にしてください。

  • 振る舞いパッケージのみ — 仕様および受入シナリオ。
  • 実装ハンドオフ — 振る舞いパッケージに加え、ビルド可能なタスクとインターフェース。
  • 検証済みレプリカ — 独立した実装に加え、リプレイされたパリティテスト。

ユーザーが実装を要求しない限り、「この製品を分析する」をクローンの構築に拡張しないでください。

以下のコマンドでワーキングパッケージを初期化します。

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 であること。
  • 未解決の推論ルールが開示されていること。
  • 新しい製品に、コピーされた保護アセットやアイデンティティが含まれていないこと。
  • ユーザーが意図された環境でコアジャーニーを実行できること。
  • パリティレポートが検査可能なエビデンスにリンクしていること。

最終レポートでは、スコープ、許可の境界、観察されたカバレッジ、推論、意図的な違い、不一致、未検証の領域、およびテストされた正確な実装アーティファクトを記載する必要があります。

関連スキル