android-native-dev

Tổng quan về skill android-native-dev

android-native-dev là một hướng dẫn phát triển Android native tập trung, dành cho các nhóm và agent làm việc với Kotlin, Jetpack Compose, Material Design 3 và thiết lập ứng dụng ở mức production. Skill này hữu ích nhất khi bạn cần nhiều hơn một prompt chung chung: bạn cần một cách làm có thể lặp lại để khởi tạo, kiểm tra và cải thiện một ứng dụng Android với đúng file dự án, ràng buộc UI, kiểm tra khả năng tiếp cận và độ ổn định khi build. Nếu bạn đang dùng android-native-dev for Frontend Development, giá trị chính là biến một yêu cầu UI Android còn thô thành một kế hoạch triển khai tôn trọng quy tắc của nền tảng, thay vì tùy hứng dựng layout kiểu web.

Phù hợp nhất cho những việc nào

Hãy dùng android-native-dev khi nhiệm vụ là khởi tạo hoặc sửa một project Android native, thêm màn hình bằng Compose, hoặc làm cho ứng dụng hiện có phù hợp hơn với kỳ vọng của Android. Skill này đặc biệt hữu ích nếu bạn quan tâm đến cấu trúc app, gradle.properties, thiết lập wrapper, accessibility, layout thích ứng và xử lý lỗi build trước khi viết code tính năng.

Điểm khác biệt là gì

Không giống một prompt Android mơ hồ, android-native-dev cho bạn một quy trình bám theo trạng thái dự án: thư mục trống, repo dang dở, wrapper đã có sẵn, hoặc một project Android Studio hoàn chỉnh. Điều đó quan trọng vì phần lớn việc áp dụng thất bại ở khâu thiết lập, không phải ở thiết kế UI. Skill này cũng dẫn tới các tài liệu tham chiếu hỗ trợ về accessibility, màn hình thích ứng, chuyển động, hiệu năng, quyền riêng tư và kiểm thử, nên thực tế hơn nhiều so với một prompt đơn giản kiểu “build một màn hình app”.

Khi nào đây là lựa chọn phù hợp

Skill này rất phù hợp nếu bạn muốn đầu ra Android native có các đặc điểm sau:

• ưu tiên Compose hoặc hướng UI Android hiện đại
• tuân theo các quy ước của Material Design 3
• tương thích với thiết lập project dựa trên Gradle
• chú ý đến khả năng tiếp cận và hành vi trên màn hình lớn
• ít rủi ro vỡ build hoặc lỗi ở các bước cấu hình cơ bản

Cách dùng skill android-native-dev

Cài đặt và xác nhận phạm vi

Chạy lệnh android-native-dev install trong trình quản lý skills bạn đang dùng cho thư mục, rồi kiểm tra xem skill này có thực sự áp dụng cho công việc Android native chứ không phải UI đa nền tảng. Input quan trọng nhất là trạng thái project của bạn: hãy nói rõ bạn đang có thư mục trống, repo chưa hoàn chỉnh, project Android Studio hay một Gradle wrapper đã tồn tại. Từ đó skill sẽ biết nên khởi tạo, sửa hay mở rộng.

Biến mục tiêu thô thành prompt hữu ích

Một prompt android-native-dev usage tốt nên bao gồm:

• loại app và đối tượng người dùng
• trạng thái repo hiện tại
• UI framework mục tiêu, thường là Compose
• màn hình hoặc tính năng cần xây
• các ràng buộc như accessibility, hỗ trợ tablet, hoặc không có mạng

Ví dụ, thay vì nói “làm màn hình đăng nhập”, hãy dùng:

Using android-native-dev, create a Jetpack Compose login flow for a finance app. The repo already has a Gradle wrapper. Prioritize Material 3, accessible labels, error states, and a compact phone layout. Start by listing the files that must exist before implementation.

Cách này cung cấp đủ ngữ cảnh để skill đưa ra quyết định tốt hơn về kiến trúc và UI.

Đọc các file này trước

Khi làm việc thực tế với android-native-dev guide, hãy bắt đầu từ:

• SKILL.md cho quy trình làm việc và đánh giá kịch bản
• references/functional-requirements.md cho các ràng buộc theo hành vi
• references/accessibility.md cho nhãn, độ tương phản và kích thước vùng chạm
• references/adaptive-screens.md cho tablet, foldable và thay đổi kích thước
• references/performance-stability.md cho các ràng buộc về khởi động và nguy cơ crash

Nếu tác vụ thiên về giao diện, cũng nên đọc references/design-style-guide.md, references/visual-design.md và references/motion-system.md. Nếu liên quan đến dữ liệu nhạy cảm hoặc quyền truy cập, hãy kiểm tra references/privacy-security.md trước khi phác thảo UI.

Dùng quy trình theo từng giai đoạn

Skill này hiệu quả nhất khi bạn yêu cầu đầu ra theo từng bước:

1. xác nhận trạng thái project và các file còn thiếu
2. định nghĩa yêu cầu cho màn hình hoặc tính năng
3. tạo hoặc sửa skeleton project có thể build
4. thêm UI và chi tiết xác thực
5. rà soát accessibility, hiệu năng và hành vi thích ứng

Trình tự này giúp giảm lỗi thường gặp là lao thẳng vào code UI trước khi Gradle, AndroidX hoặc cấu trúc app đã sẵn sàng.

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

android-native-dev chỉ dành cho project mới thôi à?

Không. android-native-dev cũng rất hữu ích cho các repo Android chưa hoàn chỉnh hoặc đã khởi tạo dở. Thực tế, trong nhiều trường hợp nó còn giá trị hơn vì có thể giúp phát hiện file wrapper thiếu, các khoảng trống cấu hình và lỗi trạng thái project trước khi bạn sửa code.

Có bắt buộc phải dùng Compose không?

Compose là hướng chính mà skill này nhắm tới, nhưng nó vẫn hữu ích cho việc lập kế hoạch Android native ngay cả khi bạn đang so sánh Compose với các pattern XML cũ hơn. Nếu repo của bạn nặng về XML kiểu legacy, skill này không lý tưởng bằng công việc Compose-first, nhưng vẫn có thể dẫn dắt phần thiết lập, accessibility và hành vi thích ứng.

Nó khác gì một prompt Android thông thường?

Một prompt thông thường thường đi thẳng vào tính năng. android-native-dev thì hỏi trước về khả năng build, trạng thái repo và các ràng buộc đặc thù của Android. Điều đó khiến nó phù hợp hơn cho triển khai thực tế, vì nó phát hiện sớm các điểm nghẽn như thiếu gradle.properties, chưa thiết lập wrapper, hoặc hở khoảng ở accessibility trước khi bạn tốn thời gian vào phần hoàn thiện.

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

Đừng chọn android-native-dev nếu bạn đang làm mobile đa nền tảng, dịch vụ backend chỉ liên quan đến Android, hoặc một bản mockup chỉ để thiết kế chứ không có ý định triển khai native Android code. Nó cũng là lựa chọn yếu hơn nếu bạn cần chiến lược sản phẩm rộng hơn thay vì hướng dẫn triển khai Android thực chiến.

Cách cải thiện skill android-native-dev

Nói rõ trạng thái project ngay từ đầu

Bước nhảy chất lượng lớn nhất đến từ việc nói rõ repo đang trống, còn dang dở hay đã build được. Nếu bạn chỉ nói “build app cho tôi”, skill sẽ phải suy đoán quá nhiều. Nếu bạn nói “Android Studio project, thiếu wrapper, đã có các màn hình Compose”, nó sẽ tập trung đúng vào khoảng trống thực sự và tránh khởi tạo quá mức.

Nêu rõ các điều không được phép thay đổi

Để android-native-dev usage tốt hơn, hãy đưa vào các ràng buộc ảnh hưởng đến quyết định triển khai:

• nhu cầu accessibility, như nhãn TalkBack hoặc độ tương phản
• mục tiêu màn hình, như chỉ phone hoặc có hỗ trợ tablet/foldable
• ràng buộc hiệu năng, như khởi động nhanh
• ràng buộc bảo mật, như giảm thiểu quyền truy cập
• ràng buộc thị giác, như Material 3 hoặc bộ nhận diện thương hiệu chặt chẽ

Những chi tiết này quan trọng vì chúng thay đổi bố cục, cách xử lý state và lựa chọn component.

Yêu cầu kiểm tra, không chỉ sinh code

Một lỗi phổ biến là nhận được code trông ổn nhưng lại thiếu các yếu tố cơ bản của build hoặc UX. Hãy yêu cầu skill xác thực ./gradlew assembleDebug, liệt kê các file bắt buộc và kiểm tra lỗ hổng về accessibility hoặc màn hình thích ứng. Nếu đầu ra đầu tiên chưa đầy đủ, hãy lặp lại bằng cách yêu cầu danh sách file còn thiếu, rồi phần triển khai màn hình, rồi bước rà soát.

Đưa ví dụ về đầu ra tốt và chưa tốt

Nếu bạn đã biết “tốt” trông như thế nào, hãy nói ra. Ví dụ: “Tôi muốn một màn hình settings gọn, kiểu production, không phải layout marketing.” Điều này giúp android-native-dev skill tránh UI kiểu trang trí và bám sát đúng công việc frontend Android thực sự.