2026年06月28日
CMake と Qt：強力な組み合わせ、実践では一筋縄ではいかない
「コンパイルできる CMake」と「正しい CMake」の間のギャップは、Qt においては他の多くのフレームワークよりも大きいです。CMake は Qt 6.0 から Qt の公式ビルドシステムとなっており、この組み合わせは本当に強力です。適切に設定された Qt CMake プロジェクトは、クロスプラットフォームビルド、インクリメンタル QML コンパイル、C++/QML のシームレスな統合、そしてデプロイ可能なインストールターゲットをサポートします。しかし、そこに到達するには、Qt 6 のマイナーリリースをまたいで急速に進化してきたビルド API を習得する必要があります。そして、この進化こそが、特に古いモデルや小規模なモデルを中心に、大規模言語モデル（LLM）にとって難しい部分となっています。
Qt は独自の CMake コマンドを提供しており、これらは汎用的な CMake の慣例とは異なる固有の引数名、呼び出し規約、セマンティクス要件を持っています。例えば QML モジュールの URI や出力ディレクトリのレイアウトに関するルールは、設定時には強制されませんが、違反するとサイレントなランタイムエラーが発生します。
画像：Claude Code 内で Qt 6 アプリケーションの CMakeLists.txt を解析する qt-project スキル
Qt Project CMake スキルの登場
Qt の AI 搭載開発ツールの一環として、新しい Qt Project スキルは、Qt CMake のベストプラクティスに関する厳選された知識をエージェントの推論コンテキストに組み込むことで、この課題に直接対応します。汎用モデルが最もよく見てきた CMake パターン（多くの場合 Qt 5 のパターン、コミュニティによるワークアラウンド、または存在しない引数）に頼る場面で、このスキルは現代的な Qt 6 CMake プロジェクトをどのように構造化すべきかについて、明確で権威ある指針を提供します。
このスキルは、単一ターゲットのデスクトップアプリケーションから、QML モジュール・共有リソース・プラグインターゲットを含むモジュール式のマルチライブラリプロジェクトまで、プロジェクト設定の全範囲をカバーします。Qt の公式プロジェクトテンプレートおよびドキュメント化されたベストプラクティスから導かれた一貫したルールセットを適用し、出力を生成する前に一般的な誤りの事前チェックを行うことで、LLM がデフォルトで出力しがちなパターンをユーザーに届く前に修正します。
主な機能
Qt 6 コマンドの正確な使用
このスキルは、実行ファイル・ライブラリ・QML モジュール・リソース・プラグインの定義に、常に現在の Qt 6 ビルドコマンドを使用します。Qt 5 プロジェクトファイルのレガシーパターンは、出発点としてではなく、移行対象として扱われます。
適切なプロジェクトセットアップの雛形生成
すべてのビルドファイルには、Qt の標準的なプロジェクト初期化が正しい順序で組み込まれます。具体的には、最初に Qt を検出し、次に標準プロジェクトのデフォルトを適用し、その後に個別のビルドターゲットを宣言します。
画像：GPT-5.3-Codex を使用した GitHub Copilot で qt-project スキルが C++ ライブラリを追加
QML モジュールの統合
すべての QML UI ファイルは、汎用リソースとしてバンドルされることなく、Qt 6 専用の QML モジュールメカニズムを通じて登録されます。
レガシーパターンのクリーンな移行
既存のビルドファイルを編集する際、このスキルはスタイル上の選択（保持されます）と実際のルール違反（短い説明コメントとともに修正されます）を区別します。
ドキュメントに基づくコマンドシグネチャ
より複雑なビルド設定の場合、このスキルはセッション内でライブの Qt ドキュメント（利用可能な場合）を参照し、実際に使用している Qt バージョンの各コマンドが受け付けるオプションを正確に確認します。これが重要な理由は、一部のビルドコマンドは Qt 6 のマイナーリリース間で受け付けるオプションが変更されており、トレーニングデータのみに依存する AI モデルはこのような微妙な差異を誤ってしまうことが多いためです。
制限事項
このスキルは、配布パッケージングやインストーラーの作成、CI/CD パイプラインのセットアップ、Qt の標準プロジェクトデフォルトが提供する範囲を超えたカスタムハードウェアターゲット向けのクロスコンパイル設定はカバーしていません。これらの領域は、プロジェクトによって要件が大きく異なるため、単一のルールセットを一律に適用することができません。
また、このスキルは Qt のレガシービルドフォーマットである qmake には対応していません。プロジェクトで qmake プロジェクトファイルと CMake ビルドファイルの両方が必要な場合、このスキルは両方を生成するのではなく、どちらのビルドシステムをターゲットにするかを確認します。
動作確認済み環境
このスキルは Qt 6.5 以降のプロジェクトで動作します。Claude Code CLI および VS Code 上の GitHub Copilot（Claude Sonnet 4.6 と GPT-5.3 Codex を使用）でのテストが完了しています。
入手方法
このスキルおよびその他の公式 Qt エージェントスキルは、弊社の GitHub リポジトリから入手できます：
https://github.com/TheQtCompanyRnD/agent-skills
または、Claude マーケットプレイスから qt-development プラグインの一部として直接インストールすることもできます（「qt-development」で検索してください）。プラグインを以前にインストール済みの場合は、git リポジトリのクローンを手動でプルして最新のスキルを取得できます。
