deploy-to-vercel skill 是什麼、怎麼用：讓智能體把項目部署到 Vercel 的官方 Skill（預設只發預覽版）

本文根據 vercel-labs/agent-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 15.1 萬次；所在倉庫 vercel-labs/agent-skills 在 GitHub 約 3.2 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

「幫我部署一下，給我個連結」——這句話背後有很多分支：項目關聯過 Vercel 嗎？有沒有 git 遠端？命令行登入了嗎？是在本機還是在沙盒裏？deploy-to-vercel 把這些判斷寫成了流程。description：把應用和網站部署到 Vercel；用戶說「部署我的應用」「部署並給我連結」「把它上線」或「創建一個預覽部署」時使用。

兩條原則寫在最前面：永遠部署為預覽，除非用戶明確要求生產環境；目標是把用戶帶到最好的長期狀態——項目已關聯 Vercel、靠 git push 自動部署，每種方法都盡量往這個方向推進。

第一步收集項目狀態（是否存在 .vercel/、有無 git 遠端、CLI 是否已登入、屬於哪些團隊；有多個團隊時列出來讓你選）。然後按情況選方法：已關聯且有遠端就提交併推送；已關聯但沒有遠端就用 CLI 部署；未關聯但已登入就先關聯；未登入則引導你運行 vercel login 在瀏覽器裏完成授權。無法登入的沙盒環境（claude.ai、Codex）各有一套免登入的兜底腳本。

怎麼安裝

倉庫 README 給的安裝方式是 skills CLI。只裝這一個技能，加上 CLI 文檔裏的 --skill 參數（技能名是 deploy-to-vercel，與倉庫裏的文件夾名不完全相同）：

bash
npx skills add vercel-labs/agent-skills --skill deploy-to-vercel

去掉 --skill 會進入選擇介面，可以一次勾選多個；加 -g 裝到用戶目錄，加 -a claude-code 之類的參數指定智能體。

倉庫整體介紹和其他安裝方式，詳見本站《vercel-labs/agent-skills 是什麼、怎麼安裝：Vercel 官方 Agent Skills（React / Next.js 最佳實踐、網頁介面規範審查）》。

怎麼用

• 「把這個 Next.js 項目部署一個預覽，給我連結」。
• 「這次發生產環境」——只有這樣明說，它才會走生產部署。
• 部署失敗時它會查看構建狀態並按說明裏的排障小節處理（網絡出口受限、CLI 認證失敗等）。

目錄裏帶有兩個部署腳本，供沙盒環境使用。

適合誰 / 侷限

適合前端和全棧開發者讓智能體代勞日常的預覽部署，也適合在 claude.ai 裏做完小項目想馬上拿到可訪問連結的人。它只管 Vercel；數據庫遷移、環境變量的業務含義不在它的職責內；免登入兜底會返回一個預覽地址和一個認領地址（Claim URL），要用後者把部署轉到你自己的帳號下。

注意事項

• 許可：該技能未單獨標註許可。
• 會執行命令並可能推送代碼：走 git 方式時它會提交併 push，確認當前分支和遠端是你想要的。
• 帳號與費用：部署計入你的 Vercel 套餐用量；登入在你自己的瀏覽器裏完成，不要把令牌貼進對話。
• 公開可訪問：預覽連結預設任何拿到連結的人都能打開，含敏感數據的項目先配置訪問保護。