Skip to content

SOP 撰寫模板|SOP Writing Template

這篇是新增 SOP 時的複製模板。建立新文件時,先複製下方章節,再把括號內的提示改成實際內容。

適用情境

  • 這份 SOP 適用在什麼專案、平台或錯誤情境。
  • 什麼狀況不適用,應改看其他文件。
  • 觸發條件,例如「準備上線前」、「GSC 出現錯誤」、「Webhook 收到重複事件」。

最終目標

用 2 到 4 點寫清楚完成後應達到的狀態。

  • 使用者或搜尋引擎看到正確結果。
  • 系統狀態可被驗證。
  • 後續維護者能從 log、後台或指令確認結果。

前置資料

  • 專案名稱、正式網域、部署平台與 repo。
  • 需要的帳號權限,例如 Cloudflare、Render、Supabase、GSC、金流後台。
  • 需要先知道的設定值,例如 callback URL、canonical host、API endpoint、Webhook secret。

操作流程

1. 先確認目前狀態

寫下進入操作前要看的後台頁面、設定檔、環境變數或 log。

2. 執行主要修改

每一步只做一件事,並說明為什麼要做。

3. 回頭檢查設定是否一致

列出容易漏掉的關聯設定,例如 DNS、redirect、metadata、sitemap、Webhook endpoint、OAuth callback。

驗證指令

完成後驗證

替換成實際驗證指令

Expected: 說明預期 status、header 或輸出

Terminal window
curl -I https://www.example.com/

Agent Prompt

Prompt

替換成可複製的 Agent Prompt

請 Agent 先 audit 再提出修法 Codex

請針對以下專案做 SOP 執行前檢查。

目標:

  • 先讀取相關設定與文件。
  • 不要一開始直接修改程式。
  • 列出風險、待確認事項、建議操作順序。

輸入資料:

  • Repo:
  • 正式網域:
  • 部署平台:
  • 目前錯誤或任務:

輸出格式:

  1. 目前狀態
  2. 風險清單
  3. 建議操作流程
  4. 驗證方式

常見錯誤

  • 錯誤一:描述症狀、常見原因、修法。
  • 錯誤二:描述症狀、常見原因、修法。
  • 錯誤三:描述症狀、常見原因、修法。

完成標準

Checklist

完成前檢查

P0

  • 主要操作已完成。
  • 驗證指令結果符合預期。
  • 後台狀態或 log 已確認。
  • 相關文件、prompt 或 troubleshooting 已更新。

延伸文件