windows-vm

windows-vm スキルの概要

windows-vm は何のためのスキルか

windows-vm スキルは、Docker 上で KVM アクセラレーション付きのヘッドレス Windows 11 VM を作成・管理し、SSH 接続するためのスキルです。RDP を手で操作せずに、実際の Windows 環境が必要なデスクトップ自動化ワークフロー、Windows アプリのセットアップ、エージェント主導のタスクに最適です。

このスキルが向いているケース

windows-vm スキルは、新しい VM を起動する、既存 VM に再接続する、セットアップ失敗後に再起動する、SSH 接続が機能するか確認する、といった作業に向いています。ISO キャッシュを保持しつつ、既知のベースラインから再作成できる、再現性の高い Windows サンドボックスが欲しい場合に特に便利です。

インストール前に重要な点

導入を妨げやすい最大の要因は、ホスト側の対応状況と期待値です。必要なのは Docker、/dev/kvm、sshpass で、この VM は GUI 優先ではなく SSH 優先で扱います。対話的な RDP を主な作業手段にしたい場合や、ハードウェア仮想化を提供できない場合、このスキルはあまり向いていません。

windows-vm スキルの使い方

インストールして、正しいファイルを確認する

npx skills add obra/superpowers-lab --skill windows-vm で windows-vm スキルをインストールします。次に最初に読むべきなのは skills/windows-vm/SKILL.md です。ここには運用フロー、ホスト要件、そして create / start / stop / restart / ssh / status の正確な操作内容がまとまっています。この repo には補助スクリプトや参照用フォルダがないため、SKILL.md が唯一の信頼できる情報源です。

スキルに渡す依頼の作り方

windows-vm usage で良い結果を出すには、曖昧な依頼ではなく、具体的なアクションと目的から始めるのが基本です。たとえば Use windows-vm to create a clean Windows 11 VM and verify SSH login、Use windows-vm to restart the existing VM and check status、Use windows-vm for Desktop Automation and prepare the machine for a browser-based task のように書きます。初回作成なのか、完全な再作成なのか、既存 VM に接続したいだけなのかを明示してください。

ワークフローに必要な入力

安定した windows-vm install と利用のためには、ホストの準備状況、保存先の前提、そして VM を使い捨てとして扱うかどうかが必要です。ISO キャッシュを保持したいのか、VM ディスクを消去したいのか、デフォルトの windows11 コンテナ名とポートを維持したいのかは、はっきり伝えてください。下流のタスクを自動化する場合は、Windows のユーザー名/パスワードの前提条件や、初回起動後に必ず入っていてほしいソフトウェアも指定します。

実用的な使い方のコツ

どの操作を始める前にも、まず前提条件を確認してください。Docker が動いているか、/dev/kvm が存在するか、SSH ベースの手順を成功させたいなら sshpass が入っているかを見ておくべきです。VM がすでにあるなら create は使わず、start / stop / restart / status を使います。デバッグでは、localhost:8006 の Web コンソールや、任意のスクリーンショットツールを使うと、SSH がまだ使えない段階でも VM が起動しているか確認しやすくなります。

windows-vm スキル FAQ

windows-vm は Desktop Automation 専用ですか？

いいえ。windows-vm スキルは Desktop Automation にも役立ちますが、本質的には Docker 上の Windows 11 VM のライフサイクル管理を行うスキルです。Windows 固有の実行と信頼できるリモートアクセスの両方が必要なら相性が良いですが、Windows ワークフローを説明するプロンプトだけが必要なら、もっと簡単な指示で足りる場合もあります。

使うのに GUI は必要ですか？

通常は必要ありません。このスキルはヘッドレス VM への SSH 接続を前提に設計されており、RDP とブラウザコンソールはデバッグ用の補助経路です。そのため、手動のデスクトップ操作よりもエージェントワークフローに向いています。

初心者でも使えますか？

はい。ただし、VM のセットアップ手順を順番に追え、ホストの前提条件を確認するのが苦にならない場合に限ります。windows-vm ガイドが最も力を発揮するのは、新規 VM、再起動済み VM、接続済み VM のどの状態を目指すのかが明確なときです。ライフサイクルの意図がはっきりしているほど、このスキルはうまく動きます。

どんなときに windows-vm を使うべきではありませんか？

マシンで KVM アクセラレーションを提供できない場合、Docker が使えない場合、あるいはフルの対話型 Windows デスクトップを主な操作画面として必要とする場合は、windows-vm を使わないでください。また、再作成したくない、長期運用の、強くカスタマイズされた Windows ホストが必要な場合にも向きません。

windows-vm スキルをどう改善するか

スキルにより明確な初期状態を与える

windows-vm で最も良い結果が出るのは、VM をゼロから作るのか、そのまま再開するのかを最初に明示したときです。この情報がないと、ワークフローが不要な確認に時間を使うことがあります。create from scratch、recreate and wipe storage、start existing Windows VM のように書いて、曖昧さをなくしてください。

具体的な終了条件を伝える

windows-vm usage を改善するうえで最も効くのは、成功判定を定義することです。たとえば create the VM and confirm SSH on localhost:2222、boot Windows and verify the OpenSSH Server service is reachable、stop the container after confirming status is stopped のように指定します。そうすると、このスキルは本当に必要な成果に合わせて最適化できます。

環境の制約は早めに伝える

ホスト側に非標準の Docker パス、制限されたポート、少ない RAM、/dev/kvm の欠如などがあるなら、最初に伝えてください。windows-vm スキルは、プロビジョニングを始める前に実際のホスト制約へ合わせ込めるほど、安定して動きます。Desktop Automation で使う場合は、SSH、RDP、Web コンソールのどれに頼るのかも明示して、セットアップを実際の操作経路に合わせてください。

初回実行のあとに改善する

初回実行が失敗したら、次の windows-vm プロンプトでは失敗箇所を具体的に足してください。ISO のダウンロード、コンテナ起動、SSH ログイン、Windows 起動のタイミングなどです。そうすると、スキルはセットアップ全体を繰り返すのではなく、壊れた段階に集中できます。最も役立つ追記は、いま何が存在していて、何が失敗し、次に何を起こしたいのかを短く整理したものです。