結論：Windows 10ではWSL2＋Ubuntuを使う

このプロジェクトはBash、Git、GNU timeout、Python 3.10以降、PyYAMLを前提としています。README.md また、デプロイ用モジュールがUnix専用のfcntlを読み込むため、Windows標準のPythonではそのまま動作しません。asset_safety.py Pythonの公式ドキュメントでも、fcntlはUnix向けとされています。7

そのため、Git BashとWindows版Pythonを入れるだけでは不十分です。Windows 10上で試す場合は、WSL2のUbuntu内で作業するのが現実的です。ただし、これはソースコードを確認したうえでの案内であり、Windows 10実機での動作確認やインストール実行は行っていません。

1. WSLとUbuntuをインストールする

以下は、WSL2を利用できるWindows 10を想定した手順です。Microsoftの簡易インストール方法を使うには、Windows 10 バージョン2004（ビルド19041）以降が必要です。それより古い場合は手動インストールの手順を確認してください。121015

管理者としてPowerShellを開き、次を実行します。12

wsl --install -d Ubuntu

指示に従って再起動し、Ubuntuを初めて起動したときにLinuxのユーザー名とパスワードを設定します。3

インストール後、PowerShellでWSLのバージョンを確認します。12

wsl --list --verbose

UbuntuのVERSIONが1の場合は、次のコマンドでWSL2に切り替えます。12

wsl --set-version Ubuntu 2

2. Ubuntu内で依存関係を準備する

以降のコマンドは、PowerShellではなくUbuntuのターミナルで実行してください。まず管理者認証を済ませてから、必要なパッケージをインストールします。途中でコマンドが失敗した場合は、先へ進まず原因を確認してください。

sudo -v

timeout 600s sudo -n apt-get update < /dev/null &&
timeout 600s sudo -n env DEBIAN_FRONTEND=noninteractive apt-get install -y git coreutils python3 python3-yaml < /dev/null

プロジェクトが必要とするPythonのバージョンも確認します。

python3 --version

バージョンが3.10未満の場合は、要件を満たすPython環境を用意してから続けてください。

3. リポジトリを取得し、スクリプトを確認する

Ubuntu内で作業用の場所を選び、リポジトリをクローンします。URLはinstall.shに記載されています。

timeout 30s env GIT_TERMINAL_PROMPT=0 git -c core.autocrlf=false -c core.hooksPath=/dev/null clone --no-recurse-submodules --branch main https://github.com/zhaosan2023/dotfiles-bmad-solo.git dotfiles-bmad-solo < /dev/null

クローンが成功したら、リポジトリに移動します。

cd dotfiles-bmad-solo

実行前に、取得したバージョンのinstall.shとbs.shを確認してください。リモートのスクリプトをそのままパイプで実行するのではなく、内容を確認してから進めることが推奨されています。README.md

4. プリフライトとドライランを行う

リポジトリのルートディレクトリで、まず読み取り専用のプリフライトとドライランを実行します。これらのオプションはbs.shでサポートされています。

timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null

プリフライトが成功し、対象が正しいことを確認できた場合に限り、現在のLinuxユーザーのグローバル設定に変更を加えることを理解したうえで、実際のデプロイと状態確認に進みます。README.md

timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null

既存ファイルとの競合、設定の破損、未完了の処理が報告された場合は、状態記録を消したり強制的に上書きしたりせず、先に問題を解消してください。README.md

5. IDEがWSL側で動いているか確認する

VS Codeを使う場合は、Windows版VS CodeとWSL拡張を導入してUbuntuに接続できます。これはMicrosoftが案内しているWSLでの開発方法です。9

一方、WSL内にファイルを配置しただけでは、Windows上のIDEがモード設定を読み込んだことにはなりません。Rooがどの拡張ホストで動作しているか、設定がその環境に反映されているかを別途確認してください。プロジェクト側も、実行時の動作確認を別途行うよう求めています。README.md

Windows版のAntigravity、Gemini、RooなどをWSLの外で動かす場合、上記の手順だけでWindows本体への導入が完了したとは言えません。自動検出の対象はLinuxの保存先を前提としており、Windows本体の設定パスには対応していません。deployment_targets.py

**まとめると、WSL2を利用できるならUbuntu内で導入を試せます。Windowsネイティブ環境だけで使う必要がある場合は、ファイルロック、権限、ディレクトリ同期、設定パスなどへの対応が必要で、現状のコードから完全な導入手順は案内できません。**ファイルの配置が成功しても、IDEで読み込まれたことや権限の確認が済んだことを意味するわけではありません。README.md

結論：Windows 10ではWSL2＋Ubuntuを使う

このプロジェクトはBash、Git、GNU timeout、Python 3.10以降、PyYAMLを前提としています。README.md また、デプロイ用モジュールがUnix専用のfcntlを読み込むため、Windows標準のPythonではそのまま動作しません。asset_safety.py Pythonの公式ドキュメントでも、fcntlはUnix向けとされています。7

そのため、Git BashとWindows版Pythonを入れるだけでは不十分です。Windows 10上で試す場合は、WSL2のUbuntu内で作業するのが現実的です。ただし、これはソースコードを確認したうえでの案内であり、Windows 10実機での動作確認やインストール実行は行っていません。

1. WSLとUbuntuをインストールする

以下は、WSL2を利用できるWindows 10を想定した手順です。Microsoftの簡易インストール方法を使うには、Windows 10 バージョン2004（ビルド19041）以降が必要です。それより古い場合は手動インストールの手順を確認してください。121015

管理者としてPowerShellを開き、次を実行します。12

wsl --install -d Ubuntu

指示に従って再起動し、Ubuntuを初めて起動したときにLinuxのユーザー名とパスワードを設定します。3

インストール後、PowerShellでWSLのバージョンを確認します。12

wsl --list --verbose

UbuntuのVERSIONが1の場合は、次のコマンドでWSL2に切り替えます。12

wsl --set-version Ubuntu 2

2. Ubuntu内で依存関係を準備する

以降のコマンドは、PowerShellではなくUbuntuのターミナルで実行してください。まず管理者認証を済ませてから、必要なパッケージをインストールします。途中でコマンドが失敗した場合は、先へ進まず原因を確認してください。

sudo -v

timeout 600s sudo -n apt-get update < /dev/null &&
timeout 600s sudo -n env DEBIAN_FRONTEND=noninteractive apt-get install -y git coreutils python3 python3-yaml < /dev/null

プロジェクトが必要とするPythonのバージョンも確認します。

python3 --version

バージョンが3.10未満の場合は、要件を満たすPython環境を用意してから続けてください。

3. リポジトリを取得し、スクリプトを確認する

Ubuntu内で作業用の場所を選び、リポジトリをクローンします。URLはinstall.shに記載されています。

timeout 30s env GIT_TERMINAL_PROMPT=0 git -c core.autocrlf=false -c core.hooksPath=/dev/null clone --no-recurse-submodules --branch main https://github.com/zhaosan2023/dotfiles-bmad-solo.git dotfiles-bmad-solo < /dev/null

クローンが成功したら、リポジトリに移動します。

cd dotfiles-bmad-solo

実行前に、取得したバージョンのinstall.shとbs.shを確認してください。リモートのスクリプトをそのままパイプで実行するのではなく、内容を確認してから進めることが推奨されています。README.md

4. プリフライトとドライランを行う

リポジトリのルートディレクトリで、まず読み取り専用のプリフライトとドライランを実行します。これらのオプションはbs.shでサポートされています。

timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null

プリフライトが成功し、対象が正しいことを確認できた場合に限り、現在のLinuxユーザーのグローバル設定に変更を加えることを理解したうえで、実際のデプロイと状態確認に進みます。README.md

timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null

既存ファイルとの競合、設定の破損、未完了の処理が報告された場合は、状態記録を消したり強制的に上書きしたりせず、先に問題を解消してください。README.md

5. IDEがWSL側で動いているか確認する

VS Codeを使う場合は、Windows版VS CodeとWSL拡張を導入してUbuntuに接続できます。これはMicrosoftが案内しているWSLでの開発方法です。9

一方、WSL内にファイルを配置しただけでは、Windows上のIDEがモード設定を読み込んだことにはなりません。Rooがどの拡張ホストで動作しているか、設定がその環境に反映されているかを別途確認してください。プロジェクト側も、実行時の動作確認を別途行うよう求めています。README.md

Windows版のAntigravity、Gemini、RooなどをWSLの外で動かす場合、上記の手順だけでWindows本体への導入が完了したとは言えません。自動検出の対象はLinuxの保存先を前提としており、Windows本体の設定パスには対応していません。deployment_targets.py

**まとめると、WSL2を利用できるならUbuntu内で導入を試せます。Windowsネイティブ環境だけで使う必要がある場合は、ファイルロック、権限、ディレクトリ同期、設定パスなどへの対応が必要で、現状のコードから完全な導入手順は案内できません。**ファイルの配置が成功しても、IDEで読み込まれたことや権限の確認が済んだことを意味するわけではありません。README.md