部署审计技能Skill deployment-audit-skill

---

名称: 部署审计技能 描述: 使用DigitalOcean MCP及相关工具检查Unite-Hub/Synthex的部署健康状况、崩溃日志、环境一致性和运行时问题。用于诊断部署失败或验证就绪状态。 允许工具: 运行, 读取

部署审计技能

目的

持续监控并排查Synthex/Unite-Hub在DigitalOcean和Vercel上的部署问题。

典型任务

1. 通过DO CLI/MCP检索崩溃日志
   • doctl apps list
   • doctl apps logs <应用ID> --type=run_restarted
   • doctl apps logs <应用ID> <组件> --type=run_restarted
2. 检查环境变量在以下位置的一致性：
   • .env.local
   • Vercel项目设置
   • DigitalOcean应用规格
3. 验证：
   • 正确的Supabase URL和密钥
   • 正确的Stripe密钥（测试版与正式版）
   • 正确的回调/重定向URL

输出

• 人类可读的审计摘要，保存在docs/audit/DEPLOYMENT_HEALTH.md
• 问题条目，记录在docs/audit/AUDIT_ISSUES_REGISTRY.json

环境检查清单

必需变量

NEXT_PUBLIC_SUPABASE_URL
NEXT_PUBLIC_SUPABASE_ANON_KEY
SUPABASE_SERVICE_ROLE_KEY
NEXTAUTH_URL
NEXTAUTH_SECRET
GOOGLE_CLIENT_ID
GOOGLE_CLIENT_SECRET
ANTHROPIC_API_KEY

可选变量

STRIPE_SECRET_KEY
STRIPE_WEBHOOK_SECRET
SENDGRID_API_KEY
RESEND_API_KEY
SEMRUSH_API_KEY
DATAFORSEO_LOGIN
DATAFORSEO_PASSWORD

健康检查流程

步骤1：环境同步

对比以下位置的环境变量：

• 本地.env.local
• Vercel环境变量
• DigitalOcean应用规格

标记不匹配项。

步骤2：构建验证

• 运行npm run build
• 检查TypeScript错误
• 检查缺失的依赖项
• 验证所有路由是否编译成功

步骤3：运行时验证

• 检查最近的部署日志
• 寻找崩溃模式
• 识别内存/CPU峰值
• 标记响应缓慢的端点

步骤4：API健康检查

• 测试关键API端点
• 验证身份认证是否正常工作
• 检查数据库连接性
• 验证外部服务连接

常见问题及修复

问题：“找不到模块”

原因：缺少依赖项 修复：npm install <模块名>

问题：“环境变量无效”

原因：变量未设置或格式错误 修复：检查.env.local和部署设置

问题：“超出内存限制”

原因：计算量过大或内存泄漏 修复：优化代码、增加限制或添加缓存

问题：“数据库连接超时”

原因：连接过多或网络问题 修复：启用连接池，检查Supabase状态