Wiki tự viết? LLM lo hết!

TL;DR

LLM Wiki Agent là một skill cho các coding agent (như Claude Code, Codex) giúp bạn tự động xây dựng một wiki kiến thức có cấu trúc từ tất cả tài liệu markdown bạn cung cấp. Nó giải quyết vấn đề quản lý thông tin, giúp kiến thức tích lũy và liên kết tự động, hông cần bạn tự tay sắp xếp hay viết lại.

Nói đơn giản: Như có một thư viện trưởng AI tự động đọc hết sách bạn mang về, sắp xếp lại thành một cuốn bách khoa toàn thư riêng cho bạn.

Tổng quan

LLM Wiki Agent là một skill độc đáo dành cho các coding agent như Claude Code, Codex hay Gemini CLI, được thiết kế để tự động xây dựng và duy trì một wiki kiến thức có cấu trúc. Thay vì bạn phải tự tay tổng hợp hay sắp xếp thông tin, agent này sẽ làm hết.

Cơ chế hoạt động khá đơn giản: bạn chỉ cần thả các tài liệu nguồn (dạng markdown như bài báo, ghi chú cuộc họp, chương sách) vào thư mục raw/, sau đó chạy lệnh /wiki-ingest. Agent sẽ tự động đọc, trích xuất kiến thức cốt lõi, tạo ra các trang thực thể (entities), khái niệm (concepts), và liên kết chúng lại thành một wiki bền vững. Mỗi khi bạn thêm tài liệu mới, wiki sẽ tự động cập nhật, trở nên phong phú và sâu sắc hơn.

Điểm đặc biệt là nó hông chỉ tạo ra các trang markdown mà còn dựng một biểu đồ kiến thức tương tác (graph.html) hiển thị mối quan hệ giữa các trang. Mọi thứ đều chạy local, hông cần server hay database phức tạp, và hoàn toàn miễn phí, open-source.

Xài vào việc gì?

Bạn đang nghiên cứu sâu một chủ đề trong nhiều tuần, đọc hàng tá paper, bài viết, report mà hông biết cách tổng hợp. Cứ wiki-ingest từng paper, từng bài viết một. Agent sẽ tự động tạo trang cho các nhà nghiên cứu, công ty (Meta AI, Google Brain) và khái niệm (Attention, RLHF). Sau đó dùng /wiki-query để hỏi về các chủ đề chính, xu hướng, hoặc chạy /wiki-lint để tìm lỗ hổng kiến thức. Kết quả là bạn có một tài liệu tham khảo có cấu trúc, liên kết chặt chẽ, thay vì một đống PDF hông bao giờ mở lại.

Bạn đang đọc một cuốn sách dày, muốn theo dõi sự phát triển của nhân vật, chủ đề hay các luận điểm của tác giả. wiki-ingest từng chương sách khi bạn đọc xong. Agent sẽ tự động tạo trang cho nhân vật, chủ đề. Dùng /wiki-query để hỏi về sự phát triển của nhân vật hay mâu thuẫn trong lập luận của tác giả. Bạn sẽ có một fan wiki riêng cho cuốn sách, tự động xây dựng khi bạn đọc, với agent làm hết việc cross-reference.

Bạn muốn xây dựng một hệ thống kiến thức cá nhân về mục tiêu, sức khỏe, thói quen, hay các bài học self-improvement. wiki-ingest các ghi chú nhật ký, bài viết về thói quen, tóm tắt sách. Dùng /wiki-query để tìm mẫu hình trong nhật ký về năng lượng hay kết quả của các thói quen đã thử. Wiki sẽ xây dựng một bức tranh có cấu trúc về bản thân bạn và các khái niệm như “Sleep”, “Exercise” được tích lũy bằng chứng từ mọi nguồn.

Đội nhóm của bạn có quá nhiều tài liệu: biên bản họp, roadmap sản phẩm, ghi chú cuộc gọi khách hàng, mà hông ai có thời gian tổng hợp. wiki-ingest các transcript họp, docs roadmap, ghi chú cuộc gọi. Dùng /wiki-query để hỏi về các yêu cầu tính năng phổ biến, quyết định quan trọng và lý do. Chạy /wiki-lint để phát hiện mâu thuẫn hay thiếu sót. Wiki sẽ luôn được cập nhật, vì agent làm hết việc bảo trì mà hông ai muốn làm.

Các điểm chính

• Kiến thức tích lũy, hông bị mất: Wiki bền vững, có cấu trúc markdown, hông như chat bot bị mất thông tin sau mỗi session.
  • Mọi thứ bạn ingest đều được lưu trữ và liên kết.
  • Hành động: Dùng nó để xây dựng một nguồn kiến thức sống, hông sợ mất context.
• Tự động tạo trang thực thể và khái niệm: Hông cần tự tay tạo trang cho người, công ty, ý tưởng.
  • Agent tự động nhận diện và tạo trang, cập nhật mỗi khi có nguồn mới nhắc đến.
  • Hành động: Giúp bạn tập trung vào nội dung mà hông lo cấu trúc.
• Tổng quan sống động: File wiki/overview.md tự động tổng hợp lại toàn bộ kiến thức hiện có.
  • Mỗi lần ingest tài liệu mới, overview sẽ được sửa đổi để phản ánh sự tổng hợp mới nhất.
  • Hành động: Luôn có cái nhìn tổng quát về mọi thứ bạn đã đọc.
• Phát hiện mâu thuẫn sớm: Khi có nguồn mới mâu thuẫn với thông tin cũ, agent sẽ báo cờ ngay.
  • Hông để mâu thuẫn bị chôn vùi đến lúc bạn query mới thấy.
  • Hành động: Đảm bảo tính nhất quán và độ tin cậy của wiki.
• Biểu đồ kiến thức trực quan: graph.html hiển thị mối quan hệ giữa các trang, cả rõ ràng lẫn ngầm định.
  • Giúp bạn dễ dàng hình dung cấu trúc kiến thức và các chủ đề liên quan.
  • Hành động: Dùng để khám phá các kết nối mới và hiểu sâu hơn về chủ đề.
• Báo cáo lỗi và đề xuất: wiki-lint tìm trang mồ côi, link hỏng, lỗ hổng dữ liệu và gợi ý nguồn bổ sung.
  • Giúp duy trì wiki sạch sẽ và đầy đủ.
  • Hành động: Dùng để chủ động cải thiện chất lượng wiki của mình.
• Khác biệt với RAG truyền thống: Hông chỉ tìm kiếm trên các đoạn văn bản thô.
  • Wiki Agent tổng hợp kiến thức một lần, duy trì liên tục, có cross-reference và phát hiện mâu thuẫn. RAG thường re-derive kiến thức mỗi lần query.
  • Hành động: Hiểu rõ sự khác biệt để chọn đúng công cụ cho việc quản lý kiến thức dài hạn.

Quick Start

1. Làm ngay tuần này: git clone repo LLM Wiki Agent, cài đặt agent (Claude Code, Codex…). Bỏ 1-2 tài liệu markdown quan trọng nhất của bạn vào thư mục raw/ và chạy /wiki-ingest.
2. Bước tiếp: Dùng lệnh /wiki-query để hỏi wiki về các chủ đề liên quan đến tài liệu bạn vừa ingest. Mở graph.html để xem biểu đồ kiến thức tự động được tạo ra.
3. Thói quen duy trì: Mỗi khi có tài liệu mới (bài báo, ghi chú họp, chương sách), hãy wiki-ingest ngay lập tức. Dùng /wiki-lint định kỳ để kiểm tra và cải thiện chất lượng wiki.

FAQ

• Cần API key hay setup Python hông? Hông cần. Agent này chạy hoàn toàn local, chỉ cần bạn có một trong các coding agent được hỗ trợ (Claude Code, Codex, Gemini CLI) là xài được liền.
• Nó khác gì với việc chỉ dùng chat bot để hỏi tài liệu? Khác nhiều. Chat bot thường “quên” sau mỗi session, hông có cấu trúc. Wiki Agent xây dựng một hệ thống kiến thức bền vững, có liên kết, tích lũy theo thời gian và phát hiện mâu thuẫn.
• Tôi có thể tùy chỉnh cách wiki hoạt động hông? Được. Bạn có thể chỉnh sửa các file schema như CLAUDE.md hoặc AGENTS.md để định nghĩa cách agent duy trì wiki, format trang, hay quy ước đặt tên cho phù hợp với nhu cầu riêng của mình.
• Làm sao để xem wiki sau khi ingest? Wiki được lưu dưới dạng các file markdown trong thư mục wiki/. Bạn có thể dùng các trình duyệt markdown như Obsidian để duyệt, theo dõi các liên kết và xem biểu đồ kiến thức graph.html trong bất kỳ trình duyệt web nào.