Tìm tài liệu hiện hành với ak:docs-seeker

Dùng ak:docs-seeker để tìm tài liệu thư viện hoặc framework hiện hành từ một topic cụ thể hay yêu cầu tổng quát. Skill phân loại query, truy xuất index llms.txt qua Context7 khi có, mở các trang tài liệu liên quan nhất và báo cáo finding kèm nguồn.

Chọn ak:docs-seeker cho tài liệu bên ngoài

Dùng ak:docs-seeker khi

• Bạn cần tài liệu API, configuration, installation hoặc feature hiện hành.
• Phiên bản thư viện quan trọng và bạn cần source khớp với phiên bản đó.
• Index tài liệu chính thức có thể thu hẹp web search rộng.
• Tài liệu chưa đầy đủ và bạn cần fallback sang repository code được ghi nhãn rõ.

Chọn workflow khác khi

• Bạn cần fact trong project hiện tại. Dùng ak:scout.
• Bạn đã có source file và muốn một repository bundle dễ review. Dùng ak:repomix.
• Bạn cần lập luận research từ nhiều nguồn thay vì tài liệu thư viện. Dùng ak:research hoặc chuẩn bị brief tái sử dụng với ak:research-prompt.
• Bạn cần sửa tài liệu project. Dùng ak:docs sau khi thu thập source evidence.

Chuẩn bị query và runtime

Trước khi bắt đầu:

• Hoàn thành Làm quen và xác nhận Engineer Kit đã được cài cho đúng runtime cùng scope.
• Nêu library, topic, version mong muốn, ngôn ngữ đích và câu hỏi tài liệu phải trả lời.
• Ưu tiên input công khai. Loại tên repository riêng tư, token, dữ liệu khách hàng và code mật trừ khi cần thiết và đã được duyệt.
• Quyết định có cho phép network access, clone repository và tạo local bundle khi không có documentation index hay không.

Chạy Skill

/ak:docs-seeker "API cache invalidation của Next.js 16. Dùng source chính thức đúng version, cite mọi behavior claim và không clone repository."

/ak:docs-seeker "API cache invalidation của Next.js 16. Dùng source chính thức đúng version, cite mọi behavior claim và không clone repository."

$ak:docs-seeker "API cache invalidation của Next.js 16. Dùng source chính thức đúng version, cite mọi behavior claim và không clone repository."

Skill nhận library name và topic tùy chọn dưới dạng free-form input, không có mode flag được công bố. Yêu cầu theo topic đi theo đường ngắn nhất; yêu cầu tổng quát có thể trả về index lớn hơn cần được ưu tiên hóa.

Dạng thực thi dự kiến

Detector và index analyzer đi kèm chạy cục bộ và in JSON. Fetcher gửi HTTPS request tới context7.com, tùy chọn dùng CONTEXT7_API_KEY, rồi in fetched content trong JSON. Chúng không ghi cache hay tệp llms.txt trừ khi workflow xung quanh redirect hoặc lưu output rõ ràng.

Theo đường bằng chứng

1. Skill phân loại query. Nó trích library cùng topic ngắn hoặc coi yêu cầu là tổng quát.
2. Skill lấy index. Context7 lookup theo topic fallback sang general library lookup khi topic endpoint không có.
3. Skill ưu tiên trang. Getting-started và installation được nhóm riêng với API guide, advanced material, migration note và supplementary source khác.
4. Skill mở tài liệu chính. Finding phải đến từ official page đúng version được index liên kết, không chỉ từ tiêu đề index.
5. Skill fallback có chủ đích. Khi thiếu official docs, Skill có thể xem official repository và ghi nhãn claim suy ra từ README, test, example hay code.
6. Skill tổng hợp có citation. Mỗi behavior hoặc version claim trỏ đến trang hỗ trợ nó; conflict và khoảng trống tài liệu vẫn hiện rõ.

Giữ truy cập source an toàn

• Environment lookup có thể đọc .env tại cấp Skill, shared-Skills và runtime; process environment có độ ưu tiên cao nhất. Không in hoặc cite token value.
• CONTEXT7_API_KEY là tùy chọn cho fetcher. GITHUB_TOKEN và GEMINI_API_KEY có trong environment example nhưng core script detect, fetch và analyze không yêu cầu chúng.
• Clone repository, checkout tag, cài Repomix global và ghi repomix-output.xml là external hoặc persistent effect. Xin duyệt và dùng destination có giới hạn trước khi thực hiện.
• Public web access vẫn có thể dùng provider quota. External model, paid API hoặc agent distribution rộng cần cost approval riêng.
• Không trình bày community tutorial ngang với official versioned docs. Khi source xung đột, chỉ ra conflict và giải thích authority đã chọn.

Xác minh kết quả

Kết quả hoàn chỉnh phải nêu library cùng version, phân biệt direct documentation với code inference, liên kết từng primary source, tóm tắt câu trả lời cho topic, ghi fallback và xác định khoảng trống chưa giải quyết. Nếu repository được clone hoặc pack, kết quả cũng phải báo destination, generated bundle, cleanup status và disk impact.

Test đi kèm bao phủ normalize và classify query, dựng Context7 URL, parse cùng nhóm ưu tiên URL và gợi ý distribution. Chúng không chứng minh live provider khả dụng hay trang lấy về đúng với release được hỏi.

Khắc phục sự cố hoặc tiếp tục

Biết các giới hạn hiện tại

• Query classification dựa trên pattern và có thể phân loại sai câu mơ hồ.
• Coverage, độ mới của trang, rate limit và linked URL trên Context7 là external state; xác minh claim quan trọng với official page.
• Repository analysis là code-based evidence, không thay thế documented public contract.
• Gợi ý thời gian và số agent trong source là projection, không phải bảo đảm hay parallelism bắt buộc.
• Stable và beta đóng package script cùng workflow ak:docs-seeker giống nhau.