官方教程中文版實戰場景
釋出應用或網站
說明如何讓 Codex 從 repo、screenshot、design brief 或 API doc 出發構建網站並部署 preview。
Codex 可以從 repo、screenshot、map、design brief、product note、API doc 或 data source 出發，構建或更新網站，再透過 Vercel 部署 preview，並把 live URL 交回來。
官方頁面：https://developers.openai.com/codex/use-cases/deploy-app-or-website
適合什麼任務
| 場景 | Codex 應該做什麼 |
|---|---|
| 把 screenshot、map、design brief 或 rough app idea 做成可訪問 preview | 使用 @build-web-apps 構建或打磨 app，再用 @vercel 部署 |
| 部署一個 branch 或 local app，不想手動 wiring Vercel commands | 讓 Vercel plugin 處理 preview deployment、deployment inspection 和 build logs |
| 需要 live URL 給別人看 | 本地 build 透過後部署 preview，並回報可訪問 URL |
使用的能力
| 能力 | 用法 | 連結 |
|---|---|---|
build-web-apps | 構建、review 和準備 web apps，覆蓋 React、UI、deployment、payments、database guidance | https://github.com/openai/plugins/tree/main/plugins/build-web-apps |
vercel | 部署 previews、檢查 deployments、讀取 build logs、管理 Vercel project settings | https://github.com/openai/plugins/tree/main/plugins/vercel |
相關官方說明：
- Build Web Apps plugin：https://github.com/openai/plugins/tree/main/plugins/build-web-apps
- Vercel plugin：https://github.com/openai/plugins/tree/main/plugins/vercel
- Vercel deployments：https://vercel.com/docs/deployments/overview
起始提示詞
请使用 @build-web-apps，把 [repo、screenshot、design 或 rough app idea] 做成可运行的网站。
然后使用 @vercel 部署 preview，并把 live URL 交给我。
上下文：
- [这个网站应该做什么]
- [要使用的 source data、API、docs 或 assets]
- [style 或 product constraints]
- [哪些内容不要改]
交付前，请先运行 local build，并确认 deployment 已 ready。這個 prompt 要求 Codex 先構建，再 preview deploy，並且在交付前執行 local build。不要跳過本地驗證直接要 URL。
先明確站點和部署目標
有用的交接應該具體。你可以給 Codex：
- repo。
- screenshot。
- map。
- design brief。
- product note。
- API doc。
- data source。
Codex 應該先 inspect project，再修改。預設部署目標應該是 Vercel preview；只有你明確要求 production，才進入生產釋出。
檢查後再分享
交付前，Codex 應該告訴你：
- 改了什麼。
- 用哪條 command build。
- Vercel deployment 是否 ready。
- 是否缺 environment variable。
- 是否需要 team choice、domain setting 或登入步驟。
- 如果 deploy 失敗，失敗日誌在哪裡，下一步怎麼修。
如果缺少環境變數、團隊選擇、域名設定或登入步驟，Codex 應該直接說明 blocker，而不是把站點說成已經完成。
從 live URL 繼續迭代
拿到 preview URL 後，不要換執行緒。同一執行緒已經有 repo、deployment 和 build context。
可以繼續讓 Codex：
- 開啟 URL 檢查頁面。
- 修 mobile layout。
- 更新 copy。
- 接上缺失資料。
- 讀取 Vercel failed build logs。
- 修復後重新部署 preview。
好的 follow-up 應該具體：
移动端 layout 太拥挤。请修复并重新部署 preview。继续使用同一个项目，并加入来自 [source] 的最新数据。请读取 failed build logs，并修复 deploy。釋出邊界
preview deployment 是預設動作。production changes 要明確說出來，並在執行前確認：
- 目標 project。
- 目標 branch。
- environment variables。
- domain / alias 設定。
- 是否會影響現有使用者。
Codex 適合把構建、部署和日誌診斷串起來，但生產釋出仍然應該保持顯式邊界。