Aevum Markdown Manager: Biến Tài Liệu Thành "Bản Đồ Chỉ Đường" Cho Agentic AI
Trong kỷ nguyên của Agentic AI, thách thức lớn nhất của các kỹ sư phần mềm khi làm việc với AI không phải là năng lực code của model, mà là Context Stability (Sự ổn định của ngữ cảnh). Khi AI mất đi ngữ cảnh, chúng dễ dàng bị "ảo giác" (hallucination) hoặc code chệch hướng.
Aevum giải quyết triệt để bài toán này bằng cách biến các file Markdown (.md) tĩnh thành một External Brain (Bộ não ngoài) động trực quan, đóng vai trò cầu nối giao tiếp hoàn hảo giữa Lập trình viên và Biệt đội AI (Squad Mode).
Hãy cùng khám phá các tính năng cốt lõi và những Pro-Tips giúp bạn làm chủ hệ thống quản lý Markdown siêu việt của Aevum!
5 Trụ Cột Cốt Lõi Của Hệ Thống Markdown Aevum
1. Step Grammar v3.0 – Cú Pháp Hoá Task List
Aevum mở rộng cú pháp checklist tiêu chuẩn của Markdown (- [ ]) thành một hệ thống trạng thái phong phú giúp AI hiểu rõ tiến độ thực thi:
Trạng thái nâng cao:
- [/]In Progress: Task đang chạy (nhấp nháy icon Play, đổi màu động).- [!]Blocked: Task bị nghẽn (hiển thị icon cấm, tone màu đỏ cảnh báo).- [~]Skipped: Bỏ qua task (chữ gạch ngang, mờ 50%).- [?]Needs Review: Chờ review (icon con mắt, màu cam).
Step Type Badges: Phân loại rõ ràng tính chất công việc bằng cách gắn nhãn như
[CODE],[CMD],[GATE],[AUTO],[TEST],[DOC],[DEPLOY],[REVIEW](ví dụ:- [ ] [CODE] Viết API Controller).Ước lượng thời gian & Evidence:
[Est: 2h]tự động tạo badge kèm icon đồng hồ bấm giờ (⏱).[Evidence: pending]hoặc[Evidence: filepath]hỗ trợ theo dõi bằng chứng xác thực của task.
File Anchor Links: Định dạng
[src/utils/file.ts:L45-50]sẽ được render thành một nút liên kết trực tiếp, click vào là editor tự mở đúng file và dòng code đó.
2. Glassmorphic Header & Progress Meter
Mỗi khi bạn mở Markdown Preview, Aevum sẽ parse phần YAML Frontmatter để dựng lên một thanh điều hướng mờ kính cường lực (Glassmorphism) phía trên cùng:
Hiển thị chi tiết Plan Name, Domain, Feature, Status và Author.
Tích hợp Vòng tiến độ SVG tự động tính toán % hoàn thành của Plan theo thời gian thực (các task
donetính 100%,in-progresstính 50%).
3. Squad Dock & Mini Chat Tích Hợp
Squad Dock: Hiển thị avatar của các Agent đang cùng phụ trách Plan ( Luna, Mentor, v.v.). Đèn trạng thái online/offline và hiệu ứng "scanning" sẽ nhấp nháy khi Agent đang thực thi tác vụ.
Mini Chat: Ô chat nhỏ gọn được nhúng trực tiếp ngay trên Preview để bạn có thể gõ câu lệnh hoặc ra đề bài trực tiếp cho AI mà không cần chuyển sang tab chat khác.
4. Mermaid Diagram Mượt Mà
Aevum tự động render các khối code Mermaid (graph, sequenceDiagram, classDiagram) thành các sơ đồ kiến trúc SVG trực quan sắc nét. Bạn có thể hover để phóng to, thu nhỏ hoặc click để xem ở chế độ full-screen modal cực kỳ tiện lợi.
5. Self-Healing Review Markers (Cơ Chế Tự Phục Hồi)
Khi review code, các marker được lưu trữ dưới dạng JSON tọa độ dòng. Khi bạn chỉnh sửa tài liệu khiến dòng code bị dịch chuyển, thuật toán Self-Healing của Aevum sẽ tự động dò tìm (fuzzy-search) cụm text liên quan và cập nhật lại số dòng mới nhất mà không làm đứt gãy marker.
Top 5 Tips "Master" Markdown Management Trong Aevum
1️⃣ Khai Thác Triệt Để Step Grammar v3.0
Đừng viết task list một cách chung chung. Hãy viết theo cấu trúc chuẩn để AI dễ dàng đọc hiểu và thực thi tự động:
markdown- [/] [CODE] Thiết kế database schema cho domain Auth [Est: 1h] [src/db/schema.ts]
- [ ] [TEST] Viết Unit Test cho Auth Service [Est: 30m] [tests/auth.test.ts]
- [ ] [REVIEW] Kiểm tra bảo mật endpoint đăng ký [Evidence: pending]
2️⃣ Tận Dụng Click-To-Open File Badge
Thay vì phải thủ công mở cấu trúc thư mục để tìm file, hãy đặt đường dẫn file dạng [path/to/file.ts:L10-L20] ngay sau mô tả task. Bạn và AI chỉ cần một cái click chuột để truy cập trực tiếp vùng code đích.
3️⃣ Cập Nhật "Vibe" Dự Án Qua Hệ Thống Cảm Xúc
Hệ thống Aevum Markdown liên kết chặt chẽ với Vibe Session Global.
Nếu log chat xuất hiện nhiều từ khóa như
error,failed,bug, header của preview sẽ đổi sang màu đỏ cảnh báo (Alert).Khi mọi thứ trơn tru như
success,done,fixed, giao diện chuyển sang xanh lục mát mắt (Calm). Hãy tận dụng điều này để đánh giá nhanh "sức khỏe" tinh thần của toàn dự án chỉ qua một cái nhìn lướt qua preview.
4️⃣ Giao Tiếp Trực Tiếp Tại Preview Với Mini Chat
Đang đọc tài liệu thiết kế và phát hiện một điểm cần chỉnh sửa? Click vào avatar của Agent tương ứng trên Squad Dock, ô Mini Chat sẽ xuất hiện giúp bạn đưa ra yêu cầu ngay tại chỗ:
"@Luna, sửa lại font chữ của nút Submit trong CSS sang màu HSL xanh mint nhé."
5️⃣ Thiết Lập Bằng Chứng Thực Thi (Evidence-Driven)
Hãy yêu cầu AI chụp bằng chứng thực thi sau khi hoàn thành task:
Điền cú pháp
[Evidence: auto-verified]để AI tự động đánh dấu khi vượt qua test suite.Việc liên kết bằng chứng này giúp ngăn ngừa việc AI báo cáo "láo" (nói đã làm xong nhưng thực tế chưa chạy code).
Lời Kết
Với hệ thống Markdown của Aevum, tài liệu dự án của bạn không còn là những dòng chữ chết nằm im lìm. Nó trở thành trung tâm chỉ huy sống động, nơi con người và AI cùng nhìn về một hướng, cùng cập nhật trạng thái và cùng cộng tác mượt mà từng dòng code.
