Aafff623/deploy
.cursor/skills/deploy/SKILL.md
Guides Vercel deployment and PWA setup for petconnect-app. Use when deploying to Vercel, configuring PWA, adding to home screen, or troubleshooting deployment/auth/AI issues.
devops
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add Aafff623/pet-adoption-app deployInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 5:54 PM23.0s2 files scanned
SKILL.md
- name:
- deploy
- description:
- Guides Vercel deployment and PWA setup for petconnect-app. Use when deploying to Vercel, configuring PWA, adding to home screen, or troubleshooting deployment/auth/AI issues.
Deploy 部署技能
触发词：部署、Vercel、PWA、发布、上线、vercel 部署、PWA 安装
一、Vercel 部署流程
1. 导入项目
- 登录 Vercel → Add New → Project
- 选择 GitHub 仓库（如
pet-adoption-app） - 确认分支
main
2. 构建配置
| 配置项 | 值 |
|--------|-----|
| Framework Preset | Vite（自动检测） |
| Build Command | npm run build |
| Output Directory | dist |
| Root Directory | ./ |
项目已有 vercel.json，可覆盖上述配置。
3. 环境变量（必填）
在 Vercel → Settings → Environment Variables 添加：
| Key | 必填 | 说明 |
|-----|:----:|------|
| VITE_SUPABASE_URL | 是 | Supabase 项目 URL |
| VITE_SUPABASE_ANON_KEY | 是 | Supabase Anon Key |
| VITE_LLM_PROVIDER | 否 | deepseek / doubao / gemini，默认 deepseek |
| VITE_DOUBAO_API_KEY | doubao 时 | 豆包 API Key |
| VITE_DOUBAO_MODEL_ID | doubao 时 | 豆包推理接入点 ID（ep-xxx 或预置模型 ID） |
| VITE_DEEPSEEK_API_KEY | deepseek 时 | DeepSeek API Key |
| VITE_GEMINI_API_KEY | gemini 时 | Gemini API Key |
注意：环境变量修改后必须 Redeploy 才能生效（Vite 在构建时注入）。
4. Supabase URL 配置
部署完成后，在 Supabase Dashboard → Authentication → URL Configuration：
- Redirect URLs：添加
https://<你的项目>.vercel.app/（如https://pet-adoption-app-omega.vercel.app/） - Site URL：可改为生产域名
否则登录/注册后重定向会失败。
二、PWA 流程
1. 依赖与配置
项目已集成 vite-plugin-pwa，vite.config.ts 中已配置 VitePWA 插件及 manifest。
2. 图标资源
图标位于 public/pets/：
| 文件 | 用途 |
|------|------|
| pwa-192x192.png | Manifest 小图标 |
| pwa-512x512.png | Manifest 主图标 |
| favicon.ico | 浏览器标签页 |
| apple-touch-icon.png | iOS 主屏幕 |
3. 验证 PWA
- 部署后访问 Vercel 域名
- Chrome DevTools → Application → Manifest：检查名称、图标、theme_color
- Application → Service Workers：确认已注册
- 安卓：菜单 → 「添加到主屏幕」；桌面：地址栏安装图标
三、坑点速查
完整坑点见 reference.md。
| 坑点 | 快速处理 |
|------|----------|
| 提交信息乱码 | 提交信息请使用英文；若已乱码，用 git commit -F <文件> 修正，见 github-batch-commits |
| AI 回复失败 | 配置 VITE_LLM_* 环境变量并 Redeploy |
| 注册成功登录失败 | Supabase 邮箱未验证，查 auth.users.email_confirmed_at |
| 登录重定向失败 | Supabase Redirect URLs 添加 Vercel 域名 |
| 环境变量不生效 | 修改后必须 Redeploy |
四、检查清单
部署前：
- [ ] 环境变量已在 Vercel 配置（含 Supabase、LLM）
- [ ] Supabase Redirect URLs 已添加 Vercel 域名
部署后：
- [ ] 访问域名可正常打开
- [ ] 登录/注册流程正常
- [ ] AI 智能体（若配置）可正常回复
- [ ] PWA 可「添加到主屏幕」
调试：
- Supabase 数据：使用 supabase-calls 的
execute_sql查 auth.users、profiles - AI 失败：浏览器控制台查看
[PetConnect Doubao]日志
Related Skills
Aafff623/supabase-calls
tools
VerifiedTrustedCommunity
Guides Supabase usage in petconnect-app including MCP tool calls, migrations, RLS, and API layer conventions. Use when working with Supabase, executing SQL, applying migrations, list_tables, execute_sql, RLS policies, or database schema changes.
SKILL.mdUpdated Apr 17, 2026
Aafff623/repo-slimming
tools
VerifiedTrustedCommunity
项目仓库瘦身与规范。Use when cleaning repo, optimizing .gitignore, removing large files, or organizing project structure. 约定：脚本仅用 PowerShell / npm 跨平台命令，不生成 .sh 文件。
SKILL.mdUpdated Apr 17, 2026
Aafff623/readme-generator
development
VerifiedTrustedCommunity
Generates professional README files by synthesizing standard-readme, Best-README-Template, Google styleguide, and GitHub best practices. Use when creating or redesigning README.md, documenting projects, or when the user asks for README templates or best practices.
SKILL.mdUpdated Apr 17, 2026
Aafff623/readme-deployment
development
VerifiedTrustedCommunity
专业处理 README 与部署文档。Use when writing README, deployment guides, environment variable docs, or project structure documentation. 约定：README 必须包含环境变量表、获取 API Key 的链接、部署步骤、项目结构。
SKILL.mdUpdated Apr 17, 2026