Vibe Coder
交付清單與收尾 SOP：讓每次上線都不焦慮
職業化交付的收尾流程包含四塊：程式碼品質與測試都通過、資安檢查表打勾、文件與版本更新完成，再用書面確認走一次客戶驗收，最後附上交接文件。有了標準流程，每次上線都不用靠感覺，也不焦慮。
交付清單與收尾 SOP：讓每次上線都不焦慮
交付不是「我傳你連結」，而是一個有步驟的確認流程。這篇把 Stage 6 前面幾個模組串成一份完整的交付清單，加上客戶驗收該怎麼走、上線後第一週要盯什麼，以及一份能讓客戶獨立維護系統的交接文件，讓每次上線都是標準流程，不是憑感覺。
你將學到什麼
完整的交付清單
程式碼品質、測試、資安、文件，四大類逐項打勾才算真正完成。
客戶溝通和驗收
從驗收清單到視訊走一遍，再到書面確認，四個步驟保護雙方。
上線後的第一週
第一天盯錯誤 Log，第二三天看費用警報，第七天做回顧。
交接文件
系統概覽、日常維運、緊急情況、常見問題，一份 HANDOVER.md 打包所有事。
完整的交付清單
程式碼品質：
- ruff check . 通過，沒有 Linting 錯誤
- 所有主要函式有 docstring
- 沒有 TODO 留在上線的程式碼裡（或已文件化）
測試：
- pytest 所有測試通過
- 覆蓋率六成以上
- 新功能有對應的測試
資安：
- Stage 5 的資安檢查表全部打勾
- Secret 在環境變數，不在程式碼
- 正式環境 HTTPS 正常
文件：
- README 更新，新人能跑起來
- CHANGELOG 更新
- 版本號已升級並打 git tag
客戶溝通和驗收
交付不是「我傳你連結」，而是一個有步驟的確認流程：
- 提供驗收清單：把雙方確認的驗收條件整理成清單，邀請客戶逐一確認。
- 視訊走一遍：安排三十分鐘的視訊，帶客戶走過所有功能，讓他們親眼看到每個驗收條件通過。
- 書面確認：視訊結束後發一封 Email 總結確認的項目，請客戶回覆「確認驗收完成」。書面確認保護雙方。
- 交付交接文件：把操作說明、環境設定、緊急聯絡方式整理成文件，交給客戶。
驗收確認 Email 模板主旨：[天氣小工具 v1.0.0] 驗收完成確認。內文列出根據驗收視訊確認通過的項目，例如天氣查詢功能、使用者帳號登入和歷史記錄、API 回應時間小於兩秒，最後請客戶確認並回覆此信。
上線後的第一週
上線後的第一週最容易出問題，密切監控是關鍵：
- 第一天：密切觀察錯誤 Log 和監控，確認沒有預期外的問題出現。
- 第二到三天：檢查費用警報，確認 API 呼叫量和費用在預期範圍內。
- 第七天：第一週回顧，整理遇到的問題和解決方式，更新技術文件。
交接文件
# 交接文件（HANDOVER.md）
## 系統概覽
- 技術棧：Python FastAPI + Supabase + Railway
- 版本：v1.0.0（2026-06-28）
## 日常維運
- 監控：Railway 的 Metrics 和 Log
- 費用警報：Anthropic Console（月費上限 $50）
## 緊急情況
- 服務掛掉：Railway 會自動重啟，等五分鐘再確認
- API Key 問題：重新產生並更新 Railway 環境變數
- 緊急聯絡：your@email.com（回覆時間二十四小時內）
## 常見問題
Q: 城市查詢回傳 404？
A: 確認城市名稱是英文，例如 Taipei 而不是台北Stage 6 總複習
| 模組 | 核心能力 |
|---|---|
| 6-1 職業化定義 | 五個維度評估交付品質：可理解、可重現、可維護、可驗收、可信任 |
| 6-2 README 和文件 | 最小必要結構的 README、FastAPI 自動 API 文件、Google Style Docstring |
| 6-3 版本和 CHANGELOG | 語意化版本號判斷、CHANGELOG 格式、git tag 發布流程 |
| 6-4 程式碼品質 | Ruff Linting、命名原則、pre-commit 自動把關 |
| 6-5 測試基礎 | pytest 單元測試、Mock 隔離外部依賴、TestClient API 測試 |
| 6-6 交付 SOP | 完整交付清單、客戶驗收流程、上線後監控、交接文件 |
Stage 6 完成後你能做到不只是「能跑」，而是能職業化地交付。有完整的文件讓人能接手，有版本管理追蹤每個改動，有測試確保品質，有 SOP 讓每次上線不焦慮。這是讓客戶信任你、讓自己三個月後還能維護的能力。
延伸學習
ChatGPT 很強，但真正讓你下班的是 Google
六小時完整實錄。從「AI 很厲害，為什麼你還是每天加班」這個問題出發，把 Google Workspace 當成真正的工作平台重新設計一次流程 ── Sheets 的資料結構、Drive 與 Docs 的文件流、Gmail 與 Calendar 的通知系統，再用 Apps Script 讓它自己跑起來，最後收斂成一張屬於你自己的 AI 工作能力地圖。
NT$ 4,599
寫給升國一的你的筆記術
寫給剛升上國中的你：筆記不是寫給老師看的，是寫給考前的自己看的。18 章 85 課圖文，從「為什麼要寫」講到七科各自怎麼記，附 78 份可以印出來寫的練習單，以及 80 課家長專區與 34 張三年筆記養成路徑圖。沒有閱讀期限，國一買、國三還在。
NT$ 3,599
常見問答
交付清單有哪四大類？
程式碼品質（Ruff Linting、docstring）、測試（pytest 全過、覆蓋率六成以上）、資安（Stage 5 檢查表、Secret 放環境變數）、文件（README、CHANGELOG、版本號打 tag），四類都要打勾才算完成。
為什麼驗收要走書面確認，口頭說好不行嗎？
口頭確認容易各自記憶不同，出現爭議時沒有依據。視訊走一遍所有功能之後，發一封 Email 總結確認項目並請客戶回覆，才是真正保護雙方的做法。
上線後多久算安全，可以不用再盯著？
第一週最容易出問題。第一天要密切觀察錯誤 Log 和監控，第二三天檢查費用警報，第七天做完整回顧並更新技術文件，過了第一週再逐漸放鬆頻率。
交接文件要寫到多細？
標準是假設你明天消失，客戶拿到 HANDOVER.md 後能獨立處理八成的日常問題，不需要找你，內容至少要有系統概覽、日常維運、緊急情況處理、常見問題和緊急聯絡方式。