search-first

Tổng quan về skill search-first

search-first là gì

search-first là một quy trình làm việc “tìm hiểu trước khi code”, dùng để tìm các công cụ, thư viện và mẫu triển khai sẵn có trước khi bạn viết code tùy biến. Skill này hữu ích khi bạn muốn trợ lý đóng vai một người trinh sát cẩn trọng, chứ không phải một coder đoán mò rồi mới làm.

Ai nên dùng skill này

Hãy dùng search-first nếu bạn đang bắt đầu một tính năng mới, đánh giá một dependency, thêm một tích hợp, hoặc xây dựng một helper mà rất có thể đã tồn tại. Đây là lựa chọn rất phù hợp cho trường hợp search-first for Skill Scaffolding khi bạn muốn tái sử dụng các pattern đã được kiểm chứng thay vì tự nghĩ ra một cách mới.

Vì sao nó quan trọng

Giá trị lớn nhất của search-first nằm ở chất lượng quyết định: nó buộc trợ lý phải tìm trên npm, PyPI, GitHub, nguồn web và các skill liên quan trước khi đề xuất code. Nhờ vậy, bạn giảm được việc làm trùng, chọn dependency tốt hơn, và đưa ra quyết định “build vs adopt vs wrap” có cơ sở hơn.

Cách dùng skill search-first

Cài đặt và kích hoạt

Để search-first install, thêm skill bằng npx skills add affaan-m/everything-claude-code --skill search-first. Hãy kích hoạt nó khi bài toán nghe giống kiểu “thêm X”, “tìm một thư viện cho Y”, hoặc “đã có cách nào tốt hơn để làm việc này chưa?”. Mẫu search-first usage hiệu quả nhất khi bạn nói rõ là muốn nghiên cứu trước khi triển khai.

Đưa cho nó một brief có hình dáng của quyết định

Một brief yếu sẽ là: “build a file parser.” Một brief mạnh hơn sẽ là: “Need a TypeScript file parser for Node 18, must support streaming, no native deps, MIT license preferred, and I want 3 adopt-or-build options with tradeoffs.” Cách viết này cho skill đủ ngữ cảnh để tìm kiếm tốt và so sánh ứng viên, thay vì trả về các gợi ý chung chung.

Đọc đúng các file trước

Bắt đầu với SKILL.md, rồi xem tiếp README.md, AGENTS.md, metadata.json, và các thư mục rules/, resources/, references/, hoặc scripts/ nếu có. Trong repo này, SKILL.md là nguồn sự thật chính, nên bạn có thể đi nhanh mà không phải lục tung thêm các file phụ trợ.

Dùng workflow như một template prompt

Một prompt search-first guide thực dụng nên hỏi rõ: nhu cầu, ràng buộc, tìm kiếm ứng viên, tiêu chí đánh giá, và một quyết định dứt khoát. Ví dụ: “Research existing options for X, compare 3 candidates, score them on maintenance, docs, license, and fit, then recommend adopt, extend, or build custom.” Cấu trúc đó giúp tác nhân nghiên cứu trả ra đầu ra dùng được, thay vì chỉ là một danh sách rời rạc.

FAQ về skill search-first

search-first chỉ dành cho dự án lớn thôi sao?

Không. Nó thường hữu ích nhất cho những tác vụ nhỏ nhưng dễ âm thầm tạo ra tech debt, như một helper function, UI utility, hoặc quyết định về dependency. Cái giá của việc bỏ qua nghiên cứu thường cao nhất khi thay đổi nhìn có vẻ rất đơn giản.

Nó khác gì một prompt bình thường?

Một prompt bình thường có thể chỉ hỏi ý tưởng; còn search-first skill yêu cầu một workflow nghiên cứu và một quyết định. Khác biệt này quan trọng vì đầu ra được thiết kế để hỗ trợ quyết định có nên adopt hay không, chứ không chỉ trả lời “mình có thể code cái gì?”.

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

Có, nếu bạn mô tả được mục tiêu và ràng buộc của mình. Người mới được lợi vì skill này thu hẹp phạm vi tìm kiếm và gợi ra các lựa chọn sẵn có mà họ có thể chưa biết để tìm. Nó kém hữu ích hơn nếu bạn chỉ muốn có code ngay mà không cần phân tích tradeoff.

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

Hãy bỏ qua nó khi nhiệm vụ rõ ràng là custom, cần làm cực nhanh, hoặc chỉ mang tính nội bộ rất chặt với codebase của bạn và không có giải pháp bên ngoài nào thực sự phù hợp. Nếu bạn đã biết chính xác package hoặc pattern mình muốn, triển khai trực tiếp có thể nhanh hơn so với một cuộc tìm kiếm đầy đủ.

Cách cải thiện skill search-first

Cung cấp các ràng buộc làm thay đổi kết quả tìm kiếm

Chất lượng tăng mạnh nhất khi bạn nêu rõ các ràng buộc cứng ngay từ đầu: ngôn ngữ, runtime, framework, license, kích thước bundle, quy tắc bảo mật, giới hạn nền tảng, và việc có cho phép native dependencies hay không. Những chi tiết này giúp skill lọc ứng viên thay vì chỉ đưa ra các lựa chọn phổ biến nhưng không dùng được.

Yêu cầu so sánh, không chỉ là khuyến nghị

Một yêu cầu search-first usage tốt hơn sẽ đòi một shortlist ngắn kèm khuyến nghị và lý do. Ví dụ: “Compare 3 libraries, explain why each may fail, then choose one for production and one fallback.” Cách này tạo ra nghiên cứu có tính hành động hơn nhiều so với một câu trả lời chỉ nêu một tên duy nhất.

Cảnh giác với thiên lệch thích cái mới

Một lỗi phổ biến là chọn dự án mới nhất hoặc nổi bật nhất mà không kiểm tra độ duy trì, tài liệu, hoặc chi phí tích hợp. Hãy cải thiện search-first skill bằng cách yêu cầu nó nêu thêm friction khi adopt, mức độ phù hợp với hệ sinh thái, và điều gì sẽ khiến bạn loại một ứng viên.

Lặp lại sau lần đầu

Nếu kết quả đầu tiên còn quá rộng, hãy siết prompt tiếp theo bằng một ràng buộc còn thiếu hoặc một kiểm thử chấp nhận. Với search-first for Skill Scaffolding, điều đó có thể là thêm ngôn ngữ đích, cấu trúc repo, hoặc đúng loại scaffold bạn muốn tái sử dụng.