「我想換外包商，但打開專案才發現：沒有文件、沒有帳號清單、只有一包看不懂的原始碼。」一位開餐飲連鎖的老闆這樣描述他被綁架的處境——當初 NT$45 萬做的系統，現在光是「搞懂它怎麼跑」就要再花 NT$10 萬。問題的根源不是程式寫得爛，而是交接文件從一開始就不存在。這篇教你：一個負責任的外包商，該交給你哪些文件，讓你隨時能換人、永遠不被綁架。
業界迷思打破
- 迷思一：「有原始碼就等於能接手。」真相：沒有部署文件、環境設定、帳號清單，原始碼就像一台沒有鑰匙也沒有說明書的車。
- 迷思二：「文件是額外服務，要另外付錢。」真相：基礎交接文件是交付物的一部分，不是加購品。專業廠商本來就該給。
- 迷思三：「等要換廠商時再要文件就好。」真相：關係破裂後才要文件，最容易要不到、或拿到敷衍版本。文件要在合作順利時、寫進合約裡。
- 迷思四：「文件寫越多越好。」真相：一份能讓新工程師 1 天內跑起系統的精準文件，勝過 100 頁沒人維護的 Word。
核心框架：交接文件的 6 大類（缺一不可）
- 1. 系統架構圖：前端、後端、資料庫、第三方服務怎麼連。
- 2. 部署與環境文件：怎麼從零把系統跑起來（環境變數、相依套件、部署步驟）。
- 3. 帳號與資產清單：主機、網域、金流、API 金鑰、Email、SSL 憑證分別在誰名下。
- 4. 資料庫結構說明：主要資料表與關聯、關鍵欄位意義。
- 5. 原始碼與版本控制：Git repo 存取權、分支策略、README。
- 6. 維運手冊：常見問題排除、備份還原、監控告警設定。
驗收標準只有一句話：「換一個沒碰過這專案的工程師，能不能靠這份文件在 1 天內把系統跑起來？」做得到，才算合格。
三類典型情境對照
- 10 人新創（單一系統）：最低要有部署文件 + 帳號清單 + README。文件精簡但關鍵資產不能缺。
- 50 人中型公司（多系統整合）：需完整 6 大類 + 系統架構圖，因為跨系統依賴一旦沒文件，重接成本極高。
- 200 人企業（有內部 IT）：除 6 大類外，要對接內部 IT 的規範（資安、稽核軌跡、變更紀錄），文件需可被內部團隊接續維護。
隱藏成本完整清單（沒文件的代價）
- 接手摸索成本：新廠商光是讀懂舊系統，通常要收 NT$50,000–150,000「熟悉費」。
- 停機風險成本：沒有維運手冊，一次半夜當機可能損失一整天營收。
- 資產贖回成本：網域、金流帳號在舊廠商名下，要回來可能卡數週。
- 重工成本：文件不清，新廠商常直接重寫，等於再付一次開發費。
- 談判弱勢成本：被綁架時，你沒有議價空間，只能接受舊廠商的續約條件。
評估外包夥伴的 KPI 計分卡（交接文件面向）
- 合約是否明列「交接文件」為交付物？（0-2 分）
- 是否提供系統架構圖？（0-2 分）
- 部署文件能否讓新人 1 天內跑起系統？（0-3 分）
- 帳號與資產是否登記在「你」名下？（0-3 分）
- 資料庫是否有結構說明？（0-2 分）
- 是否有維運手冊與備份還原步驟？（0-2 分）
- Git repo 存取權是否交給你？（0-2 分）
- 文件是否隨版本更新、而非一次性交付？（0-2 分）
總分 18，14 分以上才算「隨時能換人」的安全狀態。
ScriptWalker 的對應方案 + 不適合的情境
我們把交接文件寫進每一份合約的交付清單，並提供三種合作模式：專案制（交付即含 6 大類文件）、月費維護（文件隨版本持續更新）、以及「文件健檢」——幫你檢查現有系統的交接文件缺口並補齊。
不適合我們的情境（誠實說）：
- 只想要「最便宜、不要文件」的一次性外包——我們不做「做完就消失」的專案。
- 拒絕把帳號與資產登記在自己名下的客戶——那反而增加你的風險。
- 期待「一份文件用十年不更新」——系統會變，文件也要維護。
啟動期遊戲書（把交接寫進第一天）
- 第 1 週：合約明列交接文件為交付物，開一個共用文件庫（Notion／Git Wiki）。
- 開發期間：文件與程式碼同步更新，不是最後才補。
- 上線時：交付 6 大類文件 + 帳號清單，並做 1 次「換人測試」。
- 第 90 天：驗證文件是否仍與系統一致，建立每季更新機制。
決策清單
- ☐ 我的合約有把交接文件列為交付物嗎？
- ☐ 我拿得到系統架構圖嗎？
- ☐ 新工程師能靠文件 1 天內跑起系統嗎？
- ☐ 網域在我名下嗎？
- ☐ 金流帳號在我名下嗎？
- ☐ 我有 Git repo 的存取權嗎？
- ☐ 我有資料庫結構說明嗎？
- ☐ 我有維運與備份還原手冊嗎？
- ☐ 文件會隨版本更新嗎？
- ☐ 我做過「換人測試」嗎？
常見問題 FAQ
外包商說「文件要另外收費」合理嗎？
基礎交接文件（部署、帳號、架構）應是交付物的一部分。深度的內部技術文件或教學可另議，但「連怎麼跑起來都不給」不合理。
合作到一半才發現沒文件怎麼辦？
先在關係還好時，用「文件健檢」把缺口補齊，並把「文件更新」寫進後續維護約。別等到要換人才要。
我不懂技術，怎麼驗收文件？
最簡單的驗收法：請另一個工程師（或新廠商）只看文件，試著把系統跑起來。跑得起來就合格，跑不起來就是文件不合格。
行動呼籲
不確定你的系統交接文件夠不夠？我們提供免費 30 分鐘「文件健檢」諮詢，幫你盤點缺口、評估被綁架風險。
- Email：[email protected]
- 電話：0916-224-047
- LINE：@ufv9089p