Audit UI code với ak:web-design-guidelines

Dùng ak:web-design-guidelines để review web UI code theo chế độ read-only. Trước mỗi lần review, Skill fetch Web Interface Guidelines hiện tại từ upstream, đọc tệp hoặc pattern bạn cung cấp, áp dụng rule đã fetch và báo cáo finding ngắn gọn theo từng tệp ở dạng file:line.

Chọn ak:web-design-guidelines cho audit hiện tại

Dùng ak:web-design-guidelines khi

• Bạn muốn review UI, accessibility, UX, responsive behavior, form, navigation, motion, content handling, theming hoặc performance pattern.
• Bạn có tệp, directory hoặc glob có phạm vi rõ để kiểm tra.
• Bạn muốn finding cùng location mà không bắt đầu implementation.

Chọn workflow khác khi

• Bạn muốn design direction rộng hơn hoặc recommendation đi kèm. Dùng ak:ui-ux-pro-max.
• Bạn muốn sửa issue trong code. Hãy review trước, sau đó cấp quyền cho workflow implementation riêng như ak:frontend-design.
• Bạn cần token architecture hoặc component spec. Dùng ak:design-system.

Chuẩn bị audit scope và runtime

Cung cấp tệp hoặc pattern chính xác, framework cùng browser target liên quan và mọi exception đã duyệt. Xác nhận cho phép network access vì workflow fetch https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md trước mỗi lần review. Nếu không có scope, Skill sẽ hỏi.

Hoàn thành Làm quen và xem Runtime adapter.

Chạy Skill

/ak:web-design-guidelines app/launch/**/*.tsx Review only these files. Fetch the current guidelines, report file:line findings, and do not edit code, install packages, or access live accounts

/ak:web-design-guidelines app/launch/**/*.tsx Review only these files. Fetch the current guidelines, report file:line findings, and do not edit code, install packages, or access live accounts

$ak:web-design-guidelines app/launch/**/*.tsx Review only these files. Fetch the current guidelines, report file:line findings, and do not edit code, install packages, or access live accounts

Argument canonical là [file-or-pattern]. Skill không định nghĩa mode hay fix flag.

Hiểu các giai đoạn

1. Xác nhận scope. Workflow resolve tệp hoặc pattern được cung cấp và tránh code không liên quan.
2. Fetch rule hiện tại. Workflow lấy upstream command.md lúc chạy thay vì dùng bản copy gắn với release.
3. Đọc các tệp đã chọn. Workflow chỉ thu thập code cần cho audit.
4. Áp dụng mọi rule đã fetch. Category hiện tại gồm accessibility, focus, form, animation, typography, content, image, performance, navigation, touch, safe area, theming, locale, hydration và interaction.
5. Báo cáo finding. Output được nhóm theo tệp, dùng file:line, nêu issue ngắn gọn và đánh dấu tệp pass khi không có issue.

Giữ review ở chế độ read-only

Việc fetch public rule file không cấp quyền upload local source, browse site khác, đổi code, cài checker, mở pull request, publish hay deploy. Fix cần request riêng và verification project thông thường.

Xác minh finding và bằng chứng

Audit hoàn tất nên nêu scope được review, upstream URL cùng retrieval evidence, mọi finding với local line hợp lệ và pass marker khi phù hợp. Hãy spot-check code được trích và xác nhận rule áp dụng trong bối cảnh framework cùng runtime của project.

Báo cáo là static source review, không phải bằng chứng từ browser, assistive technology, user test, performance trace hay formal accessibility assessment.

Xử lý sự cố hoặc tiếp tục

Tiếp tục với Tổng quan Marketing Kit hoặc Projects, artifacts và checkpoints.

Biết các giới hạn hiện tại

• Stable và beta chứa nội dung ak:web-design-guidelines byte-identical trong các release đã kiểm tra.
• Guideline body phụ thuộc network và không được bundle hay version-pin.
• Upstream rule là heuristic rộng. Một số finding cần context framework, product, browser, locale hoặc assistive technology.
• Báo cáo sạch không đảm bảo accessibility, usability, responsiveness, performance, security, conversion hay standards compliance.