Bạn đang tìm một công cụ tạo sơ đồ kiến trúc từ mô tả tiếng Anh mà không cần mở phần mềm thiết kế hay vẽ tay? Archify là agent skill dành cho Claude, Codex CLI và opencode, cho phép bạn mô tả hệ thống bằng ngôn ngữ tự nhiên và nhận ngay một file HTML chứa sơ đồ chuyên nghiệp, có thể chuyển đổi dark/light theme, xuất PNG/JPEG/WebP/SVG độ phân giải cao. Không cần kỹ năng thiết kế – chỉ cần biết bạn muốn vẽ gì.
Thank you for reading this post, don't forget to subscribe!Những điểm chính
- Chỉ cần mô tả kiến trúc bằng tiếng Anh, Archify tự động tạo sơ đồ chuyên nghiệp.
- Hỗ trợ 5 loại sơ đồ: kiến trúc, workflow, sequence, data flow và lifecycle.
- Xuất ảnh sắc nét lên đến 4x kích thước gốc (PNG/JPEG/WebP) hoặc SVG vector tự động theo theme hệ thống.
- Tích hợp validation loop và post-render checks để đảm bảo chất lượng sơ đồ.
- Cài đặt dễ dàng trên Claude.ai, Claude Code CLI, Codex CLI và opencode.
Archify là gì và giải quyết vấn đề gì?
Archify là một agent skill mã nguồn mở được phát triển từ dự án Cocoon-AI/architecture-diagram-generator, được viết lại hoàn toàn với hệ thống theme CSS variable, menu xuất ảnh và hỗ trợ đa loại sơ đồ. Vấn đề mà nó giải quyết rất thực tế: bạn cần một sơ đồ kiến trúc nhanh để chia sẻ với đồng nghiệp, nhưng việc dùng draw.io hay Figma mất thời gian, còn vẽ tay thì không chuyên nghiệp. Với Archify, bạn chỉ cần gõ vài dòng mô tả – ví dụ ‘React frontend gọi Node.js API, dùng PostgreSQL và Redis, deploy trên AWS CloudFront’ – và Claude sẽ sinh ra một file HTML đẹp, có thể tương tác. Bạn có thể xem chi tiết tại repository gốc trên GitHub.
Archify có những tính năng nổi bật nào?
Archify không chỉ vẽ sơ đồ kiến trúc – nó còn hỗ trợ workflow, sequence, data flow và lifecycle diagrams. Mỗi loại sơ đồ đều có JSON schema riêng, validation tự động và renderer kiểm tra lỗi. Điểm đáng chú ý là khả năng xuất ảnh: bạn có thể copy PNG trực tiếp vào clipboard, hoặc download ở định dạng JPEG/WebP/PNG với độ phân giải gốc lên đến 4x (không upsampling mờ). SVG xuất ra cũng rất thông minh – nó chứa cả hai bộ biến CSS cho dark và light, kèm media query prefers-color-scheme, nên khi nhúng vào GitHub README, nó tự động hiển thị đúng theme theo trình duyệt người đọc. Ngoài ra, Archify có hệ thống semantic tech labels: bạn có thể mô tả component là aws.lambda, postgres, redis… và nó tự động phân loại và tô màu phù hợp mà không cần thư viện icon nặng.
Hướng dẫn cài đặt và sử dụng Archify như thế nào?
Việc cài đặt Archify rất đơn giản, chỉ gồm vài bước sau:
- Tải file
archify.ziptừ repository chính thức. - Chọn nền tảng bạn dùng:
- Trên Claude.ai: vào Settings → Capabilities → Skills → Add và upload file zip.
- Trên Claude Code CLI: giải nén vào
~/.claude/skills/hoặc.claude/skills/trong dự án. - Trên Codex CLI: giải nén vào
~/.agents/skills/hoặc.agents/skills/. - Trên opencode: giải nén vào
~/.config/opencode/skills/hoặc.opencode/skills/.
- Chạy
cd ~/.agents/skills/archify && npm installđể cài đặt dependency (ajv) cho schema validation. - Mô tả hệ thống của bạn bằng tiếng Anh – có thể yêu cầu agent phân tích codebase hoặc tự viết.
- Yêu cầu agent sử dụng skill: ‘Use your archify skill to create an architecture diagram from this description…’
Kết quả là một file HTML mở được trong trình duyệt, có hai nút trên góc phải: nút theme (T) và menu Export (E). Bạn có thể chuyển đổi dark/light, copy PNG hoặc tải về các định dạng. Nếu muốn dùng CLI trực tiếp, Archify cũng có sẵn bin/archify.mjs cho các lệnh render, validate và check.
Ai nên dùng Archify – ai không nên?
Archify phù hợp nhất với các lập trình viên, kiến trúc sư phần mềm, technical writer và bất kỳ ai cần tạo sơ đồ kỹ thuật nhanh mà không muốn rời khỏi môi trường làm việc (terminal, Claude, Codex). Nó đặc biệt hữu ích trong các buổi họp, documentation, hoặc khi bạn cần minh họa luồng dữ liệu, workflow CI/CD, lifecycle của agent. Tuy nhiên, nếu bạn cần một sơ đồ với giao diện tùy chỉnh cao, nhiều icon thương hiệu, hoặc muốn chỉnh sửa thủ công từng pixel, Archify có thể không phải lựa chọn tốt nhất – lúc đó draw.io hay Figma vẫn là vua. Ngoài ra, Archify phụ thuộc vào khả năng layout của Claude, nên nếu bạn cần sơ đồ cực kỳ chính xác về tọa độ, bạn nên kiểm tra lại output. Nhìn chung, đây là công cụ tăng năng suất, không phải giải pháp thiết kế đồ họa chuyên sâu.
Câu hỏi thường gặp
Archify có hỗ trợ xuất SVG không?
Có, Archify xuất SVG dual-theme: file SVG chứa cả bộ biến CSS cho dark và light, kèm media query prefers-color-scheme để tự động hiển thị đúng theo theme hệ thống người đọc. Bạn có thể nhúng một file SVG duy nhất vào GitHub README mà không cần dùng thẻ picture hay hai file PNG riêng.
Tôi có cần kỹ năng thiết kế để dùng Archify không?
Hoàn toàn không. Bạn chỉ cần mô tả hệ thống bằng tiếng Anh – những câu đơn giản như ‘React frontend gọi Node.js API’ là đủ. Archify dựa vào Claude để bố trí layout và chọn màu sắc phù hợp. Không cần biết CSS hay SVG.
Archify có thể vẽ sơ đồ microservices không?
Có, Archify hỗ trợ vẽ sơ đồ kiến trúc với nhiều thành phần, bao gồm microservices. Bạn có thể mô tả các service riêng lẻ, API Gateway, database, message queue. Nó cũng hỗ trợ sơ đồ sequence để minh họa luồng gọi giữa các service.
Tôi có cần cài npm dependency không?
Nếu bạn muốn sử dụng đầy đủ tính năng validation schema, bạn cần chạy npm install trong thư mục skill để cài đặt ajv. Nếu không, Archify vẫn hoạt động, chỉ bỏ qua bước validation JSON – các layout check vẫn chạy. Đa số agent runtime có thể tự động cài khi cần.
Kết luận
Archify là một công cụ mạnh mẽ và thông minh giúp bạn chuyển đổi ý tưởng thành sơ đồ chuyên nghiệp chỉ trong vài giây. Với khả năng hỗ trợ nhiều loại sơ đồ, xuất ảnh sắc nét và tích hợp sâu vào Claude, Codex CLI, opencode, nó xứng đáng có mặt trong toolchain của bất kỳ developer hay technical writer nào. Đừng chần chừ – hãy ghé repository gốc, tải về và thử ngay hôm nay!
