Agent Docs for Markdown – ส่วนขยาย VS Code ที่เปลี่ยน Markdown ในเครื่องให้เป็น LLM Wiki สำหรับ AI Agent

ช่วงหลังมานี้ มีกระแสเพิ่มขึ้นในการจัดการความรู้ที่ AI Agent จะใช้งานให้อยู่ในรูปแบบ Markdown และไฟล์ เช่น LLM Wiki, Knowledge as Code และ Context Engineering

แม้ประสิทธิภาพของ LLM จะดีขึ้น แต่ถ้า Agent ไม่รู้ว่าควรอ่านเอกสารไหนก่อน เอกสารไหนคือเอกสารหลัก หรือเมื่อแก้ไขแล้วควรตรวจดูเอกสารใดร่วมกัน ผลลัพธ์ก็อาจไม่เสถียรได้ง่าย

ผมเองก็เคยเจอปัญหาคล้ายกันระหว่างจัดการโน้ตวิจัย เอกสารเทคนิค วิกิ และรายงานด้วย Markdown

เมื่อมีไฟล์ Markdown สะสมอยู่จำนวนมาก แล้วเปิดทั้งโฟลเดอร์ให้ AI Agent ใช้งานตรง ๆ ก็เกิดปัญหาต่อไปนี้

• พลาดเอกสารที่เชื่อมโยงกัน
• ตัดสินได้ยากว่าในบรรดาเอกสารที่คล้ายกัน เอกสารใดคือเอกสารหลัก
• ใช้งานลิงก์ที่เสียและเอกสารที่โดดเดี่ยวต่อไป
• ค้นรวมไปถึงไฟล์ผลลัพธ์จากการ build และไฟล์ตั้งค่า Agent
• หลังแก้ไขเอกสารหนึ่งฉบับ เนื้อหาในเอกสารที่เกี่ยวข้องกันกลับไม่สอดคล้องกัน

ด้วยเหตุนี้ ผมจึงสร้าง Agent Docs for Markdown ซึ่งเป็นส่วนขยาย VS Code ที่ช่วยจัดระเบียบโฟลเดอร์ Markdown ในเครื่องให้อยู่ในรูปแบบ LLM Wiki ที่ AI Agent เข้าใจได้

เป้าหมายไม่ใช่แค่เครื่องมือค้นหาหรือพรีวิว Markdown แต่คือการจัดการความสัมพันธ์ระหว่างเอกสารควบคู่ไปกับ workflow การทำงานของ Agent

ฟีเจอร์หลักมีดังนี้

• ทำดัชนีเอกสาร Markdown และความสัมพันธ์ของลิงก์เป็น Source Graph
• การสำรวจแบบ Focus / Hop ที่ขยายไปยังเอกสารที่เกี่ยวข้องโดยมีเอกสารหนึ่งเป็นศูนย์กลาง
• Workspace Cleanup Audit สำหรับค้นหาลิงก์เสีย เอกสารโดดเดี่ยว ผลลัพธ์ที่สร้างซ้ำ และรายการโฟลเดอร์ที่ควรยกเว้นจากการค้นหา
• ติดตั้งสกิล Agent เฉพาะสำหรับ Markdown ให้กับ Claude, Codex, Gemini, Cursor ฯลฯ
• ส่งออก Markdown เป็น HTML แบบ standalone และ HTML สำหรับบล็อก
• จัดการดัชนีและเอกสารทั้งหมดภายใน workspace ในเครื่อง

สกิลที่ให้มาด้วยถูกทำให้เรียบง่ายเป็น 2 บทบาท

• markdown-manager
  ค้นหาเอกสาร สำรวจ Source Graph ตรวจสอบลิงก์ พิจารณาเอกสารหลัก และตรวจสอบขอบเขตผลกระทบจากการแก้ไข

• markdown-writer
  ปรับโครงสร้างโน้ตวิจัยให้เป็นรายงานหรือบทความบล็อก และตรวจสอบผลลัพธ์การเรนเดอร์ก่อนส่งออกเป็น HTML

ตัวอย่างเช่น คุณสามารถสั่ง Agent ได้ดังนี้

“ก่อนแก้ไขเอกสารนี้ ช่วยบอกขอบเขตการอัปเดตที่ควรตรวจสอบร่วมกับเอกสารที่เชื่อมโยงกันด้วย”

“ช่วยหาใน Markdown workspace นี้ว่ามีลิงก์เสีย เอกสารโดดเดี่ยว และโฟลเดอร์ที่ควรยกเว้นจากการค้นหาอะไรบ้าง”

“ช่วยปรับโครงสร้างโน้ตวิจัยนี้ให้อยู่ในรูปแบบรายงานสำหรับผู้บริหาร และตรวจสอบการเรนเดอร์ HTML ให้ด้วย”

ใน VS Code เพียงเปิดโฟลเดอร์ Markdown เดิม แล้วสร้าง Source Graph จากแถบด้านข้าง Agent Docs ก็เริ่มทดลองใช้งานได้ทันที

ผมอยากรับฟีดแบ็กจากผู้ที่ต้องการเปลี่ยนโฟลเดอร์ Markdown จากที่เก็บเอกสารธรรมดา ให้เป็น LLM Wiki ในเครื่องที่ทั้งคนและ AI Agent อ่านและอัปเดตร่วมกัน

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