用途:在部署前后执行机械式基础设施检查,由脚本完成探测,智能体只需运行并依据结构化 JSON 结果行动,不要内联重写连通性探测。
主要能力:health-check.sh 检查 Vercel 部署状态、Railway 项目状态、Redis 连通性和 PostgreSQL 连通性;各服务独立检查,缺少 CLI 工具时返回提示性 JSON 错误而非崩溃。脚本读取 REDIS_URL(默认 redis://localhost:6379)、DATABASE_URL(默认 postgresql://localhost:5432/dev)、VERCEL_ORG_ID(可选)。返回 JSON 的 overall 与 services,状态值包括 ok、error、missing_tool、skipped。overall 为 ok 表示全部健康可继续;为 error 表示至少一项失败,需读取 error 字段修复后再部署;出现 missing_tool 时告知用户安装对应 CLI,不要因无关服务阻塞部署。verify-env.sh 接收变量名列表,返回 all_set、present、missing,用于部署或迁移前校验,若 all_set 为 false 应报告缺失变量及设置位置(Vercel 面板、Railway 变量或 .env.local)后停止,不得带缺失密钥继续部署。
使用方式:bash <skill-path>/scripts/health-check.sh;bash <skill-path>/scripts/verify-env.sh REDIS_URL DATABASE_URL VERCEL_TOKEN BSV_PRIVATE_KEY。典型工作流:先运行 verify-env.sh 确认 all_set 为 true,再运行 health-check.sh 确认 overall 为 ok,然后部署,部署后再次运行 health-check.sh 确认服务仍健康;任一步出错应先修复。
适用场景:部署前冒烟检查(两者结合,先验环境再健康检查)、诊断故障的预发环境、搭建新环境、部署后验证、CI 预检门禁。限制:脚本不会重试或静默降级,失败即明确失败;缺少 CLI 工具会返回 missing_tool 而非自动安装;此项未提供其他功能、收费或价格信息。