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 確認當前的工作環境。