windows-vm

windows-vm 技能概覽

windows-vm 的用途

windows-vm 技能可協助你在 Docker 中搭配 KVM 加速，建立、管理並透過 SSH 連線到一台無頭的 Windows 11 VM。它特別適合桌面自動化工作流程、Windows 應用程式安裝設定，以及需要真實 Windows 環境、但又不想手動操作 RDP 的 agent 驅動任務。

什麼情況下適合使用這個技能

當你的工作是啟動一台全新的 VM、重新連回既有 VM、在失敗的設定後重新啟動，或確認 SSH 存取是否正常時，windows-vm 技能就很合適。若你想要一個可重複使用的 Windows 沙箱，且能保留 ISO 快取、也能從已知基準狀態重新建立，這個技能尤其實用。

安裝前最重要的注意事項

最大的導入阻力在於主機支援與使用預期：你需要 Docker、/dev/kvm 和 sshpass，而且這個 VM 的設計是以 SSH 為主，不是以 GUI 為主。如果你的主要工作流程一定要用互動式 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 沒有 helper scripts 或 reference folders，所以 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 container 名稱與埠，請明確說出來。如果你是要自動化後續任務，也要一併說明 Windows 使用者名稱／密碼的預期，以及第一次開機後必須安裝好的軟體。

實用使用建議

在嘗試任何動作前，先確認前置條件：檢查 Docker 是否正常、確認 /dev/kvm 存在，並在預期要用 SSH 步驟前先安裝 sshpass。只有在你真的要走完整佈建流程時才用 create；如果 VM 已經存在，就用 start、stop、restart 或 status。排除問題時，localhost:8006 的 web console 和可選的 screenshot 工具能幫你確認 VM 是否已啟動，即使 SSH 還沒準備好也一樣。

windows-vm 技能常見問答

windows-vm 只適合 Desktop Automation 嗎？

不是。windows-vm 技能當然可用於 Desktop Automation，但它的核心工作其實是管理 Docker 中的 Windows 11 VM 生命週期。如果你的任務需要 Windows 專屬執行環境加上穩定的遠端存取，這個技能很合適；如果你只需要一段提示文字來描述 Windows 工作流程，那更簡單的提示可能就夠了。

使用它一定要有 GUI 嗎？

通常不需要。這個技能是以無頭 VM 的 SSH 存取為核心，RDP 和瀏覽器 console 主要是作為除錯時的備援路徑。也因此，它比起手動桌面操作，更適合 agent 工作流程。

這個技能適合初學者嗎？

可以，前提是你看得懂 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 console，讓設定和控制路徑一致。

第一次執行後再迭代

如果第一次執行失敗，下一次的 windows-vm 提示詞要補上精確的失敗點：是 ISO 下載、container 啟動、SSH 登入，還是 Windows 開機時序。這樣技能就能把焦點放在壞掉的那一段，而不是整套流程重跑一遍。最有用的後續修正通常是簡短更正，加上清楚的現況：現在已經存在什麼、哪裡失敗、下一步應該發生什麼。