Mimeo là một công cụ mã nguồn mở giúp tự động hóa việc biến cách tư duy của chuyên gia thành tệp SKILL.md hoặc AGENTS.md cho coding agent. Repo này giải quyết bài toán tốn hàng tuần để đọc, tổng hợp và hệ thống hóa tri thức của một chuyên gia thành hướng dẫn mà agent có thể dùng. Nó dành cho lập trình viên, kỹ sư AI và team đang xây dựng coding agent cần nguồn tham chiếu chất lượng cao.
Những điểm chính
- Mimeo tự động hóa toàn bộ pipeline: định danh, thu thập nguồn, trích xuất, phân cụm, kiểm tra quote và xuất ra
SKILL.md/AGENTS.md. - Hỗ trợ nhiều định dạng đầu ra, chế độ web, YouTube captions, audio transcription, tối đa 40 nguồn và tùy chọn deep research.
- Quy trình có vòng phản biện: critique và refine giúp artifact đạt điểm chất lượng mặc định 8/10 trước khi bàn giao.
- Không phải là giải pháp chính xác tuyệt đối; bạn phải review nội dung trước khi cài vào agent thật.
Mimeo là gì và giải quyết vấn đề gì?
Mimeo là một pipeline nghiên cứu và soạn thảo tự động dành riêng cho coding agent. Thay vì để con người đọc hàng nghìn trang sách, bài giảng, thư từ và phỏng vấn của một chuyên gia, Mimeo thu thập các nguồn công khai, chưng cất bằng model tiên tiến, phân cụm ý tưởng lặp lại và viết thành tài liệu có cấu trúc.
Vấn đề Mimeo giải quyết rất thực tế: một coding agent giỏi cần nhiều hơn là prompt rời rạc. Một tệp SKILL.md hoặc AGENTS.md tốt có thể thay đổi cách agent lập luận, cân nhắc đánh đổi và chọn pattern mặc định. Nhưng viết tệp đó bằng tay là dự án nhiều tuần. Mimeo rút ngắn quy trình này bằng cách để máy tự đọc internet, xác minh quote và lặp lại nhiều lần trước khi xuất bản. Bạn có thể xem chi tiết tại repository mimeo trên GitHub.
Những tính năng nổi bật của Mimeo là gì?
Mimeo nổi bật nhờ thiết kế pipeline có kiểm soát, không chỉ đơn giản là một prompt LLM dài. Nó chia nhỏ công việc thành các bước có thể kiểm tra, lưu cache và lặp lại, giúp kết quả minh bạch và dễ gỡ lỗi hơn. Nhờ vậy, bạn có thể theo dõi nguồn nào được dùng, quote nào bị loại và điểm chất lượng sau mỗi lần chỉnh sửa.
Định danh nhân vật để tránh trùng tên
Tên phổ biến như John Smith có thể là nhà kinh tế, huấn luyện viên bóng rổ hoặc tiểu thuyết gia. Mimeo chạy một lượt tìm kiếm song song và phân loại bằng LLM để xác định đúng người, tránh tạo ra một artifact lai ghép vô nghĩa.
Thu thập nguồn theo tám nhóm chủ đích
Công cụ tìm kiếm nguồn theo các bucket: bài luận, talks, bài giảng, phỏng vấn, podcast, frameworks, sách, papers và thư từ. Nhờ vậy cả chuyên gia hiện đại lẫn nhà khoa học lịch sử đều có nguồn tài liệu phù hợp.
Trích xuất và phân cụm đa nguồn
Mỗi nguồn được chưng cất bằng một frontier model thông qua OpenRouter, mặc định là Google Gemini 3.1 Pro Preview. Các nguồn dài như sách hoặc hội thảo được chia theo ranh giới đoạn văn, xử lý song song và gộp lại để không bị mất nội dung do giới hạn độ dài. Nếu bật --deep-research, Mimeo còn chạy thêm Parallel Task API và đưa báo cáo vào như một pseudo-source.
Kiểm tra quote và vòng phản biện
Mimeo so khớp từng quote với văn bản nguồn đã tải về; quote không khớp sẽ bị loại và ghi vào _workspace/quote_verification.md. Sau khi soạn thảo, một LLM đóng vai biên tập viên chấm điểm 0-10, phản hồi lại cho quá trình viết và lặp cho đến khi đạt ngưỡng chất lượng hoặc hết số lần chỉnh sửa.
Định dạng đầu ra linh hoạt
Bạn có thể chọn --format skill, --format agents hoặc --format both. Phiên bản kỹ năng gồm SKILL.md kèm thư mục references/, còn phiên bản AGENTS.md là một tệp thường trực, luôn được đọc ở đầu phiên làm việc. Ngoài ra, cờ --avatar có thể tạo chân dung theo phong cách họa sĩ qua OpenRouter Images API, nhưng mặc định tắt vì độ giống có thể không chính xác.
Hướng dẫn cài đặt và sử dụng Mimeo
Phần này dành cho người muốn chạy thử ngay. Mimeo yêu cầu Python, tài khoản OpenRouter và Parallel; việc cài đặt chỉ mất vài phút nếu bạn đã có sẵn môi trường Python. Nếu chưa có uv, bạn có thể dùng pip; nếu thiếu API key, hãy tạo trên trang chủ của từng dịch vụ trước khi bắt đầu.
- Cài đặt bằng uv:
uv sync - Hoặc cài bằng pip:
pip install -e . - Nếu muốn xử lý âm thanh podcast, chạy thêm:
uv sync --extra full - Sao chép
.env.examplethành.envvà điềnOPENROUTER_API_KEY,PARALLEL_API_KEY. Trên macOS/Linux nên đặtchmod 600 .env. - Chạy lệnh đơn giản:
uv run mimeo 'Naval Ravikant' - Với tên dễ trùng, thêm định danh:
uv run mimeo 'John Smith' -d 'head basketball coach, Michigan State' - Muốn tạo skill giàu nguồn hơn:
uv run mimeo 'Jensen Huang' --mode full --max-sources 40 --deep-research
Kết quả mặc định nằm trong thư mục output/, ví dụ output/naval-ravikant/. Nếu dùng định dạng skill, bạn sẽ thấy SKILL.md, các tệp tham chiếu như principles.md, frameworks.md, mental-models.md, heuristics.md, anti-patterns.md, quotes.md, sources.md và thư mục _workspace/ chứa cache và nhật ký kiểm tra.
Mimeo đảm bảo chất lượng và an toàn như thế nào?
Mimeo không phải là một script đưa nội dung thô vào prompt rồi in ra file. Nó có ba lớp bảo vệ chính: xác minh quote, vòng critique-refine và giới hạn an toàn khi tải dữ liệu từ internet. Ba lớp này giúp giảm rủi ro sai lệch nội dung và hạn chế tấn công từ nguồn không tin cậy.
Lớp xác minh quote kiểm tra từng câu trích dẫn với văn bản nguồn đã tải, loại bỏ những quote không xuất hiện sau khi chuẩn hóa typography. Lớp phản biện dùng một LLM đóng vai biên tập viên, chấm điểm và liệt kê vấn đề theo danh mục, rồi đưa phản hồi đó vào lần viết lại. Quá trình dừng khi điểm đạt --quality-bar mặc định là 8 hoặc hết --max-revisions.
Về an toàn, Mimeo chỉ chấp nhận URL nguồn là địa chỉ HTTP(S) công khai. Các fallback cục bộ chặn credentials, địa chỉ private/link-local/metadata, validate DNS, kiểm tra redirect và giới hạn kích thước phản hồi. Tuy nhiên, đây là biện pháp best-effort cho CLI nghiên cứu cá nhân, không thay thế được network isolation khi chạy tác vụ không tin cậy trong môi trường multi-tenant. Bạn nên review SKILL.md hoặc AGENTS.md trước khi cài vào agent.
Ai nên dùng Mimeo và ai không nên?
Câu trả lời ngắn: hãy dùng nếu bạn coi coding agent là công cụ cần có khuôn mẫu tư duy rõ ràng, và đừng dùng nếu bạn cần kết quả đảm bảo tuyệt đối mà không muốn kiểm tra lại. Mimeo phù hợp nhất khi bạn chấp nhận bản chất xác suất của LLM và sẵn sàng dành thời gian đọc lại file đầu ra trước khi đưa vào sử dụng.
Nên dùng
- Lập trình viên đang xây dựng coding agent hoặc trợ lý lập trình theo kỹ năng.
- Kỹ sư AI muốn tạo thư viện skill on-demand, kích hoạt bằng mô tả.
- Team muốn cài đặt hành vi mặc định của agent bằng
AGENTS.mdtrong dự án. - Người muốn học từ chuyên gia nhưng không có thời gian đọc toàn bộ tài liệu gốc.
Không nên dùng
- Người cần nội dung 100% chính xác hoặc cần trích dẫn học thuật nghiêm ngặt.
- Người không có API key OpenRouter hoặc Parallel và muốn chạy hoàn toàn miễn phí.
- Người cần pipeline chạy offline trong môi trường không có internet.
- Người muốn gắn artifact vào agent ngay mà không đọc lại file đầu ra.
Câu hỏi thường gặp
SKILL.md và AGENTS.md khác nhau thế nào?
SKILL.md là một kỹ năng có YAML frontmatter, thường được kích hoạt theo mô tả khi cần. AGENTS.md là tệp thường trực, được đọc ở đầu mỗi phiên làm việc trong thư mục dự án, phù hợp để cài đặt thói quen mặc định cho agent. Nếu bạn xây dựng thư viện kỹ năng theo yêu cầu, hãy chọn SKILL.md; nếu muốn agent luôn mang theo nguyên tắc của chuyên gia, hãy chọn AGENTS.md.
Mimeo có miễn phí không?
Mã nguồn của Mimeo là mã nguồn mở trên GitHub, nhưng lúc chạy bạn cần điền OPENROUTER_API_KEY và PARALLEL_API_KEY. Chi phí phụ thuộc vào số nguồn, model bạn chọn và việc có bật deep research hay xử lý audio hay không. Vì vậy, chi phí thực tế nằm ở lượng API tiêu thụ trong mỗi lần chạy.
Tôi có cần viết prompt phức tạp không?
Không. Bạn chỉ cần truyền tên chuyên gia, ví dụ uv run mimeo 'Naval Ravikant'. Với tên trùng, thêm cờ -d kèm mô tả ngắn. Các tham số nâng cao như --model, --max-sources, --format đều có giá trị mặc định hợp lý. Bạn có thể bắt đầu bằng lệnh một dòng và chỉ can thiệp khi muốn kiểm soát sâu hơn.
Làm sao xử lý tên trùng khi dùng Mimeo?
Mimeo tự phát hiện tên mơ hồ bằng tìm kiếm song song và phân loại LLM. Nếu chạy ở môi trường tương tác, nó đưa ra danh sách để bạn chọn. Trong script, thêm -d để chốt đúng người, hoặc dùng --assume-unambiguous nếu bạn chắc chắn tên không trùng.
Mimeo có kiểm tra trích dẫn không?
Có. Mimeo kiểm tra từng quote đã phân cụm với văn bản nguồn đã tải về; quote không khớp sẽ bị loại và được liệt kê trong _workspace/quote_verification.md. Bạn có thể tắt bằng --no-verify-quotes nếu muốn chạy nhanh hơn. Tuy nhiên, nên giữ chức năng này bật vì nó là một trong những lớp bảo vệ quan trọng nhất của pipeline.
Kết luận
Mimeo là một cách tiếp cận thú vị để đưa tri thức chuyên gia vào coding agent một cách có hệ thống, minh bạch và lặp lại được. Nó không thay thế sự phán xét của con người, nhưng giảm đáng kể công sức đọc và tổng hợp tài liệu. Nếu bạn muốn agent của mình suy nghĩ sâu hơn, hãy bắt đầu bằng một cái tên bạn ngưỡng mộ, chạy pipeline mặc định và đọc file đầu ra trước khi cài vào dự án thật.
