code-deduplication

code-deduplication 技能概覽

code-deduplication 技能能幫助 Claude 避免在既有函式、模組或模式已經能解決同一件事時，又重新生出新程式碼。這項技能特別適合那些持續新增「小型 helper」、共用工具函式，以及會慢慢演變成重複行為的重構修補的團隊。如果你的目標是做 Refactoring 的 code-deduplication，這項技能會引導模型先檢查現有內容，再決定延伸或重用，而不是重新發明一套。

code-deduplication 技能實際在做什麼

這項技能的核心是一份能力索引，通常是 CODE_INDEX.md，讓模型在寫任何新內容之前，先推理程式碼庫原本已經能做什麼。當你需要減少彼此重疊的 helper、讓共享抽象更乾淨，並降低那些以些微不同方式解同一問題的檔案之間的漂移時，它就很有用。

code-deduplication 的最佳適用情境

當你要新增工具函式、整併業務邏輯，或清理整個 repository 中重複的實作細節時，適合使用 code-deduplication 技能。尤其當一個 refactor 預期會碰到多個檔案，而你希望模型優先選擇擴充既有能力，而不是複製一份新實作時，它特別合適。

code-deduplication 技能的不同之處

和一般「幫我重構這段」的提示不同，這項技能加入了先檢查、後寫入的紀律，以及變更後的維護循環。它不只是少寫一點 code；更重要的是保住既有能力、把能力地圖畫清楚，並讓新 code 證明自己有存在的必要。

如何使用 code-deduplication 技能

在工作流程中安裝並啟用 code-deduplication

先透過你的 skill manager 走 code-deduplication install 路徑，之後在你要請求新共用程式碼或重構工作之前先套用它。repository 的 frontmatter 已經標示它不能由使用者直接呼叫，所以請把它視為背景工作流程技能：它支援 Claude 的規劃與撰寫過程，而不是一個你要直接執行的獨立命令。

先提供正確的專案上下文

在下提示之前，請提供模型目前的功能目標、相關檔案，以及如果你有的話，現成的索引。這項技能最適合在模型能夠拿「預期行為」去對照「現有行為」時使用。如果你只丟一個像「把這個弄乾淨一點」這種模糊要求，模型就沒有足夠資訊可靠地判斷重疊。

好用的提示詞形式

一個強而有力的 code-deduplication usage 提示，會點出你要的 capability、牽涉的檔案，以及重複的風險。例如：「重構 payment summary 流程。先確認 CODE_INDEX.md 是否已經涵蓋 formatting、rounding 與 tax calculation。若既有 helper 相符就直接重用；只有在能力不存在時才新增 function。」這樣給模型的是判斷規則，而不只是任務本身。

先讀這些檔案

先從 SKILL.md 開始，再查看任何專案層級的 CODE_INDEX.md 或等效的架構說明。如果 repository 已經有 utility map、dependency guide 或 refactor policy，也要先讀過再動手改 code。這項技能的價值，來自於提早發現可重用的機會，而不是等到實作已經開始後才回頭找。

code-deduplication 技能 FAQ

code-deduplication 只適合大型 codebase 嗎？

不是。小型 repository 也能受益，特別是當早期的重複一旦出現，之後就很難拆回去時。這項技能最有價值的情境，通常是某個「先隨便做一個 helper」最後一路長成三個幾乎同目的的 helper。

code-deduplication 跟一般 refactor 提示有什麼差別？

一般提示可能改善風格，卻不一定能避免重疊。code-deduplication 技能多了一道結構性檢查：先找出既有能力、再比對意圖、先重用或擴充，最後在寫完後更新索引。這也讓它比泛用的 rewrite 要求，更適合拿來做 Refactoring 的 code-deduplication。

初學者需要這項技能嗎？

需要，尤其是那些因為 existing code 不好找，所以常常乾脆直接新增 code 的人。這項技能透過強制先搜尋、再決定，可以降低不小心複製出重複實作的機率。如果 repository 沒有清楚結構，或團隊不願意維護能力索引，它就比較沒那麼有用。

什麼時候不該用它？

當你要做一次性的實驗、短暫的 spike，或是一個幾乎不可能和既有內容重疊的新能力時，就不要依賴它。在這些情況下，先檢查再寫入的流程可能只會拖慢你，卻不會讓結果更好。

如何改進 code-deduplication 技能

以 capability 層級來描述目標

你能做的最佳改進，是描述要完成的工作，而不是想要的檔案長相。比起說「加一個 helper」，更好的說法是「把報表中的日期解析標準化」。這能幫 code-deduplication 技能比較的是目的，而這正是它判斷是否能重用的依據。

盡早暴露既有重疊

提供那些看起來可疑地相似的函式、鄰近模組，或重複分支的例子。如果你已經知道兩個實作很接近，就把它們都點出來，並要求模型只選一個 owner。這可以降低第一次處理時不小心又造出一個新重複的機率。

要求明確的重用決策

一個強的 code-deduplication guide 請求，應該要求三件事：哪些既有 code 可以重用、哪些應該擴充、哪些真的需要新 code。這會讓輸出以決策為導向，而不是單純生成一段新內容。

第一輪完成後，連同索引一起迭代

模型寫完 code 之後，請它更新或草擬能力索引，讓下一次變更有更好的地圖。這項技能最常見的失敗模式，不是實作本身寫壞了，而是重構之後重用訊號消失。把索引維持最新，才是讓 code-deduplication 真正長久有效的關鍵。