Zeabur 部署規範

把一個專案的部署目標設定成 Zeabur 時，最容易踩的坑是：開發者習慣用 docker-compose.yml 把整套服務跑起來，理所當然地以為「compose 跑得起來 = 上線跑得起來」。在 Zeabur 上這個假設是錯的。這個 skill 的工作是把這個約束寫進專案的 AGENTS.md，讓之後在這個專案裡工作的所有 agent（包含未來的你自己）一開始就知道規則。

只在明確指定 Zeabur 部署時使用。 這個 skill 只處理「使用者明說專案要部署到 Zeabur」的情況。單純提到 Docker、寫 Dockerfile、或泛泛討論部署平台，都不該觸發 — 不要從這些線索去推測。若不確定使用者是不是真的要用 Zeabur，先問清楚，不要先動 AGENTS.md。

核心事實

Zeabur 是 PaaS 平台，部署機制如下：

• 支援 Dockerfile：Zeabur 會自動偵測專案根目錄的 Dockerfile，並以它建置部署。
• 不支援 docker-compose.yml：Zeabur 不會讀取 docker-compose.yml。多服務的線上編排要靠「Zeabur 多服務專案」或把 compose 轉成 Zeabur Template YAML（Zeabur 有官方轉換工具 zeabur/docker-compose-to-zeabur-template）。
• 因此：任何「要能在 Zeabur 上跑」的服務，都必須能單靠一份 Dockerfile（或 Zeabur 自動偵測的建置方式）完成部署。

但 — docker-compose.yml 不需要刪掉。它在「本地開發與測試」這個用途上仍然有價值（一次起 app + DB + cache 很方便），這是允許且鼓勵的。重點是把它的定位講清楚：compose 是本地開發/測試環境，不是線上部署設定。

Zeabur MCP（用 Claude 直接操作 Zeabur）

Zeabur 有官方 MCP server，安裝後可用 Claude 直接讀 / 改 Zeabur 上的專案、服務、環境變數、log、在容器內跑指令。