Codex和Claude Code可以協助調查網站架構、撰寫文章、修改程式碼及測試。不過，依連接的環境與授予的權限，也可能影響正式環境的檔案或伺服器。在考慮便利性之前，先決定「允許哪些操作、哪些操作須由人員核准」。
區分「調查」與「變更」
第一次委託時，只請AI進行以唯讀為主的調查與提案。
請調查這個WordPress網站的架構與更新方式，整理改善提案。
目前請勿變更檔案、套用至正式環境、重新啟動、更新或刪除。
不明之處請勿猜測，請註明不明。
確認報告後，再指定目標檔案與完成條件，委託變更。這樣可以避免自己原本只想請AI診斷，AI卻進行正式環境修改的認知落差。
需要人員核准的操作
通常會要求下列操作事先取得核准。
- 正式發布、部署、同步
- 刪除文章、圖片、檔案或資料庫
- 更新WordPress、佈景主題、外掛或OS
- 停止或重新啟動伺服器、容器
- 註冊外部服務、簽約、付費
- 寄送電子郵件給住宿旅客
- 變更預訂、庫存、退款或付款資料
允許本機草稿與非破壞性測試，並設定在影響外部的操作前停下的界線，可以讓工作更容易推進。
不要貼上秘密資訊與顧客資料
不要把密碼、API金鑰、私密金鑰或信用卡資料寫進對話與指示文件。顧客的姓名、地址、電話號碼、電子郵件與預訂編號，也不要直接使用真實資料進行調查。認證資訊應使用操作環境提供的安全保管功能，並把權限與有效期間限制在必要的最小範圍。
AGENTS.md與CLAUDE.md
每次都要說明的網站架構、工作步驟與安全規則，可以整理到專案內的Markdown文件。Codex的正式檔名是 AGENTS.md，Claude Code則是 CLAUDE.md。
將共通規則寫進 AGENTS.md，再於 CLAUDE.md 開頭如下匯入，可以減少重複維護。
@AGENTS.md
這個 @ 不是檔名的一部分，而是Claude Code匯入其他檔案的符號。不是要建立名為 @AGENTS.md 的檔案。
管理旅宿網站的資料夾/
├── AGENTS.md ← Codex讀取的共通規則
└── CLAUDE.md ← Claude Code讀取，並從中匯入AGENTS.md
直接查看與儲存範本
下列Markdown檔案不是ZIP。開啟連結即可查看內容，也可以直接儲存。
將入門版套用至貓宿研究所的編輯方針，會得到下列範例。公開範例不包含伺服器架構、使用的服務、內部路徑、指令、連線資訊或認證資訊。
從入門版具體化的重點
針對入門版的空白欄位，公開範例以「權限受限的既定步驟」「可還原的備份」「公開頁面與內部連結的確認」等方式，在不揭露環境資訊的情況下，把行動與完成條件具體化。
此外，也將「安全地工作」這類抽象指示，改成下列可據以判斷的形式。
| 入門版的項目 | 貓宿研究所的具體範例 |
|---|---|
| 工作範圍 | 僅限獲准工作區域內的原稿與維運文件 |
| WordPress操作 | 使用權限受限的既定步驟 |
| 變更前確認 | 確認存在可還原的備份及還原方法 |
| 文章規則 | 透過官方資訊確認貓咪在籍及客房訪問，不把未曾體驗的內容寫成親身經歷 |
| 發布後確認 | 確認頁面顯示、內文、圖片、分類、作者及內部連結 |
| 首頁 | 維持6篇最新文章，並排除旅宿主人專區分類 |
| 需要核准的操作 | 重新啟動、更新、刪除、變更預訂與付款、對外傳送 |
在自己的旅宿使用時，也把「哪些檔案」「哪些確認方法」「哪些操作要停下」具體化到這個程度，就更容易讓AI與人員的認知一致。
Codex的正式檔名不是單數的 AGENT.md，而是複數的 AGENTS.md。儲存時請注意，不要變成 AGENTS.md.txt。
1. 儲存檔案
開啟連結，使用瀏覽器的「儲存頁面」，或把內容複製到文字編輯器，並將檔名準確設為 AGENTS.md。若也使用Claude Code，請一併儲存 CLAUDE.md。
不要放在WordPress管理介面或公開伺服器，而是放在管理佈景主題、外掛、文章原稿、同步指令碼等資料的工作資料夾最上層。若由製作公司管理，而您不知道工作資料夾在哪裡，請先詢問負責人，不要自行上傳至伺服器。
2. 改寫方括號內的項目
將提供版 AGENTS.md 中的 ［宿名］、［URL］、［事業者名］ 等欄位換成自己的環境資訊。不知道的項目不要猜測，可以寫成「不明，正在向製作公司確認」。
尤其需要具體說明下列項目。
- 原稿與佈景主題的正本位置
- 套用至正式環境的步驟
- 取得備份與還原的方法
- 更新後要確認的頁面、預訂與詢問功能
- AI可以執行的操作
- 正式發布、刪除、重新啟動等須事先核准的操作
不要寫入密碼、API金鑰、私密金鑰或顧客資料。
3. 確認Codex已讀取
在Codex中開啟放有 AGENTS.md 的資料夾，開始新的工作，並如下提問。
請摘要目前讀取的專案指示。
目前請勿變更檔案或伺服器。
確認回答是否反映旅宿名稱、工作步驟及須核准的操作。若未反映，請重新檢查檔名、存放位置及Codex目前開啟的資料夾。
4. 確認Claude Code已讀取
將 AGENTS.md 與 CLAUDE.md 放在同一資料夾，再於該資料夾啟動Claude Code。透過 CLAUDE.md 中的 @AGENTS.md，共通規則也會一併匯入。
在Claude Code中執行 /context，確認記憶檔案清單中是否出現 CLAUDE.md。接著，與Codex一樣，詢問「請摘要目前的專案指示」，確認共通規則已反映。
5. 從小型唯讀工作開始試用
不要一開始就委託更新或發布，而是先從確認網站架構等不改變原有狀態的工作開始。
請調查這個專案的WordPress架構與發布步驟。
請遵守AGENTS.md的規則，這次只進行唯讀操作。
請報告不明之處，以及開始工作前應確認的事項。
確認報告與自己的環境一致後，再依序擴大到本機草稿、測試環境與正式環境。
放置指示文件不代表就能確保安全
AGENTS.md 與 CLAUDE.md 是給AI的指示，並非強制性的存取控制。應搭配SSH權限、沙箱、備份及核准設定使用。操作方式改變時，也要更新檔案，不要留下過時的發布步驟或不存在的確認指令。
透過執行途徑限制權限的具體方法，請參閱讓AI操作正式伺服器時的權限設計，文章依專用OS使用者、SSH、sudo、WP-CLI及緊急停止分別說明。
實際容易發生的事實誤認、漏更新、批次變更與備份失敗，以及不應交由AI單獨執行的工作，整理於AI維運中發生的失誤與不能交給AI的工作。
工作前後應留下的紀錄
工作前，先確認備份時間、目標及還原方式。完成時，請AI報告變更的檔案、執行的測試、尚未確認的事項，以及發布後須由人員確認的URL。不要只把決定事項留在對話裡，也應反映到維運文件。
免費範本
貓宿研究所免費公開上述 AGENTS.md 與 CLAUDE.md。使用前，務必依自己的環境調整伺服器類型、發布步驟、備份方法及不可操作的範圍。
參考資料
※產品規格與設定項目可能變更。導入時，請確認各官方文件的最新版本。
若要進一步使用WP-CLI操作，請從什麼是WP-CLI？請AI協助WordPress前應了解的基礎與安全起步方式開始進行唯讀確認。
