文／Ovata｜更新：2026 年 11 月 3 日
做完這篇，你會知道 AI 卡住時要請它回報什麼、常見錯誤怎麼處理，以及怎麼把同一個網站交給 Ovata。遇到不清楚的訊息，直接貼給 AI，請它用白話說明。接著照下面的順序處理。
AI 不能假裝做完
Ovata 給 AI 的規則是：現有 API 做不到的功能要列出缺項。它不能假造 API、登入、訂單或付款成功，也不能另外自建會員、訂單、金流或物流後端。
預覽可以放示意資料，但要清楚標示，也不能上線成可以交易的流程。
覺得結果不對時，請它核對：
你剛才說完成了。請用工具讀回實際結果，告訴我哪些真的做好、哪些是示意資料。
請它列出缺項
這個功能現在有支援嗎？請查 get_web_api_docs，列出缺少的 API、受影響的頁面，以及現在能先做到哪裡。不要做假的。
你會收到這三項。接著由你決定先保留，或委託 Ovata。
檢查後端版本
有些功能需要較新的後端版本，而後端版本不會自己升級。
請用 get_merchant_backend 和 get_web_api_docs 查測試站和正式站的版本，說明升級能不能解決這個問題。要升級先問我。
升級要照順序：先升級測試環境，在測試站確認後，再升級正式環境。沒先升級測試環境會收到 STAGING_UPGRADE_FIRST。文件明列支援時才升級。
常見訊息
| 訊息 | 意思 | 處理方式 |
|---|---|---|
insufficient_scope、NOT_IN_CONNECTION |
連線缺權限 | 重新連線，同意頁按「允許連線」 |
SITE_FEATURE_UNAVAILABLE |
網站沒有這項後端或環境 | 重新連線沒用，請 AI 說明原因 |
ROLE_FORBIDDEN |
你的角色沒有權限 | 重新連線沒用，請工作區管理者處理 |
AUTHZ_PENDING |
權限還在同步 | 稍後重試 |
PATH_NOT_ALLOWED |
MCP 不開放這項操作 | 到 Console 操作 |
NOT_ON_TEST_SITE |
版本沒上過測試站 | 請 AI 先放上測試站 |
outcome_unknown |
寫入結果不明 | 請 AI 先讀回核對，不要重送 |
建置失敗時，AI 會看錯誤內容，修好程式後重新建置。
交給 Ovata
這一步要你同意。製作費另行報價，不會自動付款。同一個網站、repo 和進度都會保留，不會另開新站。
還沒上線的網站用 handoff_site_request：
我同意請 Ovata 接手，也知道會另行報價。請用 handoff_site_request 轉交，寫清楚已完成和待做的項目。
已上線的網站用 request_change：
（範例）請用 request_change 請 Ovata 在正式站加上預約時段功能。說明現有 API 缺什麼，先不要開放正式站資料。
每個網站同時只有一張進行中的修改需求。已經有一張時，AI 會改用 reply_request 補充。
報價確認和付款在 Console 的需求頁。AI 可以用 list_requests、get_request 幫你查進度。
2026 年 11 月 3 日以前建立的樣板網站僅日常管理，要改版面或程式請用同樣方式委託 Ovata。