vercel-debug
使用 Vercel CLI 调查 Vercel 部署错误。当用户共享 Vercel 部署错误、构建失败或需要调试的部署 URL 时使用。
📖 中文导读:使用 Vercel CLI 调查 Vercel 部署错误。当用户共享 Vercel 部署错误、构建失败或需要调试的部署 URL 时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: vercel-debug description: Investigate Vercel deployment errors using Vercel CLI. Use when user shares a Vercel deployment error, build failure, or deployment URL that needs debugging.
Vercel Deployment Debugging
Workflow
1. Check authentication
vercel whoami
If error "No credentials found", prompt user to run vercel login in their terminal (interactive).
2. List recent deployments
vercel list <project-name> --scope <team-name>
Find the failing deployment URL (status: Error or Building).
3. Get build logs
vercel inspect <deployment-url> --logs --scope <team-name>
Add --wait to wait for in-progress builds:
vercel inspect <deployment-url> --logs --scope <team-name> --wait
4. Common errors
| Error | Cause | Fix |
|---|---|---|
| Mixed Routing Properties | routes and rewrites mixed in vercel.json |
Use only rewrites (new format) |
| Cannot find module | Package not built before dependent | Add to build command or use turbo |
| Build Command > 256 chars | Command too long | Use pnpm build with turbo/nx |
5. Get deployment info (without logs)
vercel inspect <deployment-url> --scope <team-name>