インストール
uv tool install 'git+https://github.com/00200200/[email protected]'Repro Lens は、ML・コーディング agent 向けの再現性チェックツールです。コード内の再現リスクをスキャンし、実験を再生（リプレイ）して変更前後の出力を比較します。ML コードを変更した後に実験結果が壊れていないか確認したい場合、これが中心的な用途です。静的チェックには Python 3.11+ と Git のみが必要で、ML 依存や API キーは不要ですが、実験のリプレイにはその実験固有の依存関係が必要で、必ずユーザーが明示的にトリガーする必要があります。
こんな人に向いています
- コード変更の前後で実験の再現性を検証したい ML・リサーチエンジニア、および coding agent に再現性監査フローを設定したいチーム。
- 静的スキャンだけを行いたいユーザー：ML 依存も API キーも不要で、スキャン対象のコードはインポート実行されず、ファイル位置付きの静的検出結果が出力されます。
- 向いていないケース：Git 環境がない場合、どのインストール方法も使えません。Python が 3.11 未満の場合、静的チェッカーは動作しません。上記以外のシステム前提についてはソース資料に記載がなく、Windows などの対応可否も公式には明示されていません。
- 証拠に書かれていないことは推測しないこと：対応するテキスト言語やコード言語、利用可能な agent クライアントについても宣言されていません。
3 分で最初の試行を完了する
前提：マシンに Python 3.11+、Git、uv がインストール済みであること。推奨されるメインパスは、uv を使って公式リポジトリから固定バージョンをインストールする方法です：
uv tool install 'git+https://github.com/00200200/[email protected]'
代替方法は、仮想環境で pip を使って同じ git URL からインストールする方法です（こちらも Git が必要）。これはあくまで副次的な選択肢であり、別の主要な入口にはなりません。
インストール後、まず低リスクで読み取り専用の静的チェックを行います。プロジェクト内で agent やターミナルに「repro-lens check を使ってこのファイルに既知の再現性リスクがないか確認して」というタスクを依頼します。対応するコア操作は check です。これはファイル位置付きの静的検出結果を返し、スキャン対象コードは決してインポートされません。成功のサインは、出力にファイル位置付きの検出結果が列挙されることです（結論が「リスクなし」でも実行は成功しています）。
注意：check は診断操作であり、これはスキャン対象コードをインポートしないという意味にすぎません。ファイルの読み書き、コマンド実行、ネットワークアクセスを行うかどうかは、ソース資料には記載がなく確認できません。実験リプレイ（verify、2 回の実行で宣言された出力が一致することが要件）は実際に実験を実行する副作用のある操作であり、最初の試行では使わないでください。使う場合は、実験の依存関係が揃っていることを先に確認し、トリガー前に明確に確認してください。
使用例
例 1：学習スクリプト変更前の静的監査。agent に「学習スクリプトに対して repro-lens check を実行して」と依頼します。ツールは check 操作を実行し、静的検出結果とファイル位置を返します。あなたのコードはインポートされません。これをもとに、変更が既知の再現性リスクを持ち込んでいないかを判断できます。ソース資料にない詳細（具体的なルール一覧など）は提供されていないため、確認できるのは「位置付きの検出結果が得られた」ことまでです。
例 2：修正後の出力比較。前提として、変更前に公式ワークフローでレポートを保存済みであること。agent に「repro-lens の verify で実験をリプレイし、compare で保存済みの 2 つのレポートを比較して」と依頼します。verify は 2 回の実行で宣言された出力が完全に一致することを要求し、compare は保存済みレポートを diff します。期待される結果：verify の合格は出力が宣言と一致したことを示し、compare はレポートの差分を提示します。リプレイには実験固有の依存関係が必要で、明示的なコマンドです。ツールが自動でリプレイすることはありません。
使用の境界
- ファイルとコマンドへのアクセス：
checkはスキャン対象コードをインポートしません。verifyは実験を実行します（依存関係が必要）。リプレイは常に明示的なコマンドであり、pre-commit フック（リポジトリ repro-lens、rev v0.3.0、id repro-lens）はコードとプロジェクトポリシーのスクリーニングのみを行い、自動ではリプレイしません。ネットワークアクセスの有無は公式には明示されていません。 - 確認ポイント：実験を実行するあらゆる操作（verify）は、トリガー前に実験構成と副作用を確認してください。
- インストールの違い：推奨は uv による固定バージョン v0.3.0 のインストール。仮想環境での pip インストールは公式が示す代替方法です。マーケットプレイスやその他のプラットフォームでのインストール方法についてソース資料は言及していないため、想定しないでください。
- agent 統合：リポジトリ内の skills/reproducibility/SKILL.md により、既存の coding agent に監査や許可された修正を案内できます。そのランチャーは CLI と同じエンジンを呼び出します。リポジトリ一式は Codex プラグイン（.codex-plugin/plugin.json を含む）でもあります。それ以外に、どの agent クライアントをサポートするかは公式に列挙されていません。
- 未確認の重要情報：ネットワーク挙動、対応コード言語の範囲、
check/compareの読み書きの境界については公式の説明がなく、使用前にリポジトリのドキュメントを参照してください。