finding-duplicate-functions

Tổng quan về skill finding-duplicate-functions

Skill finding-duplicate-functions giúp bạn phát hiện những hàm làm cùng một việc nhưng trông khác nhau về tên gọi hoặc cách triển khai. Skill này hữu ích nhất khi rà soát codebase do LLM tạo ra hoặc codebase tăng trưởng nhanh, nơi trùng lặp về mặt ý nghĩa tích tụ nhanh hơn trùng lặp kiểu copy-paste. Nếu bạn đang tìm finding-duplicate-functions for Code Review, skill này hướng tới các quyết định gộp lại hay giữ tách, chứ không phải soi lỗi lặt vặt về phong cách.

Skill này dùng để làm gì

Skill finding-duplicate-functions được xây dựng để nhận diện các trường hợp “ý định giống nhau, code khác nhau”: các helper chồng lấn chức năng, utilities bị viết lại, hoặc logic gần như tương đương bị rải rác ở nhiều file. Nó đặc biệt hữu ích trước các đợt refactor, trong các vòng dọn dẹp code, hoặc sau khi các công cụ phát hiện trùng lặp cú pháp như jscpd đã xử lý xong các bản sao y hệt.

Ai nên cài đặt skill này

Nên cài đặt skill finding-duplicate-functions nếu bạn review các repository JavaScript hoặc TypeScript có nhiều utility nhỏ, file được sinh tự động, hoặc nhiều người cùng đóng góp. Đây là lựa chọn rất hợp khi bạn muốn một cách nhất quán để quyết định hàm nào nên gộp, hàm nào nên giữ riêng, và hàm nào cần điều tra thêm.

Điều gì làm nó khác biệt

Điểm khác biệt chính là workflow hai bước: trước hết trích xuất các hàm, sau đó gom cụm theo ý định bằng phân tích LLM. Điều đó có nghĩa skill này được thiết kế để giảm phỏng đoán khi xử lý trùng lặp về mặt ngữ nghĩa, chứ không chỉ tìm các dòng giống nhau. Lợi ích thực tế là rút ngắn quãng đường từ cảm giác “đoạn code này có vẻ dư thừa” đến một kế hoạch gộp lại có thể đem ra review.

Cách dùng skill finding-duplicate-functions

Cài đặt và xác định workflow

Dùng đường dẫn cài đặt trong thư mục skill: npx skills add obra/superpowers-lab --skill finding-duplicate-functions. Sau khi cài xong, hãy bắt đầu từ skills/finding-duplicate-functions/SKILL.md, rồi đọc các script hỗ trợ trong skills/finding-duplicate-functions/scripts/ vì chúng định nghĩa chuỗi phân tích thực tế. Với một hướng dẫn về finding-duplicate-functions, các script này quan trọng hơn phần mô tả tổng quan.

Skill này cần input gì

Skill hoạt động tốt nhất khi bạn cung cấp một thư mục nguồn và một mục tiêu review cụ thể. Input tốt nên nêu rõ khu vực code, lý do phân tích, và các phần loại trừ. Ví dụ: “Scan packages/api/src để tìm các validation helpers bị trùng trước khi gộp auth flows; bỏ qua test files và chỉ báo cáo các ứng viên có độ tin cậy cao.” Như vậy sẽ tốt hơn nhiều so với chỉ nói “find duplicates” vì nó cho biết phạm vi, mục đích và kỳ vọng đầu ra.

Hãy đọc các file này trước

Ưu tiên đọc scripts/extract-functions.sh, scripts/categorize-prompt.md, scripts/find-duplicates-prompt.md, scripts/prepare-category-analysis.sh, và scripts/generate-report.sh. Những file này cho thấy đúng pattern sử dụng finding-duplicate-functions: trích xuất một catalog, phân loại hàm, chia theo từng category, chạy so sánh ngữ nghĩa, rồi tạo báo cáo. Nếu bạn chỉ muốn lướt một file, hãy đọc SKILL.md cùng scripts/extract-functions.sh để hiểu hình dạng input và các phần bị loại trừ.

Mẹo workflow làm thay đổi kết quả

Hãy coi bước phân loại là một bộ lọc, không phải phần phụ. Skill sẽ chính xác hơn khi các category nhất quán và đủ số lượng hàm để so sánh, vì việc phát hiện trùng lặp được chạy theo từng category. Mặc định loại trừ test thường là đúng cho công việc dọn dẹp production, nhưng hãy đưa test vào nếu mục tiêu review của bạn là shared test utilities hoặc fixture helpers. Dùng báo cáo được tạo ra như một danh sách rút gọn để người review xem lại, không phải như một kế hoạch refactor tự động.

FAQ về skill finding-duplicate-functions

Skill này có tốt hơn một prompt thông thường không?

Có, khi bạn cần một workflow lặp lại được để tìm intent trùng giữa các hàm thay vì chỉ một câu trả lời brainstorm dùng một lần. Một prompt thông thường có thể bỏ sót kiểm soát phạm vi, chọn file, và ngưỡng độ tin cậy. Skill finding-duplicate-functions cho bạn một workflow và cấu trúc đầu ra dễ lặp lại hơn trong code review.

Skill này có thay thế các công cụ phát hiện trùng lặp cú pháp không?

Không. Nó bổ trợ cho chúng. Công cụ cú pháp bắt được code bị sao chép; skill này bắt các hàm có ý nghĩa tương tự ngay cả khi phần triển khai khác nhau. Nếu codebase của bạn đã có vấn đề copy y hệt, hãy xử lý các lỗi đó trước để bước phân tích ngữ nghĩa tập trung đúng chỗ.

Skill này có thân thiện với người mới không?

Có, nếu bạn có thể chỉ nó vào một cây source và mô tả phần cần review. Điều người mới cần biết nhất là phát hiện trùng lặp được chia theo category và phụ thuộc vào biên input tốt. Nếu chưa chắc, hãy bắt đầu với một package hoặc một khu vực tính năng thay vì cả repository.

Khi nào không nên dùng skill này?

Không nên dùng khi bạn cần tư vấn kiến trúc tổng quát, sửa bug một lần, hoặc tóm tắt codebase ở mức rộng. Nó cũng là lựa chọn kém phù hợp nếu repository của bạn chủ yếu không phải code JS/TS, vì script trích xuất được thiết kế cho pattern hàm JavaScript và TypeScript. Nếu mục tiêu của bạn chỉ là tìm các bản sao y hệt, một công cụ phát hiện copy-paste đơn giản là đủ.

Cách cải thiện skill finding-duplicate-functions

Siết chặt phạm vi và làm rõ đích quyết định

Cải thiện lớn nhất đến từ việc thu hẹp bề mặt review và nói rõ hành động bạn muốn. Thay vì hỏi tìm mọi duplicate, hãy hỏi “các điểm có thể gộp trong src/utils với xu hướng ưu tiên các merge có độ tin cậy cao.” Cách này giúp việc dùng finding-duplicate-functions hiệu quả hơn vì mô hình có thể so sánh những hàm thực sự đang ở thế cạnh tranh với nhau.

Cung cấp các cặp đối chiếu phù hợp

Nếu bạn đã nghi ngờ một số cặp, hãy nêu chúng trong prompt như các ứng viên có thể trùng và giải thích vì sao chúng có thể khác nhau. Ví dụ: “So sánh parseUserInput, normalizeInput, và sanitizeInput; chúng có thể chồng lấn, nhưng một hàm xử lý HTML escaping.” Điều này giúp skill phân biệt duplicate thật với các helper liền kề chỉ dùng chung từ vựng.

Chú ý các kiểu lỗi thường gặp

Lỗi phổ biến nhất là gom quá rộng: các hàm tên giống nhau nhưng khác quy tắc nghiệp vụ bị gộp quá tay. Lỗi thứ hai là gom quá hẹp: các wrapper nhỏ bị coi là khác nhau dù thực ra chỉ khác về dạng tham số hoặc cách đặt tên. Trong cả hai trường hợp, hãy thêm ngữ cảnh về input, output, và hành vi mong đợi để việc review đánh giá được ý định chứ không chỉ độ giống bề mặt.

Lặp từ báo cáo đến refactor

Sau lần chạy đầu tiên, hãy dùng báo cáo để chọn một category và tự kiểm tra thủ công các nhóm có độ tin cậy cao nhất dựa trên source code. Nếu một nhóm còn lưng chừng, hãy siết category lại hoặc chạy lại với các dòng ngữ cảnh tốt hơn và ngưỡng khuyến nghị rõ hơn. Hướng dẫn finding-duplicate-functions tốt nhất là hướng dẫn mang tính lặp: dùng đầu ra ban đầu để tinh chỉnh phạm vi, rồi chạy lại trên lát cắt tiếp theo của codebase.