ios-design-guidelines

Tổng quan về skill ios-design-guidelines

Skill ios-design-guidelines giúp bạn kiểm tra, tinh chỉnh và viết lại giao diện iPhone theo Apple Human Interface Guidelines mà không cần đọc toàn bộ source trước. Skill này đặc biệt hữu ích cho các tác vụ SwiftUI và UIKit, khi layout, điều hướng, accessibility, Dynamic Type, Dark Mode hoặc lựa chọn system component có thể quyết định thành bại của sản phẩm.

Hãy dùng skill ios-design-guidelines khi bạn cần hướng dẫn thực tế cho một quyết định giao diện cụ thể, chứ không phải lý thuyết thiết kế trừu tượng. Đây là lựa chọn phù hợp cho designer, iOS engineer và review agent cần bắt nhanh những lỗi HIG dễ tránh: vùng chạm quá nhỏ, layout không an toàn, điều hướng không chuẩn, kích thước chữ hardcode hoặc thiếu hỗ trợ accessibility.

Skill này phù hợp nhất cho gì

Nhiệm vụ chính của nó là chuyển một ý tưởng UI còn sơ sài thành một triển khai hoặc checklist review phù hợp với iPhone. Skill này mạnh nhất khi bạn muốn các mặc định bám sát Apple, ví dụ minh họa bằng SwiftUI/UIKit, và các kiểm tra rule cụ thể thay vì lời khuyên chung chung kiểu “hãy làm cho trực quan hơn”.

Nó mang lại giá trị thực ở đâu

Skill này đặc biệt hữu ích khi bạn đang phân vân giữa các pattern iOS phổ biến: tab bar hay custom navigation, hành vi safe area, action neo ở đáy màn hình, co giãn text, semantic colors và system gestures. Điều đó khiến guide ios-design-guidelines mang tính định hướng quyết định hơn là chỉ lướt nhanh qua repo.

Khi nào không phù hợp

Nếu bạn cần chiến lược sản phẩm tổng quát, tư vấn thiết kế đa nền tảng, hoặc pattern cho Android/web, thì đây không phải nguồn chuẩn để dùng. Skill này cũng kém hữu ích hơn cho công việc thuần branding thị giác không phụ thuộc vào quy ước iOS.

Cách dùng skill ios-design-guidelines

Cài đặt và xem đúng các file

Cài bằng npx skills add ehmo/platform-design-skills --skill ios-design-guidelines. Để việc cài ios-design-guidelines thực sự có ích, hãy đọc SKILL.md trước, rồi đến AGENTS.md, metadata.json, và rules/_sections.md. Những file này cho bạn thấy phạm vi của skill, mức ưu tiên của rule, và các nhóm rule bạn có khả năng áp dụng nhiều nhất.

Biến một mục tiêu mơ hồ thành prompt hữu dụng

Cách dùng ios-design-guidelines tốt nhất bắt đầu từ bối cảnh giao diện thật cụ thể. Hãy nêu rõ nền tảng, loại màn hình, tác vụ người dùng và rủi ro hiện tại. Ví dụ: “Review màn hình checkout SwiftUI này cho iPhone, tập trung vào vị trí trong thumb zone, safe area, touch target và Dynamic Type. Chỉ đề xuất thay đổi nếu vẫn giữ nguyên luồng hiện tại.” Như vậy skill sẽ có thứ để xử lý, thay vì một yêu cầu chung chung kiểu “cải thiện app của tôi”.

Input nào giúp output tốt hơn

Hãy cung cấp đoạn UI liên quan, danh sách component và các ràng buộc: chỉ iPhone hay universal, SwiftUI hay UIKit, iOS version hỗ trợ, và những hành vi phải giữ nguyên. Nếu bạn muốn viết lại, hãy đưa cả code hiện tại hoặc cấu trúc màn hình để skill map rule vào các control cụ thể thay vì phải đoán.

Quy trình thực tế nên theo

Bắt đầu bằng một lượt review có trọng tâm, rồi yêu cầu một lượt thứ hai hẹp hơn cho vùng rủi ro: navigation, accessibility hoặc layout. Ví dụ, trước hết hãy hỏi những vi phạm HIG ưu tiên cao nhất, sau đó yêu cầu triển khai sửa chỉ ba vấn đề hàng đầu. Cách này giúp việc dùng ios-design-guidelines hiệu quả hơn và các sửa đổi dễ áp dụng hơn.

Câu hỏi thường gặp về skill ios-design-guidelines

Skill này chỉ dành cho SwiftUI thôi sao?

Không. Skill ios-design-guidelines hỗ trợ cả SwiftUI lẫn UIKit, nên dùng được cho cả dự án mới và refactor code cũ. Hãy dùng nó để so sánh lựa chọn triển khai với quy ước iPhone, chứ không chỉ để sinh code.

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

Một prompt thông thường thường chỉ cho ra lời khuyên UI ở mức bề mặt. Skill này được xây dựng quanh các rule đặc thù của Apple và các lỗi hay gặp, nên guide ios-design-guidelines hữu ích hơn khi bạn cần đề xuất có thể review được, đúng kiểu iPhone-native và ít phải đoán.

Tôi có cần là iOS expert mới dùng được không?

Không. Người mới vẫn dùng tốt nếu mô tả màn hình rõ ràng và cung cấp code hoặc layout đang có. Hạn chế lớn nhất là chất lượng input: prompt càng mơ hồ thì output càng mơ hồ.

Khi nào nên tránh dùng nó?

Hãy bỏ qua khi làm giao diện không phải iPhone, mockup chỉ để xây dựng brand, hoặc trường hợp bạn cố ý muốn phá vỡ hành vi chuẩn của iOS. Nếu mục tiêu của bạn là một pattern tương tác mới lạ, skill ios-design-guidelines có thể đúng lúc kéo bạn trở lại với quy ước hệ thống.

Cách cải thiện skill ios-design-guidelines

Cung cấp cho skill bối cảnh rule mà nó cần

Kết quả tốt nhất đến khi bạn chỉ rõ phần nào của giao diện dễ fail khi review HIG. Hãy nói rõ bạn quan tâm nhất đến layout, navigation, typography, màu sắc hay accessibility để skill ios-design-guidelines có thể cân trọng tâm phản hồi thay vì dàn trải quá rộng.

Yêu cầu thay đổi, không chỉ nhận xét

Nếu bạn muốn hỗ trợ triển khai, hãy yêu cầu cấu trúc màn hình đã chỉnh sửa, code SwiftUI/UIKit đã sửa, hoặc danh sách lỗi ưu tiên cần khắc phục. Skill này hữu ích hơn khi nó biến vấn đề thành hành động cụ thể, chẳng hạn tăng touch target, đưa primary action vào thumb zone, hoặc khôi phục tuân thủ safe area.

Chú ý các lỗi hay gặp nhất

Những lỗi lớn nhất thường là custom navigation đi ngược iOS, text không tự co giãn, và tín hiệu trạng thái chỉ bằng hình ảnh khiến accessibility không dùng được. Nếu lượt đầu quá chung chung, hãy thêm ràng buộc cụ thể như “phải giữ nguyên navigation hiện tại” hoặc “phải hỗ trợ Dynamic Type cỡ rất lớn” để buộc ios-design-guidelines hoạt động hiệu quả hơn.

Lặp lại bằng prompt thứ hai hẹp hơn

Sau câu trả lời đầu tiên, hãy chạy lại skill cho vùng rủi ro quan trọng nhất thay vì yêu cầu thêm một lần review toàn bộ. Ví dụ: “Bây giờ chỉ kiểm tra accessibility cho VoiceOver, Reduce Motion, và contrast.” Cách này cho phản hồi sắc hơn và làm việc cài ios-design-guidelines hữu ích hơn trên dự án thực tế.