vercel

Vercel 技能為 Web 專案的部署生命週期提供了完善的命令列介面，適合開發者與 DevOps 工程師在 AI 輔助工作流程中使用。此工具銜接了本地開發環境與 Vercel 雲端平台，透過自然語言或指令直接處理儲存庫連結、環境變數注入與網域管理。透過此技能，AI Agent 可直接在開發環境或代理工作空間內執行 Vercel 基礎設施管理任務，顯著減少切換上下文的時間，特別適合需維持多環境部署一致性的團隊。

• 自動化專案連結：使用 vercel link 將本地目錄與 Vercel 專案綁定。

• Git 整合：連結 GitHub、GitLab 或 Bitbucket 儲存庫，實現自動化建置與持續部署。

• 安全的環境變數管理：使用專用指令安全地注入 Production、Preview 與 Development 變數，避免常見的 Shell 換行符號問題。

• 網域管理：透過 vercel domains ls 指令查詢、驗證並監控部署的自訂網域。

• 多環境支援：清楚區分 Production 與 Preview 部署，以實現安全的測試與發布流程。

• 前置需求：確保工作目錄包含正確的 .git 資料夾，以維持專案映射與根目錄的完整性。

• 使用說明：請在儲存庫根目錄執行 vercel git connect 以啟用推播部署觸發器。

• 最佳實踐：設定環境變數時，請使用 printf 等工具替代 echo，以防止變數值發生字元損壞。

• 限制說明：本技能依賴 Vercel CLI 的安裝與驗證，請確保本地環境具備足夠的存取權限與正確的 API 連線狀態。

• 故障排除：查詢網域資訊或更新部署設定前，請先透過 cd 指令切換至正確的專案子目錄。