Xcode Project Analyzer

プロジェクト・ターゲットレベルのビルド非効率性の解決に使用します。ソースの編集だけでは解決しにくい場合に適しています。

コアルール

• デフォルトでは推奨事項を優先する
• プロジェクトファイル、スキーム、またはビルド設定を変更する前に、明示的な承認が必要
• タイミングサマリー、ビルドログ、またはプロジェクト設定の証拠に基づいた測定可能な結果を優先する
• デバッグ専用の問題とリリース専用の問題を区別する

レビュー対象

• スキームのビルド順序およびターゲット依存関係
• ビルド設定ベストプラクティスに照らしたデバッグ・リリースのビルド設定
• スクリプトフェーズおよび依存関係分析設定
• 派生データの消滅または明らかに無効化されたカスタムステップ
• 並列化の機会
• 明示的なモジュール依存関係設定およびモジュールマップの準備状況
• ビルドタイミングサマリーの「Planning Swift module」時間 -- インクリメンタルビルドで支配的な場合、予期しないインプット変更またはマクロ関連の無効化が疑われる
• アセットカタログのコンパイル時間、特に大規模または複数のカタログを持つターゲット
• ビルドタイミングサマリーの ExtractAppIntentsMetadata 時間 -- このフェーズが大幅な時間を消費する場合、xcode-behavior として記録する (コストと影響を報告しますが、Apple による明示的なガイダンスがない限りリポジトリローカルの最適化を提案しない)
• ゼロチェンジビルドのオーバーヘッド -- ノーオペレーションのリビルドが数秒を超える場合、固定コストフェーズ (スクリプト実行、コード署名、検証、CopySwiftLibs) を調査する
• CocoaPods の使用 -- Podfile または Pods.xcodeproj が存在する場合、CocoaPods は非推奨。SPM への移行を推奨し、CocoaPods 固有の最適化は試みない (project-audit-checks.md を参照)
• Task Backtraces (Xcode 16.4+: Scheme Editor > Build > Build Debugging) を使用して、インクリメンタルビルドでタスクが予期せず再実行される理由を診断する

ビルド設定ベストプラクティス監査

すべてのプロジェクト監査には、プロジェクトのデバッグ・リリース設定を build-settings-best-practices.md の推奨値と比較するビルド設定チェックリストを含める必要があります。チェックマーク/クロス表示 ([x]/[ ]) を使用して結果を提示してください。スコープはビルドパフォーマンス専用です。SWIFT_STRICT_CONCURRENCY や SWIFT_UPCOMING_FEATURE_* などの言語マイグレーション設定には対応しないでください。

Apple 由来のチェック

すべての監査でこれらの項目を確認してください:

• ターゲット依存関係が正確で、欠落または膨張していない
• スキームが Dependency Order でビルドされている
• スクリプト実行がインプット・アウトプットを宣言している
• スクリプトが多数のインプット・アウトプットを持つ場合、.xcfilelist ファイルが使用されている
• カスタムフレームワークまたはライブラリがモジュールマップを公開する必要がある場合、DEFINES_MODULE が有効になっている
• モジュールマップの使用に十分な自己完結型ヘッダーである
• モジュールを共有すべきターゲットの明示的なモジュール依存関係設定が一貫している

典型的な勝利例

• デバッグ時にのみ重要なスクリプトをスキップする
• スクリプトガード、または依存関係分析メタデータの欠落を追加する
• スキーム内の意図しないシリアルボトルネックを削除する
• 不要なモジュールバリアントを引き起こすビルド設定を調整する
• 必要以上に広範なリビルドを強制する古いプロジェクト構造を修正する
• ファイルタイムスタンプを変更する (内容は変更しない) linter またはフォーマッターを特定し、サイレントでビルドインプットを無効化してモジュール再計画を強制する
• 大規模なアセットカタログを複数のターゲットの個別リソースバンドルに分割して、コンパイルを並列化する
• Task Backtraces を使用して、不要なインクリメンタル作業をトリガーする正確なインプット変更をピンポイントする

レポート形式

各問題に対して以下を含めてください:

• 証拠
• おそらくのスコープ
• クリーンビルド、インクリメンタルビルド、またはその両方に影響する理由
• 推定される影響
• 承認要件

証拠がパッケージグラフまたはビルドプラグインを指す場合、その SKILL.md を読んで同じプロジェクトコンテキストにそのワークフローを適用し、spm-build-analysis に引き継ぐ。

補足リソース

• 詳細な監査チェックリストについては、references/project-audit-checks.md を参照
• ビルド設定ベストプラクティスについては、references/build-settings-best-practices.md を参照
• 共有推奨形式については、references/recommendation-format.md を参照
• Apple 準拠のソースサマリーについては、references/build-optimization-sources.md を参照