Communityコーディング&開発github.com

replicate (再現)

設計、インターフェース、アプリ、ウェブサイト、サービスワークフローを、体系的な参照調査、実装、測定比較を通じて再現します。参照の忠実な再現、あるいは以前の実装で見逃された詳細の回復を明示的に依頼された場合に使用します。

replicate (再現) とは?

Replicateスキルは、開発者が指定された参照(スクリーンショット、デザインファイル、コンポーネント、既存の実装、アプリ、ウェブサイト、サービス)を体系的に調査し、忠実に再現するためのエビデンス駆動型の実装ループを提供します。このスキルは、最初の印象的な見た目だけでなく、参照を特徴づける細かな関係性や振る舞いを保持することに重点を置いています。Claude Code、Cursor、Codexなどのプラットフォームで動作し、レイアウト、タイポグラフィ、サーフェス、状態、動作、モーション、サービスワークフローなど、多岐にわたる詳細項目の調査と実装をサポートします。スキルのワークフローは「参照の調査」「証拠に基づく実装」「比較と修正」「証拠による完了確認」のステップで構成され、各ステップで具体的なツールと手法が指示されています。また、外見が正しくても動作が違和感がある場合のパフォーマンス調査手法や、最終的な証拠の報告方法についても詳細にカバーしており、単なるレビューや計画ではなく、実際の実装と検証を完了することを求めます。

対応~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に質問する

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

ドキュメント

replicate (再現) は何をしますか?

忠実性をエビデンス駆動型の実装ループにします。参照を調査し、その詳細を棚卸し、実装し、比較し、修正し、検証します。説得力のある第一印象は完成ではありません。参照を特徴づける小さな関係性や振る舞いを維持してください。

ユーザーの参照から始める

  1. 会話から、対象、範囲、プラットフォーム、意図された差異を推測します。このスキルは、スクリーンショット、デザインファイル、コンポーネント、既存の実装、アプリ、ウェブサイト、サービスに対して機能します。ユーザーが静的デザインを提供した場合、インタラクティブなオリジナルを要求しないでください。
  2. コーディングする前に、実際の参照を調査します。ユーザーが指定したソースを優先し、動作はインストール済みソフトウェア、明示的なデザイン仕様はデザインファイル、レンダリングされた外観はフル解像度の画像を使用します。情報源が矛盾する場合は、その矛盾を記録し、黙って情報を混ぜるのではなく、ユーザーが指定した優先順位を適用します。
  3. 既存の実装とプロジェクトの指示を調査します。動作する機能とユーザーの変更を保持します。タスクが忠実性の修正である場合は、新しい方向性を発明するのではなく、既存のデザインを修正します。
  4. 意味のある進捗を妨げる不足情報についてのみ質問します。オリジナルにアクセスできない場合は、入手可能な証拠で続行し、検証できないことを明記します。観測結果をでっち上げないでください。
  5. 境界のある一連のフローまたは状態と受け入れ基準を確立します。「複製」を、購入、公開、他者への連絡、資格情報のコピー、無関係なサービスデータの変更の許可と解釈しないでください。

単純化する前に調査する

evidence-template.md を使用して、コンパクトな参照棚卸表を作成します。小さなコンポーネントの場合は数行で済みます。小さな編集を大げさなドキュメントプロジェクトにしないでください。

参照全体、次に個々の領域を調査します。観測された事実、測定値、推定値、不明点を別々に記録します。実装が簡単だからといって、珍しい詳細を馴染みのあるデフォルト値に置き換えないでください。

該当する詳細を調査します:

  • レイアウト:配置、包含、グリッド、マージン、パディング、ギャップ、比率、レイヤリング、クリッピング、セーフエリア、固定/スティッキー要素。
  • タイポグラフィ:フォントファミリー、ウェイト、サイズ、行高、トラッキング、ベースライン、折り返し、切り詰め、配置。テキストの長さと実際のコンテンツはレイアウトの一部です。
  • サーフェス:サンプリングされた色、グラデーション、透明度、マテリアル、境界線、角の処理、シャドウ、アートワークのトリミング、アイコンの形状/ウェイト、光学的配置。
  • 状態:選択、フォーカス、押下、ローディング、空、エラー、無効、展開、スクロール、キーボード表示。範囲内のライト/ダークまたはレスポンシブバリアント。
  • 動作:ヒットエリア、ナビゲーション、戻る動作、状態保持、検索範囲、メニュー、スクロール、オーバースクロール、スクラブ、中断されたジェスチャー。
  • モーション:トリガー、遅延、継続時間、イージング/スプリング、移動、オーバーシュート、フェード、スケーリング、アンカリング、中断、静止状態への復帰。
  • サービスワークフロー:入出力契約、順序付け、永続化、リトライ、エラー、レイテンシ、ユーザーに見える副作用。視覚的な類似性だけではサービスを再現できません。

静的参照の場合は、まず観測可能な外観に合わせます。表示されていないインタラクションやレスポンシブ動作は推測としてマークし、観測されたとは主張せずに妥当な動作を選択します。インタラクティブな参照の場合は、終了点だけでなく、完全な遷移を調査します。該当する場合は、高速な繰り返し入力や部分的/キャンセルされたジェスチャーも含めます。

証拠に適したツールを選択する

想定されるツール名や機能ではなく、利用可能なツールを使用します。使用する前に、該当するツール/スキルの説明を読んでください。

  • デザインファイル:該当するデザイン統合機能を使用して、ノード、スタイル、アセット、制約、およびレンダリングプレビューを調査します。可能な場合は、近似するのではなく、実際の許可されたアセットをエクスポートします。
  • アプリ:Argent/デバイスツールを使用して、操作、スクリーンショット、アクセシビリティフレーム、反復可能なルートを実行します。シミュレーターを検討する前に、デフォルトで接続された物理的なUSB電話を使用します。必要に応じて、プラットフォームのセットアップ/インタラクションスキルを適用します。
  • ウェブサイト:利用可能なブラウザツールを使用して、スクリーンショット、ビューポート状態、インタラクション、レイアウト調査を実行します。該当するレスポンシブ幅と入力モードをテストします。
  • スクリーンショット:フル解像度で調査し、分析のために領域を切り抜きます。デバイススケールがわかっている場合は論理単位で測定します。スクリーンショットのピクセルとレイアウトポイントを混同しないでください。
  • モーション:サポートされている録画ツールでビデオをキャプチャし、フレーム/コンタクトシートを調査します。時間に対する位置を測定し、最終的な静止フレームも含めます。録画はモーションの調査に使用し、確立できない表示FPSを主張するために使用しないでください。
  • パフォーマンス:ネイティブアプリにはネイティブプロファイラー/Instrumentsを、ウェブアプリにはブラウザパフォーマンスツールを使用します。関連するプロファイリングスキルを読んでください。アニメーション/UIポリッシュスキルは参照証拠を補完しますが、その一般的な好みが要求されたデザインを優先してはなりません。
  • サービス:文書化されたAPI、利用可能なコネクタ、管理されたテストデータを使用して、観測可能な契約を比較します。破壊的なプローブや不要な有料リクエストは避けてください。

不確実性を解決するために、小さな測定スクリプトを使用します。推測された色、フォント、スペーシング、スプリングよりも、再現可能なサンプリングを優先します。小さな比較のために、既存のツールで十分な場合に大規模なツールチェーンをインストールしないでください。

完全なスライスを実装する

  1. 拡張する前に、実際のコンテンツを使用して、1つの完全な代表的なフローまたはコンポーネントを再現します。重要なレイアウトと状態遷移を実行するものを選択します。
  2. 共有された測定値を一貫してエンコードします。コンポーネントのアイデンティティ、ナビゲーション状態、レイアウトを遷移全体で安定させます。
  3. 参照と一致する場合は、ネイティブ/プラットフォームのメカニズムを使用します。観測またはテストで不一致が示された場合にのみ、より低レベルの実装を使用します。ネイティブに見えるからといって、デフォルトのシート、メニュー、スプリングが一致すると想定しないでください。
  4. テキスト、アセット、順序、特徴的な視覚的詳細を保持します。要求されていない限り、参照にないグラデーション、装飾、プレースホルダーセクション、コピーの変更、「改善」を追加しないでください。
  5. 外観を合わせながら、機能的な動作を正しく保ちます。ローディング、前処理、またはアニメーションが、既に進行可能なアクションを不必要にブロックしてはなりません。

比較して修正する

意味のあるスライスごとにこのループを実行します:

  1. 参照と実装を比較可能な状態にします:同じコンテンツ、ビューポート/デバイス、スケール、テーマ、スクロール位置、キーボード、関連するデータ/再生状態。
  2. 両方をキャプチャします。全体の構成を比較し、次に領域を比較します。必要に応じてオーバーレイ/差分を使用し、スコアだけでなく実際の画像を調査します。除外マスクは明示的にし、真に可変な領域に限定します。
  3. 具体的な不一致、その証拠、重大度を記録します。最初に最大の構造的差異を修正し、次にタイポグラフィ/サーフェス、次にモーションと小さなインタラクションの詳細を修正します。後の観測で矛盾する場合は、構造を再検討します。
  4. モーションについては、最初のフレーム、キャンセル、オーバーシュート、セーフエリアのカバレッジ、最終的な静止を含む遷移全体を比較します。フラッシュ、遅れた背景変更、消えるバー、アイコンのリスケール、コンテンツの再構築がないか確認します。
  5. 修正後、影響を受けるチェックと、関連する動作のリグレッションを繰り返します。新しい証拠がそれを正当化しない限り、一度合格した広範なテストを繰り返し続けないでください。

ピクセルの不一致を普遍的な類似性スコアとして扱わないでください。定量的な主張の背後にある正確な状態、デバイス/ビューポート、しきい値、マスクを明記します。1つのスクリーンショットに一致しても、製品全体のパリティが確立されるわけではありません。レンダリング/フォントの違いは正当な制約である可能性があります。広範なしきい値の背後に隠すのではなく、それらを特定します。

見た目は正しいが、感触がおかしい場合

モーションデザインと実行パフォーマンスを分離します。継続時間やスプリングをランダムに変更する前にプロファイリングします。

  • 変更の前後で、同じ代表的なワークロードを、同等の観測オーバーヘッドで繰り返します。
  • タイミングに敏感な測定中は、フレームごとのスクリーンショット/アクセシビリティクエリを避けます。インストルメンテーションがワークロードを変更する場合は、視覚的証拠を別途キャプチャします。
  • 繰り返されるデータ変換、過剰な状態無効化、ビューの再構築、同期I/O、デコード、レイアウト処理、重複したジェスチャーコールバックを調査します。
  • 実証されたボトルネックを変更し、その後パフォーマンスと外観の両方を検証します。ビュー/キャッシュを保持すると、メモリと速度がトレードオフになります。それらを制限し、無効化とライフサイクルを正しく処理します。
  • 測定されたものとその限界を報告します。ビデオのリサンプリングは表示FPSではありません。異なるワークロードは有効な数値ベースラインではありません。

証拠をもって終了する

ユーザーが調査のみを要求した場合を除き、監査や計画だけでなく、承認された実装と検証を完了します。

作業が完了したと見なす前に:

  • 範囲内のすべての受け入れ基準に、実装と検証の証拠、または明示的な未解決の制限があります。
  • 重要な静的状態が参照と比較され、重要な遷移が観測可能な場合に実行されました。
  • 機能チェックは、変更が壊す可能性のある動作をカバーしています。重要なフローには反復可能なルートを使用します。些細なスタイリングコードを単に言い換えるだけのテストは避けます。
  • 既知の意図的な差異が、欠陥や不明点から区別されています。
  • 最終報告には、何が変更され、実際に何がテストされ、残っている差異が記載されています。有用な比較証拠へのリンクを張ります。検証された範囲を超えて「ピクセルパーフェクト」や「正確な動作」を主張しないでください。

ホストリソースの制限に留意してください。制約のあるマシンでは、負荷の高いビルド/プロファイリングをシリアル化します。このタスクのために起動した、不要になったウィンドウ、アプリ、デバイス、サービスのみを閉じます。既存のユーザーワークと必要なサービスを保持します。秘密情報や個人セッションデータを証拠やソース管理から除外します。許可なく参照証拠を削除しないでください。有用な最終キャプチャと測定値を保持します。

呼び出し例

  • /replicate このスクリーンショットを既存のページに合わせてください。タイポグラフィとスペーシングに注意してください。
  • /replicate このデザインファイルを、モバイルバリアントも含めて実装してください。既存のチェックアウト動作を保持してください。
  • /replicate このアプリのプレイヤーと検索フローを再現してください。接続された電話で両方のアプリを比較してください。
  • /replicate 現在の実装は、このデザインの詳細を見逃しています。両方を調査し、忠実性パスを完了してください。
  • /replicate このサービスのインポートワークフローを、進捗、リトライ、失敗状態を含めて、当社のバックエンドで再現してください。

関連スキル