use-railway

use-railway 技能为管理 Railway 云端基础设施提供了完整的接口。该工具专为工程师与开发者设计，能自动化云端资源的生命周期，从初始服务供应到生产环境的故障排除与性能分析。它在 AI 代理与 Railway CLI 之间建立桥梁，实现跨工作区、项目、环境与服务的精确操作。

• 基础设施生命周期：建立并配置项目，从仓库或 Docker 镜像部署代码，并管理如 production、staging 或 development 等隔离的配置环境。

• 数据库与存储管理：供应并检测受管数据库（如 PostgreSQL、MySQL、Redis 及 MongoDB），并管理用于持久化文件的 S3 兼容对象存储桶。

• 可观测性与故障排除：获取部署日志、监控构建状态并取得运行时指标。内置专业分析脚本，用于检查数据库健康状态、延迟、连接池及资源使用率。

• 配置与网络：通过 CLI 或 API 直接管理环境变量、密钥、域名设置与网络配置。

• 智能路由：根据用户关于部署、基础设施故障或服务状态的查询，自动识别意图并将请求路由至适当的专业参考资料。

• 本技能需要安装 Railway CLI 并通过 railway login 完成认证。提供 Railway 仪表板 URL 时效果最佳，代理将从中提取项目、服务与环境 ID。

• 建议优先使用通过 --project、--service 与 --environment 等标志传递的明确 ID，以在不修改全局设置的情况下保持操作的可预测性。

• 针对复杂的数据库问题，本技能提供专用的分析例程 (analyze-db)，优先处理指标收集而非标准的状态检查。

• 支持 JSON 输出，便于自动化脚本编写与解析复杂的资源元数据。

• 受限于 Railway 的资源层级架构；执行破坏性变更或配置修补前，请务必使用 railway status --json 确认当前的工作环境。