Chuyên gia Clean Architecture
Kỹ năng thiết kế kiến trúc giúp kiểm tra Dependency Rule, ranh giới module và SOLID rồi đưa ra cách sửa cụ thể.
Lập trìnhTrung cấp★ 1,984⑂ 198Điểm AI 7/10Cập nhật lần cuối: 10 thg 8, 2026
Làm được gì
- Kiểm tra Dependency Rule: xác nhận mọi phụ thuộc mã nguồn chỉ hướng vào trong (framework → use case → entity) và chỉ ra chỗ vi phạm cùng cách đảo phụ thuộc.
- Quyết định tầng cho code: xác định một đoạn code thuộc Entity, Use Case, Interface Adapter hay Framework.
- Chẩn đoán 7 câu hỏi + cho điểm: ví dụ "có test được business rule mà không cần DB/web server?", "đồ thị component có chu trình không?", rồi quy ra thang 0–10 kèm cách sửa từng mục thất bại.
- Nguyên tắc component và SOLID: REP/CCP/CRP/ADP/SDP/SAP cùng SRP·OCP·LSP·ISP·DIP với ví dụ code.
- Danh mục lỗi thường gặp: ORM rò rỉ vào domain, logic nghiệp vụ nằm trong controller, kiến trúc lấy framework làm gốc, monolith phân tán.
Phù hợp với ai
- Lập trình viên backend/fullstack đang dựng cấu trúc thư mục và ranh giới module cho dự án mới
- Nhóm muốn tách dần hệ thống legacy đang bị dính chặt vào framework/ORM
- Tech lead thường phải trả lời "logic này nên nằm ở tầng nào?" trong code review
- Người muốn hiện thực hóa Hexagonal (ports & adapters) hoặc Onion Architecture bằng code thật
Ví dụ sử dụng
- "Toàn bộ logic thanh toán đang nằm trong controller, tách ra sao?" → đề xuất
PlaceOrderInteractorvới input/output port, controller chỉ chuyển đổi và uỷ quyền. - "Đánh giá kiến trúc dự án của tôi" → cho điểm theo 7 câu chẩn đoán và nêu thứ tự sửa (thiếu interface repository, có chu trình phụ thuộc...).
- "Muốn đổi Postgres sang nơi lưu khác mà không sửa nghiệp vụ" → thiết kế interface
OrderRepositoryở tầng use case vàSqlOrderRepositoryở tầng adapter.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/wondelai/skills/HEAD/clean-architecture/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục clean-architecture từ repo GitHub wondelai/skills vào ~/.claude/skills/clean-architecture/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/wondelai/skills.git /tmp/wondelai-skills && mkdir -p ~/.claude/skills && cp -r /tmp/wondelai-skills/clean-architecture ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Tải repo kỹ năng:
git clone https://github.com/wondelai/skills.git - Tạo thư mục kỹ năng nếu chưa có:
mkdir -p ~/.claude/skills - Copy nguyên thư mục kỹ năng (để mang theo cả
references/):cp -r skills/clean-architecture ~/.claude/skills/ - Kiểm tra:
ls ~/.claude/skills/clean-architecturephải thấySKILL.mdvàreferences/. - Khởi động lại Claude Code, rồi thử yêu cầu: "Kiểm tra các tầng kiến trúc của project này theo Clean Architecture" — kỹ năng sẽ tự kích hoạt.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT