android-clean-architecture

Tổng quan về skill android-clean-architecture

Skill android-clean-architecture giúp bạn tổ chức ứng dụng Android và Kotlin Multiplatform theo các ranh giới rõ ràng, sạch sẽ thay vì để tính năng phát triển theo kiểu chắp vá, ai viết đâu để đó. Skill này phù hợp nhất với kỹ sư đang cần một điểm khởi đầu thực tế cho kiến trúc module, quy tắc phụ thuộc, UseCase, Repository và thiết kế tầng data — chứ không phải một bài giảng lý thuyết chung chung.

Skill này dùng để làm gì

Hãy dùng android-clean-architecture khi bạn cần quyết định logic nên nằm ở đâu, các module nên phụ thuộc lẫn nhau như thế nào, và làm sao để phần UI, domain, và data không bị dồn hết vào cùng một tầng. Skill này đặc biệt hữu ích nếu bạn đang chuẩn hóa một codebase mới hoặc tái cấu trúc một ứng dụng đang ngày càng phình to.

Ai sẽ hưởng lợi nhiều nhất

Skill android-clean-architecture đặc biệt phù hợp với các team đang xây ứng dụng Android, code dùng chung KMP, hoặc sản phẩm dựa trên Compose nhưng đã bắt đầu bị coupling quá chặt. Nó cũng hữu ích khi bạn đang cân nhắc giữa feature modules, layered modules, hoặc một cấu trúc single-module đơn giản hơn nhưng vẫn giữ được ranh giới sạch.

Điểm khác biệt chính

Khác với những prompt kiến trúc mơ hồ, android-clean-architecture tập trung vào cấu trúc cụ thể: cách chia module, các dependency nào được phép, nên đặt repository ở đâu, và nên tích hợp Room, SQLDelight, Ktor, Koin, hay Hilt vào tầng nào. Vì vậy, skill này thiên về hỗ trợ ra quyết định hơn khi bạn muốn tránh overengineering hoặc tránh để rò rỉ trách nhiệm giữa các layer.

Cách dùng skill android-clean-architecture

Cài đặt và kích hoạt

Hãy cài android-clean-architecture bằng quy trình cài đặt trong skills manager của bạn, sau đó mở file skill và giữ nó trong ngữ cảnh khi lên kế hoạch hoặc chỉnh sửa kiến trúc. Nếu môi trường của bạn hỗ trợ nạp theo đường dẫn, hãy trỏ tới skills/android-clean-architecture/SKILL.md để model có thể bám theo các quy tắc kiến trúc trong suốt tác vụ.

Giao cho nó một bài toán kiến trúc cụ thể

Skill android-clean-architecture hoạt động tốt nhất khi bạn yêu cầu một đầu ra thật cụ thể, chẳng hạn như chia module, lập sơ đồ dependency, hoặc xác định vị trí cho từng layer. Input tốt nên nêu rõ nền tảng, stack hiện tại, và các ràng buộc đang có.

Ví dụ dạng prompt:

• “Design an android-clean-architecture module layout for a Compose + Hilt app with offline sync.”
• “Refactor this KMP feature into android-clean-architecture layers using Room on Android and SQLDelight in shared code.”
• “Review these modules and point out dependency rule violations.”

Đọc đúng phần trước tiên

Hãy bắt đầu với SKILL.md, sau đó tập trung vào các phần mô tả khi nào nên kích hoạt skill, layout được khuyến nghị, và các quy tắc dependency. Đó là những phần ảnh hưởng trực tiếp đến lựa chọn triển khai. Nếu repo của bạn chỉ có duy nhất file này, hãy xem các phần đó là nguồn tham chiếu chính và điều chỉnh lại theo package name cũng như cấu hình build của riêng bạn.

Cung cấp đầu vào giúp nâng chất lượng đầu ra

Hãy đưa cho skill một bản kiểm kê ngắn về những gì đang có sẵn: các module, công cụ persistence, framework DI, network stack, và ứng dụng là Android-only hay KMP. Đồng thời nêu rõ những gì bạn muốn giữ nguyên, ví dụ như ranh giới feature hiện tại hoặc public API đang dùng. Trạng thái hiện tại của bạn càng cụ thể, hướng dẫn android-clean-architecture càng ít có nguy cơ bịa thêm các layer không cần thiết.

Câu hỏi thường gặp về skill android-clean-architecture

android-clean-architecture chỉ dành cho dự án mới thôi sao?

Không. Skill android-clean-architecture hữu ích cho cả dự án greenfield lẫn công việc refactor. Nó phát huy tác dụng mạnh nhất khi bạn cần áp lại ranh giới cho một ứng dụng hiện có đã trở nên lộn xộn, vì nó giúp bạn quyết định nên di chuyển phần nào mà không phải viết lại toàn bộ cùng một lúc.

Nó khác gì so với một prompt thông thường?

Một prompt thông thường cũng có thể yêu cầu kiến trúc phân tầng, nhưng android-clean-architecture cung cấp một khung rõ ràng hơn cho các quyết định liên quan đến Android và KMP. Điều đó đồng nghĩa với hướng dẫn tốt hơn về chiều dependency, cách đặt tên module, và nơi nên đặt code data source cùng repository.

Người mới có dùng được không?

Có, miễn là bạn sẵn sàng làm việc từ một sơ đồ module cụ thể. Skill này kém phù hợp hơn nếu bạn chỉ muốn một lời giải thích ở mức khái niệm về Clean Architecture mà không có chi tiết triển khai. Người mới sẽ nhận được nhiều giá trị nhất khi dùng nó để kiểm tra một cấu trúc đơn giản, rõ ràng, thay vì một mô hình quá dàn trải.

Khi nào không nên dùng?

Đừng dùng android-clean-architecture nếu ứng dụng của bạn rất nhỏ, team của bạn chủ đích không theo kiến trúc phân tầng, hoặc bạn chỉ cần triển khai nhanh một tính năng mà không có nhu cầu thiết kế module. Trong các trường hợp đó, skill này có thể thêm vào một mức độ cấu trúc mà bạn thực sự không cần.

Cách cải thiện skill android-clean-architecture

Nêu rõ quyết định kiến trúc bạn đang cần

Cách nhanh nhất để cải thiện đầu ra của android-clean-architecture là yêu cầu từng quyết định một: ranh giới module, đồ thị dependency, luồng dữ liệu, hoặc cách nối DI. Nếu bạn chỉ hỏi “best architecture”, kết quả thường sẽ kém hữu ích hơn so với một yêu cầu như “where should caching live in this KMP repository setup?”

Đưa cho skill các ràng buộc thực tế của bạn

Hãy nêu rõ stack và các giới hạn quan trọng: chỉ Android hay KMP, Compose hay XML, Room hay SQLDelight, Ktor hay Retrofit, Hilt hay Koin, và có bắt buộc offline-first hay không. Những chi tiết đó sẽ làm thay đổi cấu trúc được khuyến nghị, đồng thời ngăn một hướng dẫn android-clean-architecture chung chung bị lệch sang backend hoặc mô hình lưu trữ không phù hợp.

Để ý các lỗi phổ biến của android-clean-architecture

Sai lầm thường gặp nhất là để mỗi feature tự mang theo một “tiểu kiến trúc” riêng mà không có quy tắc dùng chung. Một lỗi khác là nhét business logic vào code presentation chỉ vì làm vậy nhanh hơn ở thời điểm hiện tại. Hãy dùng skill để kiểm tra các ranh giới này từ sớm, rồi rà soát lại kết quả dựa trên package tree và build files thực tế của bạn.

Lặp tiếp bằng một yêu cầu bám sát cấu trúc repo

Sau đầu ra đầu tiên, hãy yêu cầu một bản audit dependency hoặc một kế hoạch sắp xếp file theo đúng cây thư mục hiện tại của bạn. Ví dụ: “Map these existing packages to the android-clean-architecture layout and flag anything that should move to domain or data.” Kiểu follow-up này sẽ biến skill từ một hướng dẫn mang tính khái niệm thành một công cụ hỗ trợ migration thực thụ.