Agent Docs for Markdown – Tiện ích VS Code biến Markdown cục bộ thành LLM Wiki cho AI agent

Gần đây, xu hướng quản lý tri thức mà AI agent có thể sử dụng dưới dạng Markdown và tệp đang ngày càng tăng, như LLM Wiki, Knowledge as Code, Context Engineering.

Ngay cả khi hiệu năng của LLM được cải thiện, nếu agent không biết nên đọc tài liệu nào trước, tài liệu nào là tài liệu chuẩn, hay khi chỉnh sửa thì cần kiểm tra kèm những tài liệu nào, kết quả rất dễ dao động.

Tôi cũng gặp vấn đề tương tự khi quản lý ghi chú nghiên cứu, tài liệu kỹ thuật, wiki và báo cáo bằng Markdown.

Có rất nhiều tệp Markdown tích lũy lại, nhưng khi mở nguyên thư mục cho AI agent, các vấn đề sau xuất hiện.

• Bỏ sót các tài liệu có liên kết với nhau
• Khó phán đoán tài liệu nào là tài liệu chuẩn trong số các tài liệu tương tự
• Vẫn sử dụng các liên kết hỏng và tài liệu bị cô lập
• Tìm kiếm cả kết quả build và tệp cấu hình agent
• Sau khi chỉnh sửa một tài liệu, nội dung giữa các tài liệu liên quan trở nên không nhất quán

Vì vậy tôi đã tạo Agent Docs for Markdown, một tiện ích mở rộng VS Code giúp sắp xếp thư mục Markdown cục bộ thành dạng LLM Wiki mà AI agent có thể hiểu.

Đây không chỉ là công cụ tìm kiếm hay xem trước Markdown, mà hướng tới việc quản lý đồng thời mối quan hệ giữa các tài liệu và quy trình làm việc của agent.

Các tính năng chính như sau.

• Lập chỉ mục tài liệu Markdown và quan hệ liên kết dưới dạng Source Graph
• Duyệt Focus / Hop để mở rộng các tài liệu liên quan xoay quanh một tài liệu cụ thể
• Workspace Cleanup Audit để tìm liên kết hỏng, tài liệu bị cô lập, artifact trùng lặp và ứng viên cần loại khỏi tìm kiếm
• Cài đặt kỹ năng agent chuyên cho Markdown vào Claude, Codex, Gemini, Cursor, v.v.
• Xuất Markdown thành HTML độc lập và HTML dùng cho blog
• Quản lý toàn bộ chỉ mục và tài liệu trong workspace cục bộ

Các kỹ năng đi kèm được đơn giản hóa thành hai vai trò.

• markdown-manager
  Tìm kiếm tài liệu, duyệt Source Graph, kiểm tra liên kết, xác định tài liệu chuẩn và kiểm tra phạm vi ảnh hưởng khi chỉnh sửa.

• markdown-writer
  Tái cấu trúc ghi chú nghiên cứu thành báo cáo hoặc bài viết blog, và kiểm tra kết quả render trước khi xuất HTML.

Ví dụ, bạn có thể yêu cầu agent như sau.

“Hãy cho tôi biết phạm vi cập nhật cần kiểm tra cùng với các tài liệu liên kết trước khi chỉnh sửa tài liệu này.”

“Hãy tìm các liên kết hỏng, tài liệu bị cô lập và những thư mục nên loại khỏi tìm kiếm trong workspace Markdown này.”

“Hãy tái cấu trúc ghi chú nghiên cứu này thành dạng báo cáo cho lãnh đạo và kiểm tra cả phần render HTML.”

Bạn có thể mở thư mục Markdown hiện có trong VS Code, tạo Source Graph từ sidebar Agent Docs và bắt đầu dùng ngay.

Tôi muốn nhận phản hồi từ những ai muốn biến thư mục Markdown không chỉ là nơi lưu trữ tài liệu đơn thuần, mà thành một LLM Wiki cục bộ để con người và AI agent cùng đọc và cập nhật.

GitHub:
https://github.com/sungreong/agent-docs-for-markdown