SlideOps: Biến kho code thành bài thuyết trình "sống" — tự động phát hiện tài liệu sai lệch chỉ trong mili giây

SlideOps là một công cụ mã nguồn mở mới ra mắt, cung cấp bộ kỹ năng (Agent Skills) cho Claude Code và các trợ lý lập trình tương thích, cho phép tạo bài thuyết trình chuyên nghiệp trực tiếp từ mã nguồn. Điểm nhấn đặc biệt là khả năng kiểm tra độ chính xác theo thời gian thực — nếu code thay đổi, công cụ sẽ nhanh chóng xác định slide nào đã "lệch" và đề xuất cách sửa, giúp tài liệu kỹ thuật luôn đồng bộ với thực tế.

Với phương châm "tài liệu là một sản phẩm xây dựng từ code", SlideOps hứa hẹn giải quyết bài toán kinh niên của các nhóm phát triển: viết tài liệu không khó, giữ cho tài liệu đúng mới là thử thách. Công cụ này đang thu hút sự chú ý của cộng đồng công nghệ như một giải pháp mới cho quy trình DevOps và quản lý tri thức nội bộ.

Tài liệu kỹ thuật: "Build artifact" thay vì "bài viết tĩnh"

Trong thực tế phát triển phần mềm, một vấn đề nan giải là tài liệu hướng dẫn, kiến trúc hoặc vận hành thường nhanh chóng trở nên lỗi thời. Một slide trình bày "chúng tôi chạy hai lần migration cơ sở dữ liệu" có thể vẫn tồn tại trên wiki cả năm sau khi con số thực tế đã lên tới mười lần.

SlideOps giải quyết vấn đề này bằng cách áp dụng triết lý "Generated code" vào tài liệu. Mỗi slide được tạo ra đều "ghi nhớ" nguồn gốc từ phần nào của code. Khi mã nguồn thay đổi, công cụ sẽ đối chiếu lại và đưa ra cảnh báo.

Bài viết về lý do đằng sau dự án có tựa đề: "Tài liệu của bạn là một build artifact — hãy bắt đầu đối xử với nó như vậy".

Cách hoạt động: Từ yêu cầu tới slide, rồi tự động "bảo trì"

Tạo slide nhanh chóng chỉ với một câu lệnh

Người dùng có thể mở một kho lưu trữ (repository) bất kỳ và yêu cầu:

💬 Tạo slide về repository này

SlideOps sẽ quét toàn bộ mã nguồn, sau đó đưa ra một bộ câu hỏi ngắn về chủ đề (kèm gợi ý cụ thể tìm thấy trong code), đối tượng người xem, độ dài, chủ đề thiết kế và các yêu cầu thêm. Người dùng duyệt qua dàn ý trước khi công cụ viết bất kỳ HTML nào.

Nếu đã rõ yêu cầu, người dùng có thể bỏ qua phần hỏi đáp:

💬 Phân tích sâu về hệ thống xác thực, chủ đề Ledger Dark, 15 slide, kèm PDF

Kiểm tra "độ tươi mới" — Phát hiện sự sai lệch chỉ trong mili giây

Điểm độc đáo nhất của SlideOps nằm ở khả năng Freshness Checking. Script scripts/check.py quét toàn bộ thư mục slide và báo cáo các slide nào trích dẫn (cite) đến code đã thay đổi, di chuyển hoặc biến mất. Đáng chú ý, công cụ này không sử dụng mô hình AI, không cần mạng, không tiêu tốn token — chỉ dùng thư viện chuẩn của Python và chạy trong mili giây.

Khi cần, công cụ sẽ:

• Tái trích dẫn các phần chỉ đơn thuần thay đổi vị trí.
• Đánh dấu các slide có nội dung có thể không còn đúng.
• Sửa chữa các slide bị lệch thay vì tạo lại toàn bộ, giữ nguyên nhịp điệu và cấu trúc câu chuyện mà người dùng đã duyệt lần đầu.

Những tính năng nổi bật khác

• Một file HTML độc lập cho mỗi bài thuyết trình: Không cần bước build, không phụ thuộc CDN, hoạt động ngoại tuyến và có thể gửi qua email.
• Điều hướng linh hoạt: Phím mũi tên, click để chuyển slide, hỗ trợ URL hash deep link, lưới tổng quan khi nhấn Esc, và ghi chú diễn giả (phím N) không bao giờ hiển thị trong ảnh chụp màn hình.
• 13 mẫu slide đa dạng: Tiêu đề, chương mục, văn bản + thẻ, bảng tham chiếu, code trước/sau, sơ đồ luồng, so sánh, chat bubbles, kết luận...
• 4 chủ đề thiết kế (theme): Ledger Light (mặc định), Ledger Dark, Midnight, Graphite. Tất cả màu sắc được sinh ra từ một khối token :root duy nhất, giúp việc đổi theme cực kỳ đơn giản.
• Sơ đồ Mermaid được dựng sẵn thành SVG nội tuyến lúc build, giữ cho slide không phụ thuộc vào bất kỳ thư viện ngoài nào.
• Xuất PDF có kiểm chứng: Kỹ năng đi kèm sẽ render PDF thành ảnh và kiểm tra các trang, tránh trường hợp PDF có số trang đúng nhưng hình ảnh bị trống.

Cài đặt và tương thích

SlideOps hỗ trợ trực tiếp Claude Code (chỉ cần hai lệnh cài đặt) và tương thích với Codex, Copilot CLI, OpenCode hoặc các công cụ khác thông qua bản cài đặt thủ công. Tất cả các tác nhân đều đọc file SKILL.md, nên không cần phải chuyển đổi gì giữa chúng.

Đối với người dùng Việt Nam, việc tạo tài liệu thuyết trình nội bộ từ code bằng tiếng Việt hoàn toàn khả thi, giúp các nhóm phát triển phần mềm trong nước tiết kiệm đáng kể thời gian viết và bảo trì tài liệu.

Giấy phép và mã nguồn mở

SlideOps được phát hành dưới giấy phép MIT, cho phép sử dụng, fork và thương mại hóa. Các slide mà người dùng tạo ra hoàn toàn là tài sản của họ. Dự án được cung cấp miễn phí trên GitHub với mã nguồn mở, phù hợp cho mọi quy mô đội nhóm.

Badge CI Badge Python Badge License

Với cách tiếp cận "Ops" (vận hành) cho tài liệu thuyết trình — khác với các công cụ tạo slide truyền thống chỉ tập trung vào giao diện — SlideOps mở ra một hướng đi mới: biến tài liệu thành một phần của vòng đời phát triển phần mềm, luôn được kiểm tra và cập nhật như chính code.