Windows 安裝說明 (基礎版)

安裝 Spec Kit 所需的工具與環境

如果你是 Windows 用戶，建議手動安裝以下軟體：

安裝 PowerShell v7.5 版本

因為 Windows 內建的 PowerShell 是 v5.1 版，這個版本問題很多，會導致 AI Coding 工具生成的指令碼無法執行，但是用 v7.5 以上版本就會順利很多！
到 Microsoft Store 加裝 Windows Terminal 工具

這個是一個終端機介面，可以讓你更好的執行上述的 AI Coding Agent 工具。
第一次安裝與使用 PowerShell 的人，請在啟動 PowerShell 的時候，務必一定要先執行以下命令

開啟 Windows Terminal 終端機視窗，或者按下 Win+R 開啟「執行」視窗，輸入 wt 就可以開啟視窗，然後依序複製貼上以下指令：
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
```
執行下去可以讓你這輩子多活個幾分鐘，可以在日後少很多問題。

安裝一些必備工具

在 Windows 至少還需要安裝 git、uv、Node.js 工具。

請繼續在 Windows Terminal 終端機視窗，依序複製貼上以下指令：

# 安裝 Scoop 套件管理器
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

# 安裝 git 與 uv 與 nodejs
scoop install git uv nodejs

# 安裝搜尋文字檔案的利器 ripgrep
scoop install ripgrep

# 更新 uv 的 PATH 環境變數
uv tool update-shell

# 重新啟動檔案總管，讓環境變數生效
Stop-Process -Name explorer -Force; Start-Process explorer

請關閉目前的 Windows Terminal 終端機視窗。

安裝 AI Coding 工具 (請自由選擇一套或兩套)

開啟 Windows Terminal 終端機視窗，或者按下 Win+R 開啟「執行」視窗，輸入 wt 就可以開啟視窗，然後依序複製貼上以下指令：
```
# 安裝 Copilot CLI
npm install -g @github/copilot

# 安裝 Claude Code
npm install -g @anthropic-ai/claude-code
```
安裝 Spec Kit 的 Specify CLI 工具

你可以接續之前的 Windows Terminal 終端機視窗，依序複製貼上以下指令：
```
# 安裝 Spec Kit 的 Specify CLI 命令列工具
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# 檢查 Spec Kit 需要的工具支援
specify check
```
你至少需要看到 Git version control 是綠燈，還有 GitHub Copilot 或 Claude Code 或任何一套 AI Coding 工具是綠燈，環境就差不多設定完畢！

💡 關於 GitHub Copilot CLI 或 Claude Code 的使用，各位學員可能要自行學習了！