Medium 文章搬進 Sanity：AI 遷移的完整流程與驗收實錄

這次幫客戶把多年累積的 Medium 部落格（數十篇文章、數百張圖片）搬進新的內容管理系統 Sanity CMS。

一般的搬家服務，是把打包好的箱子從 A 搬到 B。搬完收款，至於裡面的東西有沒有少、有沒有放到對的位置，不在服務範圍內。

我用的不是這種方式，而是搭配整理收納服務的無痛搬家：搬之前先規劃好每個物件該放哪、怎麼放；搬完後確認物件悉數到位。這篇想記錄的，是這次搬家過程裡規劃的邏輯、踩到的問題，以及為什麼驗收在流程裡需要是標配而不是選配。

整理師視角下的搬家規劃

整理師工作的第一步不是開始打包，而是盤點。

這次的範圍確認起來還算清晰：數十篇正式發布的文章、完整的文章資訊（標題、副標題、發布時間、原始網址）、內文的所有格式結構，以及散落在 Medium 上的數百張圖片。工具選擇上，這次使用 Claude Cowork 來處理核心的自動化工作——讀取每篇文章的原始格式、轉換成新系統看得懂的結構、批次建立文件。

流程設計得很清楚。但清楚不代表不會有例外，而例外出現的地方，往往是當初規劃時沒有想到的邊角。

Claude Cowork 與 Claude Code：沒有好壞，只有適不適合

在討論這次遇到什麼問題之前，值得先說清楚工具選擇的邏輯。

Claude Cowork 的工作方式，比較像一個在對話裡幫你操作多個系統的助理——它能同時串接不同的工具、在同一個對話裡完成跨系統的任務。門檻低、協作方便，適合需要理解內容結構、做決策、少量互動的工作。

Claude Code 的工作方式則不同——它更像一個工程師，你給它一個任務，它去寫一段程式來執行。程式跑起來之後，資料的處理完全在程式本身，不受對話長度或單次處理量的限制。這對批次搬運大量資料的工作來說是關鍵優勢：數百張圖片的下載與上傳、逐篇仔細比對內容有沒有出錯，這些交給程式跑都沒有問題。

回頭來看，比較理想的分工是：Cowork 負責前期的規劃和原型——理解內容結構、設計轉換邏輯；一旦進入批次搬運階段，切換到 Claude Code 讓它寫程式來執行。

實際踩到的三個地雷

規劃時沒有完全預料到的狀況，最後出現了幾個：

大文件被靜靜截斷，沒有任何警告。 Cowork 在單次處理上有一定的容量上限。其中一篇內容特別長的文章，系統雖然回報建立成功，但實際上只搬進去了最前面的少數幾個段落，後面的內容全部不見了。發現之後改用另一種方式重新建立才正確完成。如果沒有驗收，這篇文章就會靜靜地缺了大半內容上線。

圖片下載失敗，原因有兩層。 一是這次使用的工具環境本身無法連到外部網站；二是 Medium 已經悄悄把圖片的存放位置換掉了，舊的連結全部失效。兩個問題疊在一起，最後用 Claude Code 另外寫了一段程式在本機補跑，並加入自動轉換舊連結的邏輯，數百張圖片才全數成功上傳。

第三方工具突然罷工。 搬運過程中原本設計用來修改已存在文件的功能，當下持續回傳錯誤，原因不明。這個工具是外部服務提供的，會自動更新，狀態不在任何人的控制範圍內。遇到這種情況只能找替代方案繞過——改用重建的方式處理。這是遷移流程設計裡值得注意的現實：外部工具不一定每次都正常運作，流程要有備案。

搬完不等於搬好：驗收是標準流程

事先準備的驗收腳本分三層進行：

• 第一層：確認每篇文章的基本資訊有沒有對上——標題、副標題、發布時間、原始網址
• 第二層：數一數每篇文章有幾個段落，快速篩出明顯的問題
• 第三層：逐段、逐字比對內文，包含每個連結、每個格式標記，以及圖片的每個細節。

第一輪：看見 Claude Cowork 留下的痕跡

先嘗試 Claude Cowork 搬了一輪後做初次驗收，發現超過一半的文章有錯誤，問題的範圍比預期廣——有的出現大量中文字損壞，字形相近但意思全變，單憑肉眼瀏覽根本不會察覺；有圖片連結被截斷或拼錯；有圖輯少上傳了一張圖；有標點符號被替換成外觀相似但實際上不同的字元；還有內部連結指向了錯誤的文章。

第二輪：Claude Code 修正，再驗一次

發現問題之後，交由 Claude Code 針對每一類差異撰寫修正腳本，逐篇比對原始資料、將錯誤的內容一一還原。修正完成後重跑驗收腳本，最終全部通過驗證。

這個過程說明了一件事：不是 Claude Cowork 做得好不好的問題，而是沒有驗收計畫，就等於默認接受任何結果。

無痛入住

搬家的終點，不是把箱子搬進新家，而是每件東西都回到它該在的位置，住起來跟以前一樣順，甚至更好。

數十篇文章格式完整、連結正確、圖片到位。從外部看，什麼都沒有變；但底層的架構已經不同了，往後的內容管理會更靈活，也不再受限於原本平台的規則。

整理師的價值不在搬得快，而在搬完之後客戶不需要自己去翻箱確認有沒有少東西。這件事聽起來理所當然，但要做到，需要的不只是工具，而是從一開始就把驗收納進計畫——知道要確認什麼、怎麼確認、發現問題時怎麼修。

多年累積的內容資產遷移，值得被認真對待。