跨平台開發環境快速安裝工具
一鍵安裝常用的開發工具，包括 NVM、Node.js、Git、AI CLI 工具、UV、Spec Kit、OpenSpec 和 VSCode。
執行 npx prespec 需要先安裝 Node.js 18.0.0 或更高版本。
如果 npx 指令失敗，請先安裝 Node.js：
-
macOS / Linux：
# 使用官方安裝程式 # 下載：https://nodejs.org/
-
Windows：
# 下載並安裝 Node.js # 下載：https://nodejs.org/
安裝完成後，重新開啟終端機即可使用 npx 指令。
# 1. 執行安裝程式
npx prespec
# 2. 如有需要，重新開啟終端機（程式會提示）
# 3. 開始使用！
copilot # 啟動 GitHub Copilot CLI
agy # 啟動 Antigravity CLI
claude # 啟動 Claude Code CLI
specify # 使用 Spec Kit
openspec # 使用 OpenSpec就這麼簡單！ 程式會自動：
- ✅ 檢測已安裝的工具
- ✅ 引導您完成互動式安裝
- ✅ 設定 Git 使用者資訊
- ✅ 提供詳細的使用說明
💡 提示：如果您還沒有 Node.js，prespec 會幫您安裝 NVM 和 Node.js！但首次執行需要先有一個 Node.js 來執行安裝程式本身。
- 🚀 一鍵安裝 - 透過簡單的指令快速設定開發環境
- 💻 跨平台支援 - 支援 macOS、Linux 和 Windows
- 🔍 智慧檢測 - 自動檢查已安裝的工具，避免重複安裝
- 🔄 更新檢查 - 偵測已安裝的 npm 系工具是否有新版本，並詢問是否更新
- 🎯 互動式設定 - 友善的互動介面，輕鬆完成設定
- ⚙️ 彈性配置 - 可選擇要安裝的工具和版本
- NVM - Node Version Manager
- Node.js - JavaScript 執行環境（透過 NVM 安裝，支援 LTS 或自訂版本）
- Git - 版本控制系統（含使用者設定）
- AI CLI 工具（多選）：
- GitHub Copilot CLI - GitHub 的 AI 程式輔助工具（預設安裝）
- Claude Code CLI - Anthropic Claude 的終端機介面
- Antigravity CLI - Google 的終端機 AI 代理（Gemini CLI 官方接班，指令
agy，預設安裝） - OpenAI Codex CLI - OpenAI 的程式輔助工具（預設安裝）
- UV - 快速的 Python 套件管理器（自動管理 Python 版本）
- Spec Kit - GitHub 的規格驅動開發工具（Specify CLI）
- OpenSpec - 規格驅動開發工具（與 Spec Kit 並列可選）
- VSCode - 強大的程式碼編輯器（可選）
使用 npx 直接執行（不需要安裝）：
npx prespec執行後，程式會：
- 檢測階段 - 顯示目前已安裝的工具狀態
- 確認安裝 - 詢問是否繼續安裝流程
- 互動式安裝 - 依序安裝各項工具：
- 詢問是否安裝 NVM
- 選擇 Node.js 版本（LTS 或自訂）
- 設定 Git 使用者資訊
- 多選 AI CLI 工具（預設選中 Copilot、Antigravity 和 Codex）
- 安裝 UV、Spec Kit 和 OpenSpec（UV 安裝後立即可用，無需重開終端機）
- 詢問是否安裝 VSCode
- 更新檢查 - 檢查已安裝的 npm 系工具（Copilot、Codex、OpenSpec）是否有新版本，若有則詢問是否更新
- 完成提示 - 顯示安裝結果和後續步驟，包含詳細的使用說明
- 作業系統：macOS、Linux 或 Windows
- Node.js：18.0.0 或更高版本（用於執行安裝程式）
- 網路連線：需要網路來下載工具
所有工具都可以自動安裝，無需額外設定。
- PowerShell：建議使用 PowerShell 7（pwsh），會自動檢測並提示升級
- NVM：會自動下載並安裝 nvm-windows
- 其他工具：可自動安裝
- VSCode：可自動下載並安裝（需使用者同意）
提示：
- 如果 PowerShell 安裝時間過長，可能需要以系統管理員身份執行終端機
- 如果安裝完 PowerShell 7 後仍顯示未安裝，請用
pwsh指令重新開啟終端機
與 Linux 相同，所有工具都可以自動安裝。
如果安裝了 NVM，需要重新載入 shell 或重新開啟終端機：
# bash/zsh
source ~/.nvm/nvm.sh
# 或直接重新開啟終端機-
啟動：
copilot
-
首次使用：
/login # 登入 GitHub /model # 選擇模型（建議選 Haiku，更快速且省 token）
-
常用指令：
/help/new/clear/exit
系統需求：Node.js v22+、npm v10+、有效的 GitHub Copilot 訂閱
claude # 啟動後依照指示登入 Anthropic 帳號agy # 啟動後會開啟瀏覽器用 Google 帳號認證
⚠️ 舊版 Gemini CLI（@google/gemini-cli）將於 2026/6/18 停止為免費／個人帳號提供服務，個人使用者請改用 Antigravity CLI。
codex # 啟動後依照指示登入 ChatGPT 帳號-
初始化專案：
specify init <project-name> # 建立新專案 specify init . --here # 在當前目錄初始化
-
在 AI 助手中依序使用：
/speckit.constitution- 建立專案治理原則/speckit.specify- 定義需求和使用者故事/speckit.plan- 建立技術實作計劃/speckit.tasks- 產生可執行任務清單/speckit.implement- 執行所有任務完成開發
更多資訊請參考：Spec Kit 文件
-
初始化專案：
openspec init
-
在 AI 助手中使用：
/opsx:propose- 提出需求變更/opsx:apply- 套用規格到程式碼
更多資訊請參考：OpenSpec 文件
檢查各工具是否正確安裝：
node --version
git --version
copilot --version # 或 claude, agy, codex（視安裝的工具而定）
uv --version
specify --version
openspec --version
code --version # 如果安裝了 VSCodeA: 不一定。程式會詢問您是否要安裝 NVM。如果您只需要一個 Node.js 版本，可以跳過 NVM 安裝。
A: 程式會顯示錯誤訊息和手動安裝的指令。您可以按照提示手動安裝失敗的工具。
A: 可以！程式會檢查已安裝的工具並自動跳過。AI CLI 工具支援多選，您可以選擇要安裝的工具。
A: 請用 pwsh 指令重新開啟終端機。PowerShell 7 安裝後需要用 pwsh 來啟動，而非舊的 powershell 指令。
A: 不需要！程式會自動更新當前 session 的 PATH，安裝完 UV 後可以立即繼續安裝 Spec Kit。
# 安裝相依套件
npm install
# 執行程式
npm startprespec/
├── bin/
│ └── cli.js # CLI 入口點
├── src/
│ ├── index.js # 主程式邏輯
│ ├── utils/
│ │ ├── platform.js # 平台檢測工具
│ │ ├── check.js # 工具檢查功能
│ │ └── prompt.js # 使用者互動介面
│ └── installers/
│ ├── nvm.js # NVM 安裝器
│ ├── git.js # Git 配置器
│ ├── powershell.js # PowerShell 升級器
│ ├── copilot.js # GitHub Copilot CLI 安裝器
│ ├── claude-code.js # Claude Code CLI 安裝器
│ ├── antigravity-cli.js # Antigravity CLI 安裝器（agy）
│ ├── codex-cli.js # OpenAI Codex CLI 安裝器
│ ├── uv.js # UV 安裝器
│ ├── speckit.js # Spec Kit 安裝器
│ ├── openspec.js # OpenSpec 安裝器
│ └── vscode.js # VSCode 安裝器
└── package.json
MIT License
- NVM
- nvm-windows
- PowerShell 7
- GitHub Copilot CLI
- Claude Code CLI
- Antigravity CLI
- OpenAI Codex CLI
- UV
- Spec Kit
- OpenSpec
- VSCode
享受您的開發環境！🚀