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。
驗證指令
完成後驗證
替換成實際驗證指令
curl -I https://www.example.com/Agent Prompt
Prompt
替換成可複製的 Agent Prompt
請針對以下專案做 SOP 執行前檢查。
目標:
- 先讀取相關設定與文件。
- 不要一開始直接修改程式。
- 列出風險、待確認事項、建議操作順序。
輸入資料:
- Repo:
- 正式網域:
- 部署平台:
- 目前錯誤或任務:
輸出格式:
- 目前狀態
- 風險清單
- 建議操作流程
- 驗證方式
常見錯誤
- 錯誤一:描述症狀、常見原因、修法。
- 錯誤二:描述症狀、常見原因、修法。
- 錯誤三:描述症狀、常見原因、修法。
完成標準
Checklist
完成前檢查
- 主要操作已完成。
- 驗證指令結果符合預期。
- 後台狀態或 log 已確認。
- 相關文件、prompt 或 troubleshooting 已更新。