repo-scan

name	repo-scan
description	Cross-stack source code asset audit — classifies every file, detects embedded third-party libraries, and delivers actionable four-level verdicts per module with interactive HTML reports.
origin	community

repo-scan

どのエコシステムにも独自の依存関係マネージャーがありますが、C++、Android、iOS、Web を横断して「実際にどれだけのコードが自分のものか、サードパーティは何か、不要なものは何か」を教えてくれるツールはありません。

使用タイミング

• 大規模なレガシーコードベースを引き継ぐ際に、構造的な概要が必要な場合
• 大規模リファクタリングの前に、コア・重複・デッドコードを特定する場合
• パッケージマネージャーで宣言されていない、ソースに直接埋め込まれたサードパーティ依存関係を監査する場合
• モノレポ再編成のための Architecture Decision Records を準備する場合

インストール

# 再現性のためにピン留めされたコミットのみを取得
mkdir -p ~/.claude/skills/repo-scan
git init repo-scan
cd repo-scan
git remote add origin https://github.com/haibindev/repo-scan.git
git fetch --depth 1 origin 2742664
git checkout --detach FETCH_HEAD
cp -r . ~/.claude/skills/repo-scan

エージェントスキルをインストールする前に、ソースコードを確認してください。

コア機能

機能	説明
クロススタックスキャン	C/C++、Java/Android、iOS (OC/Swift)、Web (TS/JS/Vue) を一度にスキャン
ファイル分類	すべてのファイルをプロジェクトコード、サードパーティ、ビルド成果物としてタグ付け
ライブラリ検出	50以上の既知ライブラリ（FFmpeg、Boost、OpenSSL 等）のバージョン抽出付き検出
4段階の判定	Core Asset / Extract & Merge / Rebuild / Deprecate
HTML レポート	ドリルダウンナビゲーション付きのインタラクティブなダークテーマページ
モノレポ対応	サマリー＋サブプロジェクトレポートによる階層スキャン

分析深度レベル

レベル	読み取りファイル数	ユースケース
fast	モジュールあたり1-2	巨大ディレクトリの簡易インベントリ
standard	モジュールあたり2-5	依存関係＋アーキテクチャチェックを含むデフォルト監査
deep	モジュールあたり5-10	スレッドセーフティ、メモリ管理、API 一貫性を追加
full	全ファイル	マージ前の包括的レビュー

仕組み

1. リポジトリ表面の分類: ファイルを列挙し、各ファイルをプロジェクトコード、埋め込みサードパーティコード、ビルド成果物としてタグ付けします。
2. 埋め込みライブラリの検出: ディレクトリ名、ヘッダー、ライセンスファイル、バージョンマーカーを調査し、バンドルされた依存関係と推定バージョンを特定します。
3. モジュールのスコアリング: ファイルをモジュールまたはサブシステムごとにグループ化し、所有権、重複、メンテナンスコストに基づいて4段階の判定のいずれかを割り当てます。
4. 構造的リスクのハイライト: デッドウェイト成果物、重複ラッパー、古くなったベンダーコード、抽出・再構築・廃止すべきモジュールを指摘します。
5. レポートの生成: 簡潔なサマリーと、モジュール別ドリルダウン可能なインタラクティブ HTML 出力を返し、非同期でレビューできるようにします。

例

50,000ファイルの C++ モノレポでの実行結果:

• 本番環境にまだ残っている FFmpeg 2.x（2015年版）を発見
• 同じ SDK ラッパーが3回重複していることを発見
• 636 MB のコミット済み Debug/ipch/obj ビルド成果物を特定
• 分類結果: プロジェクトコード 3 MB vs サードパーティ 596 MB

ベストプラクティス

• 初回監査では standard 深度から始めてください
• 100以上のモジュールがあるモノレポでは fast を使用して簡易インベントリを取得してください
• リファクタリング対象としてフラグが立ったモジュールに対して deep をインクリメンタルに実行してください
• サブプロジェクト間の重複検出のために、クロスモジュール分析を確認してください

リンク

• GitHub Repository