build-optimization

ビルドの最適化

ビルドシステムの最適化、コンパイル時間の短縮、キャッシュヒット率の最大化、開発ライフサイクル全体の生産性を高める開発者向けツールの構築に関する専門的なガイダンスです。

このスキルを使う場面

• ビルド時間の遅さを診断し、ボトルネックを特定する
• キャッシュ戦略（ローカル、リモート、分散型）を設定する
• インクリメンタルビルドと並列実行を設定する
• CI/CD パイプラインのパフォーマンスとコストを最適化する
• コード分割やツリーシェイキングを設計、改善する
• CLI、プラグイン、コードジェネレーター、IDE 拡張機能を構築する
• モノレポのツール（Nx、Turborepo、Bazel）を設定する
• 開発者のフィードバックループを短縮する（ホットリロード、ウォッチモード）
• ビルド成果物と再現性を管理する

クイックリファレンス

タスク	参照先
コンパイル、キャッシュ、インクリメンタルビルド、CI/CD の最適化	skills/build-optimization/references/build-systems.md
プラグインシステム、コード生成、リンティング、IDE 統合、モノレポツール	skills/build-optimization/references/developer-tooling.md

主な目標

• 開発ビルドの時間を30秒未満にする
• ウォッチモードでの再ビルド時間を5秒未満にする
• CI でのキャッシュヒット率を90％超にする
• 本番パイプラインで不安定なビルドをゼロにする
• 環境を問わず再現可能なビルドを実現する

ワークフロー

1. パフォーマンス分析

変更を加える前に、現在のビルドをプロファイリングします。

• クリーンビルド、インクリメンタルビルド、ホットリロードの時間を測定する
• ビルド中の CPU、メモリ、I/O をプロファイリングする
• 依存関係グラフを作成し、ボトルネックを特定する
• キャッシュヒット率と無効化のパターンを評価する
• 現在のツール設定を確認し、見落としている最適化を特定する

2. 最適化

プロファイリングデータに基づいて、的を絞った改善を適用します。

• インクリメンタルコンパイルとキャッシュを有効にする
• 利用可能なコア全体で並列実行を設定する
• コード分割とツリーシェイキングを設定する
• モジュール解決とソース変換を最適化する
• CI 向けにリモートまたは分散キャッシュを導入する

3. ツール

迅速なフィードバックループを実現するために、開発者向けツールを構築または設定します。

• ウォッチモードとホットモジュールリプレースメントを設定する
• 分かりやすいエラーメッセージと進捗表示を用意する
• ビルド分析とパフォーマンスダッシュボードを統合する
• フォーマット、リンティング、検証のためのコミット前フックを追加する

4. モニタリング

ビルドの健全性を継続的に追跡します。

• ビルド時間の自動追跡とアラートを設定する
• キャッシュヒット率とバンドルサイズの推移を監視する
• CI でパフォーマンスの低下を検出する
• データに基づいて定期的に見直し、最適化する

よくある間違い

• 先にプロファイリングせずに最適化する
• 一時的な問題を解決せず、キャッシュを無効にする
• インクリメンタルビルドで十分な場合にも、フルビルドを実行する
• 独立したビルドタスクを並列化しない
• ボトルネックとしての I/O（ディスク速度、ネットワーク遅延）を無視する
• 分析せずにバンドルサイズを増大させる
• 開発用と本番用で同じビルド設定を使う