code-deduplication

Tổng quan về kỹ năng code-deduplication

Kỹ năng code-deduplication giúp Claude tránh tạo thêm code mới khi một function, module hoặc pattern sẵn có đã giải quyết cùng một việc. Đây là lựa chọn phù hợp nhất cho các team thường xuyên thêm logic “helper nhỏ”, shared utilities và các patch refactor rồi dần dần biến thành hành vi trùng lặp. Nếu mục tiêu của bạn là code-deduplication cho Refactoring, kỹ năng này sẽ thúc đẩy model kiểm tra những gì đã có trước, rồi mở rộng hoặc tái sử dụng thay vì làm lại từ đầu.

Kỹ năng này thực sự làm gì

Kỹ năng này tập trung vào một capability index, thường là CODE_INDEX.md, để model suy luận về những gì codebase đã làm được trước khi viết thêm bất kỳ thứ gì mới. Nhờ vậy, nó đặc biệt hữu ích khi bạn muốn giảm số lượng helper chồng lấn, làm các abstraction dùng chung gọn hơn và hạn chế tình trạng các file giải quyết cùng một vấn đề nhưng ngày càng lệch nhau ở chi tiết.

Trường hợp sử dụng phù hợp nhất

Hãy dùng code-deduplication skill khi bạn đang thêm utility function, gom logic nghiệp vụ lại, hoặc dọn dẹp các chi tiết triển khai lặp đi lặp lại trong một repository. Kỹ năng này đặc biệt hữu ích khi một lần refactor dự kiến sẽ chạm tới nhiều file và bạn muốn model ưu tiên mở rộng thay vì nhân bản.

Điểm khác biệt của kỹ năng này

Khác với một prompt chung kiểu “refactor đoạn này”, kỹ năng này thêm vào kỷ luật kiểm tra trước khi viết và một vòng lặp bảo trì sau khi thay đổi. Mục tiêu không chỉ là viết ít code hơn; mà là giữ lại năng lực hiện có, map chúng một cách rõ ràng và buộc code mới phải tự chứng minh sự cần thiết của nó.

Cách dùng kỹ năng code-deduplication

Cài đặt và kích hoạt trong quy trình làm việc

Dùng đường dẫn code-deduplication install từ skill manager của bạn, rồi áp dụng nó trước khi yêu cầu viết shared code mới hoặc thực hiện refactoring. Frontmatter của repository đánh dấu đây là skill không thể gọi trực tiếp bởi người dùng, vì vậy hãy xem nó như một skill hỗ trợ nền cho workflow: nó hỗ trợ quá trình lập kế hoạch và viết code của Claude, chứ không phải một lệnh độc lập để bạn chạy trực tiếp.

Bắt đầu với đúng ngữ cảnh dự án

Trước khi prompt, hãy cung cấp cho model mục tiêu tính năng hiện tại, các file liên quan và capability index hiện có nếu bạn có. Kỹ năng này hoạt động tốt nhất khi nó có thể so sánh hành vi mong muốn với những gì đã tồn tại. Nếu bạn chỉ đưa một yêu cầu mơ hồ như “làm cho nó gọn hơn”, model sẽ có quá ít thông tin để phát hiện phần trùng lặp một cách đáng tin cậy.

Kiểu prompt cho kết quả tốt

Một code-deduplication usage prompt tốt sẽ nêu rõ capability bạn cần, các file liên quan và rủi ro trùng lặp. Ví dụ: “Refactor luồng payment summary. Trước tiên hãy kiểm tra xem CODE_INDEX.md đã bao phủ formatting, rounding và tax calculation chưa. Tái sử dụng helper hiện có nếu khớp; chỉ thêm function mới nếu capability đó chưa tồn tại.” Cách này cho model một quy tắc ra quyết định, chứ không chỉ là một nhiệm vụ.

Đọc các file này trước

Hãy bắt đầu với SKILL.md, sau đó kiểm tra bất kỳ CODE_INDEX.md ở cấp project hoặc ghi chú kiến trúc tương đương nào. Nếu repository đã có utility map, dependency guide hoặc refactor policy, hãy đọc chúng trước khi chỉnh sửa code. Giá trị của kỹ năng này phụ thuộc vào việc phát hiện cơ hội tái sử dụng sớm, chứ không phải sau khi triển khai đã bắt đầu.

Câu hỏi thường gặp về code-deduplication skill

Kỹ năng này chỉ dành cho codebase lớn thôi sao?

Không. Repository nhỏ cũng được lợi, nhất là khi việc trùng lặp hình thành sớm rồi về sau rất khó gỡ. Kỹ năng này hữu ích nhất khi một “helper nhanh” có xu hướng biến thành ba helper nữa với gần như cùng một mục đích.

Kỹ năng này khác gì một prompt refactor thông thường?

Một prompt thông thường có thể cải thiện style mà không ngăn được overlap. code-deduplication skill thêm một bước kiểm tra mang tính cấu trúc: xác định capability hiện có, đối chiếu mục tiêu, tái sử dụng hoặc mở rộng trước, rồi cập nhật index sau khi viết. Vì vậy nó phù hợp hơn cho code-deduplication cho Refactoring so với một yêu cầu rewrite chung chung.

Người mới có cần kỹ năng này không?

Có, nếu họ thường xuyên viết code mới chỉ vì code hiện có khó tìm. Kỹ năng này có thể giảm duplication vô tình bằng cách buộc phải có bước tìm kiếm rồi quyết định. Nó sẽ kém hữu ích hơn nếu repository không có cấu trúc rõ ràng hoặc không ai sẵn sàng duy trì capability index.

Khi nào thì không nên dùng?

Đừng dựa vào nó khi bạn cần thử nghiệm một lần, một spike tạm thời, hoặc một capability mới mà gần như không có phần giao nhau thực tế. Trong những trường hợp đó, quy trình kiểm tra trước khi viết có thể làm chậm bạn mà không cải thiện kết quả.

Cách cải thiện kỹ năng code-deduplication

Đưa ra mục tiêu ở cấp capability

Cải thiện tốt nhất bạn có thể làm là mô tả việc cần làm, chứ không phải hình dạng file mong muốn. Hãy nói “standardize date parsing across reports” thay vì “add a helper.” Cách này giúp code-deduplication skill so sánh theo mục đích, và đó là cách nó quyết định liệu có thể tái sử dụng hay không.

Làm lộ phần chồng lấn sớm

Hãy đưa ví dụ về các function gần giống nhau, các module nằm gần nhau hoặc các nhánh lặp lại đáng ngờ. Nếu bạn đã biết hai implementation khá giống nhau, hãy nêu cả hai và yêu cầu model chọn một nơi chịu trách nhiệm duy nhất. Điều này giảm khả năng lần chạy đầu tiên vô tình tạo ra một bản sao mới.

Yêu cầu quyết định tái sử dụng thật rõ

Một yêu cầu mạnh cho code-deduplication guide nên hỏi ba điều: code hiện có nào có thể tái sử dụng, phần nào nên mở rộng, và phần nào thực sự cần code mới. Như vậy đầu ra sẽ mang tính ra quyết định thay vì chỉ sinh nội dung.

Lặp lại với index sau lần đầu

Sau khi model viết code, hãy yêu cầu nó cập nhật hoặc soạn lại capability index để lần thay đổi tiếp theo có bản đồ tốt hơn. Điểm thất bại chính của kỹ năng này không phải là implementation kém; mà là tín hiệu tái sử dụng bị mất sau refactor. Giữ index luôn cập nhật chính là điều giúp code-deduplication bền vững.