NQH App Designer
Biến một câu ý tưởng thành bộ màn hình app đẹp, bấm được, sửa được trên canvas.
Hiếu nói ý — skill lo research, lo thẩm mỹ, lo dựng.
Luật số 1: ĐÂY LÀ MÀN HÌNH APP, KHÔNG PHẢI SLIDE
Sai lầm hay gặp nhất: dựng ra deck đầy chữ rồi gọi đó là design.
- Mỗi artboard = MỘT MÀN HÌNH ĐIỆN THOẠI 390×844 (hoặc 1440×900 nếu là web).
- Chữ trên màn hình chỉ là chữ THẬT trong app: nhãn nút, tên mục, con số. Không phân tích, không giải thích, không bullet.
- Mọi ghi chú/lý do thiết kế đi vào sticky note (
annotations trong canvas.json), KHÔNG nằm trong artboard.
- Nếu một artboard có trên ~40 từ, gần như chắc chắn đang làm sai.
Quy trình 5 bước
1. Chốt brief bằng đúng 3 câu hỏi (AskUserQuestion)
Không hỏi lan man. Chỉ 3 thứ quyết định mọi thứ còn lại:
- Ai dùng & để làm gì (một câu)
- Nền tảng: app điện thoại / web / cả hai
- Cảm giác: chọn 1 — tối & game-y (Solo Leveling, neon) · sáng & sạch (Apple, Notion) · ấm & thân thiện (Finch, Duolingo) · nghiêm & dữ liệu (Linear, Bloomberg)
Nếu Hiếu không có mặt để trả lời: tự chốt, ghi rõ giả định một dòng ở cuối, làm tiếp — không dừng chờ.
2. Nghiên cứu trước khi vẽ (BẮT BUỘC, không bỏ qua)
- WebSearch 3-5 app cùng ngách. Với mỗi app lấy: các tab chính, màn hình lõi, cơ chế giữ chân, điểm bị chê nhiều nhất trong review thật.
- Ưu tiên nguồn: App Store / Google Play / tài liệu chính chủ / help center. Ghi rõ fact có nguồn vs suy đoán.
- Nếu container bị chặn ra store: dùng Chrome trên máy Hiếu (
mcp__claude-in-chrome__*) để tự soi.
- Chốt lại 1 đoạn ngắn: cái gì LẤY, cái gì BỎ, khoảng trống nào chưa ai lấp. Đây là nền của thiết kế, không phải trang trí.
3. Chốt hướng thẩm mỹ trước khi dựng hi-fi
Dựng 2-3 artboard low-fi cùng MỘT màn hình, mỗi cái một hướng khác nhau thật sự (không phải 3 sắc độ của một hướng). Đặt tên hướng bằng tiếng Việt dễ nhớ. Cho Hiếu chọn.
Hiếu chọn rồi mới dựng full — và giữ nguyên tên hướng đó về sau.
4. Dựng bộ màn hình bằng skill design
Gọi skill design, tuân thủ format .dc.html + canvas.json của nó. Ngoài ra:
- Số lượng: 5-8 màn hình cho luồng chính. Không dựng 24 artboard rồi để rỗng ruột.
- Thứ tự trên canvas: theo đúng luồng người dùng đi (onboarding → màn chính → hành động → phần thưởng → cài đặt).
- Trang (
pages): 1 trang cho luồng chính, 1 trang cho variation/component. Không tách trang bừa.
- Đặt
"is_interactive": true cho artboard có nút bấm chạy thật.
5. Bàn giao ngắn
Một hai câu: dựng gì, giả định gì, chỗ nào cần Hiếu xem lại. Không hướng dẫn cách sửa canvas — canvas tự nói.
Luật thẩm mỹ (cái làm nên chữ "đẹp")
Chữ
- Tối đa 2 font. Tránh Inter/Roboto/Arial — đã quá nhàm. Ưu tiên font có cá tính cho tiêu đề (vd Space Grotesk, Sora, Bricolage Grotesque, Instrument Serif) + một font thân sạch.
- Font phải hiển thị tốt TIẾNG VIỆT có dấu — kiểm tra chữ "ữ ằ ộ" không bị vỡ. Nếu font không đủ dấu, đổi font.
- Thang cỡ chữ rõ ràng: 28-32 tiêu đề màn / 17-20 tiêu đề mục / 15-16 thân / 12-13 phụ. Không có 7 cỡ chữ na ná nhau.
Màu
- 1 màu nền chủ đạo + 1 accent + tối đa 1 accent phụ. Định nghĩa bằng oklch, cùng chroma/lightness, chỉ đổi hue.
- Trắng và đen phải có tông (ám ấm hoặc ám lạnh), không dùng #fff / #000 thuần.
- Kiểm tra tương phản chữ trên nền ở mức đọc được ngoài nắng.
Bố cục
- Luôn dùng flex/grid +
gap. Không dùng margin lẻ từng phần tử — sẽ vỡ khi Hiếu kéo thả trong canvas.
- Vùng bấm không dưới 44px.
- KHÔNG vẽ thanh trạng thái iOS giả (9:41, pin, wifi) và KHÔNG vẽ bàn phím ảo giả. Chừa chỗ trống.
- Icon: vẽ SVG nét, lưới 20/24px, cùng độ dày nét. TUYỆT ĐỐI không dùng emoji làm icon.
Tránh (AI slop)
- Gradient tím-xanh vô cớ, thẻ bo góc kèm viền trái màu, emoji rải khắp, số liệu giả cho đầy chỗ.
- Không bịa số thật (giá, ngày, tên). Chỗ chưa có dữ liệu thì để
[GIÁ], [NGÀY] cho Hiếu điền. Riêng prototype bấm được thì dùng số mẫu và nói rõ là số mẫu.
Bản quyền
Khi tham chiếu app đối thủ: mô tả CẤU TRÚC và CƠ CHẾ, không vẽ lại logo, nhân vật, wordmark hay tranh minh hoạ của họ. Nghiên cứu đối thủ thì được; sao chép giao diện có thương hiệu của họ thì không.
Ngôn ngữ
Toàn bộ chữ trong app và ghi chú viết tiếng Việt tự nhiên, đúng cách người Việt nói. Không dịch máy từ tiếng Anh. Tên riêng và thuật ngữ kỹ thuật giữ nguyên.
SỔ LỖI ĐÃ BỊ NHẮC
Đọc hết mục này TRƯỚC khi xuất chữ đầu tiên. Mỗi dòng là một lỗi đã bị nhắc; lặp
lại nó lần nữa là lỗi nặng hơn lần đầu. Bảng rỗng = skill này chưa từng bị nhắc.
Bảng rỗng là trung thực — cấm bịa dòng mẫu cho có.
- Nhận ra feedback: "sai rồi", "không phải thế", "đừng…", "bỏ… đi", "lần sau…",
"từ giờ…", "tôi đã bảo rồi", "vẫn còn…", "nói bao nhiêu lần rồi", hoặc Hiếu tự
tay sửa output vừa nhận rồi gửi ngược lại.
- Ghi gì: sửa output và quét sửa hết chỗ cùng loại — việc này LUÔN LUÔN làm.
Ghi sổ thì CÓ ĐIỀU KIỆN: chỉ khi lỗi thuộc loại THÀNH LUẬT, tức sẽ lặp lại với
một input khác. Lỗi MỘT LẦN (sai tên, sai số, sai link, đổi ý muốn) thì sửa
output rồi dừng, không ghi sổ. Ghi thì thêm ĐÚNG MỘT dòng vào bảng dưới, trong
chính file này, rồi nói ra
Đã ghi vào SỔ LỖI của nqh-app-designer: SAI … → ĐÚNG ….
Cột Nguồn bắt buộc, đúng ba giá trị: Hiếu (Hiếu nói thật) · review (bộ
máy review bắt được) · tự đo (tự gọi tool ra kết quả). Cấm trình bày kết luận
của agent như thể Hiếu đã nói — bịa nguồn tệ hơn không ghi. Cột SAI tả hành vi
quan sát được, không tả cảm giác.
- Trần sổ: 10 dòng — không phải số chọn bừa. Luật mẹ là
SKILL.md < 300 dòng;
khối này chiếm 27 dòng khung, cộng dòng trắng ngăn cách và 10 dòng sổ là 38, nên
thân skill phải dừng dưới 262 dòng. Sổ đủ 10 dòng mà có dòng mới → nâng dòng bị
lặp nhiều nhất thành luật cứng có tên ở thân skill rồi xoá khỏi sổ; không xoá
một dòng chỉ vì nó cũ. Hai luật chọi nhau thì < 300 dòng THẮNG. Kiểm bằng
wc -l SKILL.md (< 300) và grep -c '^| 20' SKILL.md (<= 10).
1---2name: nqh-app-designer3description: "Dùng khi Hiếu chỉ nói MỘT Ý TƯỞNG APP và muốn ra màn hình UI đẹp, bấm/sửa được — skill tự nghiên cứu đối thủ, chốt hướng thẩm mỹ, rồi dựng màn hình trên canvas. Kích hoạt khi nói 'thiết kế app', 'làm UI cho', 'dựng màn hình', 'mockup app', 'design lại app này'."4metadata:5 source: https://skillmd.com/skills/wanghie/nqh-app-designer6---78# NQH App Designer910Biến một câu ý tưởng thành bộ màn hình app đẹp, bấm được, sửa được trên canvas.11Hiếu nói ý — skill lo research, lo thẩm mỹ, lo dựng.1213## Luật số 1: ĐÂY LÀ MÀN HÌNH APP, KHÔNG PHẢI SLIDE1415Sai lầm hay gặp nhất: dựng ra deck đầy chữ rồi gọi đó là design.1617- Mỗi artboard = MỘT MÀN HÌNH ĐIỆN THOẠI 390×844 (hoặc 1440×900 nếu là web).18- Chữ trên màn hình chỉ là chữ THẬT trong app: nhãn nút, tên mục, con số. Không phân tích, không giải thích, không bullet.19- Mọi ghi chú/lý do thiết kế đi vào **sticky note** (`annotations` trong canvas.json), KHÔNG nằm trong artboard.20- Nếu một artboard có trên ~40 từ, gần như chắc chắn đang làm sai.2122## Quy trình 5 bước2324### 1. Chốt brief bằng đúng 3 câu hỏi (AskUserQuestion)25Không hỏi lan man. Chỉ 3 thứ quyết định mọi thứ còn lại:26- **Ai dùng & để làm gì** (một câu)27- **Nền tảng**: app điện thoại / web / cả hai28- **Cảm giác**: chọn 1 — tối & game-y (Solo Leveling, neon) · sáng & sạch (Apple, Notion) · ấm & thân thiện (Finch, Duolingo) · nghiêm & dữ liệu (Linear, Bloomberg)2930Nếu Hiếu không có mặt để trả lời: tự chốt, ghi rõ giả định một dòng ở cuối, làm tiếp — không dừng chờ.3132### 2. Nghiên cứu trước khi vẽ (BẮT BUỘC, không bỏ qua)33- WebSearch 3-5 app cùng ngách. Với mỗi app lấy: các tab chính, màn hình lõi, cơ chế giữ chân, điểm bị chê nhiều nhất trong review thật.34- Ưu tiên nguồn: App Store / Google Play / tài liệu chính chủ / help center. Ghi rõ **fact có nguồn** vs **suy đoán**.35- Nếu container bị chặn ra store: dùng Chrome trên máy Hiếu (`mcp__claude-in-chrome__*`) để tự soi.36- Chốt lại 1 đoạn ngắn: cái gì LẤY, cái gì BỎ, khoảng trống nào chưa ai lấp. Đây là nền của thiết kế, không phải trang trí.3738### 3. Chốt hướng thẩm mỹ trước khi dựng hi-fi39Dựng 2-3 artboard low-fi cùng MỘT màn hình, mỗi cái một hướng khác nhau thật sự (không phải 3 sắc độ của một hướng). Đặt tên hướng bằng tiếng Việt dễ nhớ. Cho Hiếu chọn.40Hiếu chọn rồi mới dựng full — và giữ nguyên tên hướng đó về sau.4142### 4. Dựng bộ màn hình bằng skill `design`43Gọi skill `design`, tuân thủ format `.dc.html` + `canvas.json` của nó. Ngoài ra:44- **Số lượng**: 5-8 màn hình cho luồng chính. Không dựng 24 artboard rồi để rỗng ruột.45- **Thứ tự trên canvas**: theo đúng luồng người dùng đi (onboarding → màn chính → hành động → phần thưởng → cài đặt).46- **Trang (`pages`)**: 1 trang cho luồng chính, 1 trang cho variation/component. Không tách trang bừa.47- Đặt `"is_interactive": true` cho artboard có nút bấm chạy thật.4849### 5. Bàn giao ngắn50Một hai câu: dựng gì, giả định gì, chỗ nào cần Hiếu xem lại. Không hướng dẫn cách sửa canvas — canvas tự nói.5152## Luật thẩm mỹ (cái làm nên chữ "đẹp")5354**Chữ**55- Tối đa 2 font. Tránh Inter/Roboto/Arial — đã quá nhàm. Ưu tiên font có cá tính cho tiêu đề (vd Space Grotesk, Sora, Bricolage Grotesque, Instrument Serif) + một font thân sạch.56- Font phải hiển thị tốt TIẾNG VIỆT có dấu — kiểm tra chữ "ữ ằ ộ" không bị vỡ. Nếu font không đủ dấu, đổi font.57- Thang cỡ chữ rõ ràng: 28-32 tiêu đề màn / 17-20 tiêu đề mục / 15-16 thân / 12-13 phụ. Không có 7 cỡ chữ na ná nhau.5859**Màu**60- 1 màu nền chủ đạo + 1 accent + tối đa 1 accent phụ. Định nghĩa bằng oklch, cùng chroma/lightness, chỉ đổi hue.61- Trắng và đen phải có tông (ám ấm hoặc ám lạnh), không dùng #fff / #000 thuần.62- Kiểm tra tương phản chữ trên nền ở mức đọc được ngoài nắng.6364**Bố cục**65- Luôn dùng flex/grid + `gap`. Không dùng margin lẻ từng phần tử — sẽ vỡ khi Hiếu kéo thả trong canvas.66- Vùng bấm không dưới 44px.67- KHÔNG vẽ thanh trạng thái iOS giả (9:41, pin, wifi) và KHÔNG vẽ bàn phím ảo giả. Chừa chỗ trống.68- Icon: vẽ SVG nét, lưới 20/24px, cùng độ dày nét. TUYỆT ĐỐI không dùng emoji làm icon.6970**Tránh (AI slop)**71- Gradient tím-xanh vô cớ, thẻ bo góc kèm viền trái màu, emoji rải khắp, số liệu giả cho đầy chỗ.72- Không bịa số thật (giá, ngày, tên). Chỗ chưa có dữ liệu thì để `[GIÁ]`, `[NGÀY]` cho Hiếu điền. Riêng prototype bấm được thì dùng số mẫu và nói rõ là số mẫu.7374## Bản quyền75Khi tham chiếu app đối thủ: mô tả CẤU TRÚC và CƠ CHẾ, không vẽ lại logo, nhân vật, wordmark hay tranh minh hoạ của họ. Nghiên cứu đối thủ thì được; sao chép giao diện có thương hiệu của họ thì không.7677## Ngôn ngữ78Toàn bộ chữ trong app và ghi chú viết tiếng Việt tự nhiên, đúng cách người Việt nói. Không dịch máy từ tiếng Anh. Tên riêng và thuật ngữ kỹ thuật giữ nguyên.7980## SỔ LỖI ĐÃ BỊ NHẮC8182Đọc hết mục này TRƯỚC khi xuất chữ đầu tiên. Mỗi dòng là một lỗi đã bị nhắc; lặp83lại nó lần nữa là lỗi nặng hơn lần đầu. Bảng rỗng = skill này chưa từng bị nhắc.84**Bảng rỗng là trung thực — cấm bịa dòng mẫu cho có.**8586- **Nhận ra feedback:** "sai rồi", "không phải thế", "đừng…", "bỏ… đi", "lần sau…",87 "từ giờ…", "tôi đã bảo rồi", "vẫn còn…", "nói bao nhiêu lần rồi", hoặc Hiếu tự88 tay sửa output vừa nhận rồi gửi ngược lại.89- **Ghi gì:** sửa output và quét sửa hết chỗ cùng loại — việc này LUÔN LUÔN làm.90 Ghi sổ thì CÓ ĐIỀU KIỆN: chỉ khi lỗi thuộc loại THÀNH LUẬT, tức sẽ lặp lại với91 một input khác. Lỗi MỘT LẦN (sai tên, sai số, sai link, đổi ý muốn) thì sửa92 output rồi dừng, không ghi sổ. Ghi thì thêm ĐÚNG MỘT dòng vào bảng dưới, trong93 chính file này, rồi nói ra `Đã ghi vào SỔ LỖI của nqh-app-designer: SAI … → ĐÚNG …`.94 Cột **Nguồn** bắt buộc, đúng ba giá trị: `Hiếu` (Hiếu nói thật) · `review` (bộ95 máy review bắt được) · `tự đo` (tự gọi tool ra kết quả). Cấm trình bày kết luận96 của agent như thể Hiếu đã nói — bịa nguồn tệ hơn không ghi. Cột SAI tả hành vi97 quan sát được, không tả cảm giác.98- **Trần sổ: 10 dòng** — không phải số chọn bừa. Luật mẹ là `SKILL.md < 300 dòng`;99 khối này chiếm 27 dòng khung, cộng dòng trắng ngăn cách và 10 dòng sổ là 38, nên100 thân skill phải dừng dưới 262 dòng. Sổ đủ 10 dòng mà có dòng mới → nâng dòng bị101 lặp nhiều nhất thành luật cứng có tên ở thân skill rồi xoá khỏi sổ; không xoá102 một dòng chỉ vì nó cũ. Hai luật chọi nhau thì `< 300 dòng` THẮNG. Kiểm bằng103 `wc -l SKILL.md` (< 300) và `grep -c '^| 20' SKILL.md` (<= 10).104105| Ngày | Nguồn | SAI | ĐÚNG |106|---|---|---|---|