Communitygithub.com

WhyskAIカスタムインストーラーメーカー

このリポジトリは、Claude Code、Antigravity、Cursor、Kiroなどのエージェントモデル向けのスキルを示しており、シンプルなReactアプリケーションを、独自のカスタムモダンインストーラーを備えたネイティブWindowsアプリケーションに変換できます。

WhyskAIカスタムインストーラーメーカー とは?

このスキルは、React/Viteのプロダクション向けビルドを、1つのスタンドアロンなカスタマイズ済みWindowsネイティブインストーラー(.exe)に変換するための包括的なツールです。標準のOSウィンドウフレームを排除し、独自の5ステップからなるシネマティックなインストーラーウィザードを提供します。コア機能として、Electron.jsによるウィンドウライフサイクルのインターセプト、Node.jsバックグラウンド層によるシステムアセットのデプロイ(ショートカット作成やWindowsアンインストールエントリの登録など)、そしてReactベースのステートマシンを用いたフロントエンドUIを備えています。アプリケーションロゴはユーザー提供のアセット、またはAIによるコンテキスト取得(アイコンが未提供の場合)によって解決されます。セキュリティガードレールとして、nodeIntegrationは無効化、contextIsolationは有効化され、すべてのバックグラウンド操作はcontextBridgeを経由して安全に実行されます。このスキルは、Claude Code、Cursor、Codex、Antigravityなどのコーディングエージェントが、開発者のReactアプリケーションを迅速にWindowsネイティブ配布可能なパッケージに変換する際に特に有用です。

対応✓Claude Code~Codex CLI✓Cursor✓Antigravity
npx skills add Agent-Draco/WhyskAI-CustomInstaller-Maker

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

🎯 目標

標準的なReact/Viteのプロダクションビルドを、単一のスタンドアロンで高度にカスタマイズされたネイティブWindows .exe インストーラーに変換します。このラッパーは標準のOSウィンドウフレームをバイパスし、決定論的でシネマティックな5ステップのインストーラーウィザードインターフェースを提供します。

🛠️ コアエンジニアリングモジュール

1. ライフサイクルインターセプションとウィンドウスタイリング(electron.js)

以下の厳格なネイティブプロパティを持つ、ハードコードされた固定レイアウトのウィンドウフットプリント($760 \times 480\text{px}$)を初期化します。

  • frame: false(すべてのネイティブOSウィンドウ境界/ボーダーを無効化)
  • resizable: false(寸法を固定)
  • transparent: true(カスタムWebスタイリングのための透過バッキングを有効化)

preload.js を介して、分離された安全な非同期IPC(プロセス間通信)アーキテクチャを公開します。これにより、サンドボックスアクセスの安全クラッシュをトリガーすることなく、バックグラウンドランタイムとReactレンダラーレイヤー間でデータをクリーンに受け渡します。

2. システムアセットデプロイメント(Node.jsバックグラウンドレイヤー)

  • ディレクトリマッピング: fs-extra を使用して、ワークスペースの文字列パスを動的に解析し、安全にターゲットフォルダーを構築します。
  • ショートカットリンク挿入: ユーザーのデスクトップ環境に直接ネイティブの .lnk ショートカットを構築するために、Windows PowerShellコマンドを実行するバックグラウンド子プロセスをトリガーします。
  • OSアプリ一覧レジストリへの登録: ローカルマシンのレジストリインデックスパスに、必要なソフトウェアアプリケーションのテレメトリを直接挿入します。 HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall\[AppName] DisplayName、DisplayIcon、インストールディレクトリターゲット、および運用上のアンインストール文字列フックを適切に設定し、アプリケーションをWindowsのアプリと機能ユーティリティにクリーンにバインドします。

🎨 フロントエンドアーキテクチャとステートマシン(React)

インストーラーインターフェースは、Tailwind CSSを使用して、深みのあるミニマルなスレートブルーのプリミティブ(#0a0f1d、#111827)でスタイル設定された、決定論的な5ステップのReactステートマシンとして実行されます。

  1. ウェルカムオンボーディングフェーズ: ソフトウェアのバージョンと設定フラグを表示する最小限のタイポグラフィヘッダー。
  2. カスタムテーマディレクトリエクスプローラー: 標準の不適合なWindowsネイティブファイルエクスプローラーをバイパスし、WebアプリケーションのDOMコンテキスト内で直接実行されるカスタムフォルダ選択ダイアログモーダル。
  3. ワークスペーストグル: デスクトップショートカットファイルの作成とデプロイを制御する、ステートフルなチェックボックスコンポーネント(デフォルトでON)。
  4. シネマティックプログレススプラッシュフェーズ: 全画面、ボーダーレスレイアウトで、ファイルシステムのコピー実行と同期された正確に3.5秒の線形プログレスアニメーションに合わせた、スムーズなCSSマイクロインタラクションとアニメーションをレンダリング。
  5. 完了選択肢: 標準の終了トリガー、または「アプリケーションを起動」による即時システム実行を提供する二重分岐の終了画面。

🖼️ アプリケーションロゴ解決プロトコル

インストーラーには、高忠実度のグラフィックプリミティブ(icon.ico と透明な logo.png)が必要です。不足しているビジュアルコンポーネントは、以下のフォールバックシーケンスを使用して解決します。

  1. プロトコルA: ユーザー提供のブランディング(高階層): ウィザード設定画面を介してカスタムアセットが提供された場合、ファイルオブジェクトをキャプチャし、寸法を検証し、UIレイヤーにストリーミングし、.ico バリアントを最終的な実行可能ファイルヘッダーメタデータに直接コンパイルします。
  2. プロトコルB: AI駆動のコンテキストフォールバック(ゼロ知識階層): ブランディングが提供されない場合、アプリケーションメタデータ(名前、説明、業種)を解析します。ベクターまたはリポジトリルックアップを実行して、クリーンで幾何学的、ミニマルなオープンソースアイコンを抽出します。 ガードレール: 混沌とした、装飾的な、または文字通りのクリップアートデザインを絶対に禁止します。抽象的な、高品質なベクター構造のみが有効です。

⚠️ 制約とガードレール

  • 相対アセットアドレッシング: ビルド設定内のすべての出力アセットが相対パス(./static/...)を使用するようにします。絶対的なWeb解決参照は、パッケージ化されたファイルシステム内で壊れ、ランタイムに白い画面エラーを引き起こします。
  • セキュリティ分離: nodeIntegration: false と contextIsolation: true を常に有効に保ちます。すべてのバックグラウンドプラットフォーム操作は、contextBridge レイヤーを介して安全に遷移する必要があります。

📝 例

例: package.json へのマニフェストターゲットの挿入

"build": {
  "appId": "com.whyskai.custominstaller",
  "productName": "WhyskAI-CustomInstaller-Maker",
  "win": {
    "target": ["nsis"],
    "icon": "assets/icon.ico"
  },
  "nsis": {
    "oneClick": false,
    "allowToChangeInstallationDirectory": true,
    "installerIcon": "assets/icon.ico",
    "uninstallerIcon": "assets/icon.ico",
    "createDesktopShortcut": true,
    "runAfterFinish": true
  }
}

関連スキル