エンジニアの皆さん、こんにちは。現場の最前線でコードと格闘していると、時々「この技術的負債、どこまで広がっているんだ……？」と絶望的な気分になることはありませんか？
大規模プロジェクトになればなるほど、依存関係の海で溺れそうになるのは避けられません。しかし、もし「全リポジトリを数秒で横断し、負債の根源を特定する」武器があったらどうでしょう？
今日は、GitHubが提供する強力な新機能「GitHub Code Search」を使い倒し、技術的負債を根こそぎ刈り取るための、現場直結のハック術を伝授します。
—
1. なぜ「Code Search」なのか？：従来の検索との決定的な違い
これまで、GitHubの検索機能は「インデックスの遅延」や「精度不足」に悩まされてきました。しかし、新しいCode Searchは違います。
- 完全なインデックス化: 全てのブランチ、リポジトリがインデックス化されており、正規表現（Regex）による高度なパターンマッチングが可能です。
- 高速なレスポンス: 数百万行のコードベースから、一瞬で「特定のパターン」を抽出できます。
- コンテキスト重視: 単なる文字列検索ではなく、パスや言語を限定した「構造的な検索」が可能です。
これは単なる検索ツールではありません。「コードベースに対するデバッグツール」なのです。
—
2. まずはここから：Code Searchを使いこなすための「基礎セットアップ」
特別なインストールは不要です。GitHubにログインしていれば使えますが、以下の「検索修飾子」を覚えることが、最強のセットアップです。
- `org:会社名` : 特定の組織内だけに絞る
- `repo:オーナー/リポジトリ名` : 特定のリポジトリに絞る
- `language:typescript` : 言語を指定してノイズを消す
- `path:src/components/` : 特定のディレクトリ以下をターゲットにする
「HelloWorld」的な動作確認:
まずは、全社リポジトリから「古いAPIの呼び出し」を探してみましょう。
org:YourCompany “deprecated_api_call” language:typescript
これで、組織内の全コードから非推奨APIを洗い出せます。これができれば、あとは応用するだけです。
—
3. 現場で震える！技術的負債を爆速特定する3つのハック
ここからが本番です。現場で即戦力となる検索クエリを紹介します。
① 「野良」依存ライブラリの特定（インポート文の追跡）
プロジェクト標準ではない、古いライブラリを使っている箇所を全リポジトリから洗い出します。
org:YourCompany “import . from ‘old-library-name'” language:typescript
- 解説: `import` 文を正規表現でキャプチャします。これにより、誰がいつどこで非推奨ライブラリを使い始めたのか、その残骸を一掃できます。
② セキュリティホールの種を摘む（非推奨な関数呼び出し）
`eval()` や `dangerouslySetInnerHTML` など、セキュリティ的に避けたいコードを全社横断でチェックします。
org:YourCompany /dangerouslySetInnerHTML={.}/ language:javascript
- 解説: 正規表現を使うことで、可変引数を含む複雑なパターンも一網打尽にします。
③ 不要なコメントの残骸・TODOの棚卸し
数年前の「とりあえずの対応」を特定します。
org:YourCompany “TODO: refactor” language:typescript
- 解説: チームが忘れていた「負債の墓場」を可視化することで、リファクタリングの優先順位をデータに基づいて決定できます。
—
4. 達人へのステップ：精度を極める「修飾子の重ね技」
検索精度を上げるコツは、「除外」と「限定」の組み合わせです。
org:YourCompany “axios” -path:node_modules -path:tests
- 解説: `-path` を使うことで、`node_modules` や自動生成されたテストコードを検索対象から外します。これにより、「人間が書いた、修正すべき本質的なコード」だけを浮き彫りにできます。
—
最後に：負債を管理する心構え
技術的負債は、放置すればするほど「システムという名の資産」を食いつぶします。しかし、GitHub Code Searchという強力な武器があれば、負債は「特定できない不安」から「計画的に返済可能なタスク」へと変わります。
まずは今日、あなたのプロジェクトで「最も古いTODO」を検索してみてください。そこから、クリーンな開発環境への第一歩が始まります。
「ツールに操られるな、ツールを操れ」。
皆さんのコードベースが、より美しく、より強固になることを応援しています！また次の技術でお会いしましょう。