Imported from tongo0209/agent-auto (skills/check-promotion/SKILL.md). Install upstream with npx skills add tongo0209/agent-auto --skill check-promotion. Copyright stays with the author.

Skill: check-promotion

Validate file HTML landing page VNG theo loại promotion. Output bảng Pass/Fail checklist kiểm tra đủ popup và cấu trúc popup đúng chuẩn. KHÔNG check pm__ class (nếu cần điền/kiểm tra pm__ class → dùng skill fill-pm-class).

Cách gọi

/check-promotion <loại|STT> <file>
/check-promotion <loại|STT>           ← file tự detect từ IDE
/check-promotion                      ← thiếu loại: skill in bảng 39 loại, user nhập STT/tên rồi tiếp tục

<loại> nhận: STT (1-39 theo danh sách platform), tên trên platform (không phân biệt hoa/thường), hoặc slug/alias. User TỰ NHẬP loại — skill KHÔNG đoán loại từ file, KHÔNG hiện list option cho chọn (không dùng AskUserQuestion cho việc chọn loại). Thiếu loại/gõ không match → in bảng 39 loại và chờ user nhập (xem Bước 0). Phân biệt argument: token kết thúc .html hoặc chứa / → là file, còn lại → là loại. Path trong dấu nháy (có thể chứa khoảng trắng) là MỘT token file duy nhất — KHÔNG lấy chữ bên trong path (VD tên folder chứa "AFFILIATE") làm loại; loại chỉ match từ argument đứng riêng ngoài path.

39 promotion type (theo danh sách platform)

Ghi chú bảng:

• File checklist trong reference/ đặt tên theo format <STT>-<slug>.md của loại chính. File dùng chung cho nhiều loại thì đặt theo loại gốc (VD 02-rut-tham-may-man.md dùng cho STT 2, 4, 5, 24, 26, 31 và các combo).
• (merge): loại combo — load TẤT CẢ file checklist được liệt kê, gộp required_popups (union, dedup theo popup chính; item trùng thì gộp variant).
• (tạm): chưa có checklist riêng, dùng checklist của cơ chế gần nhất.
• — ở cột Checklist: chưa có checklist → báo lỗi theo skip rule ở Bước 2, KHÔNG tự dùng checklist của loại khác.
• Alias affiliate gõ trần → hiểu là STT 22 (cùng checklist với 37 nên kết quả như nhau).
• 2 checklist phụ không gắn với type platform nào: milestone.md (gọi rõ /check-promotion milestone khi landing có milestone section) và event.md (generic, gọi rõ /check-promotion su-kien).

Workflow

Bước 0 — Parse arguments

Từ prompt user, extract:

1. Loại promotion (BẮT BUỘC — user tự nhập): match theo thứ tự ưu tiên — (a) STT 1-39, (b) tên trên platform (không phân biệt hoa/thường, chấp nhận thiếu phần "PROMOTIONTYPES."), (c) slug/alias từ bảng trên, (d) checklist phụ: milestone/moc-thuong → reference/milestone.md, event/su-kien → reference/event.md (không tra bảng 39 loại, sang thẳng Bước 2 với file đó). Tên match trùng nhiều STT (VD "RÚT THĂM MAY MẮN & ĐỔI QUÀ V2" khớp cả 24 và 31) → lấy STT nhỏ nhất.
2. File path (tuỳ chọn): nếu user cung cấp path hoặc tên file.

Nếu KHÔNG có loại trong prompt (hoặc gõ không match): KHÔNG tự đoán loại từ file, KHÔNG dùng AskUserQuestion để chọn loại. In NGUYÊN VĂN bảng dưới đây ra chat (đủ 39 dòng, không rút gọn) rồi DỪNG chờ user trả lời; câu trả lời của user parse lại theo rule (a)-(d) ở trên:

👉 Nhập STT (1-39) hoặc tên loại để tiếp tục. (✓ = đã có checklist; — = chưa có — chọn vẫn được nhưng sẽ nhận thông báo skip rule ở Bước 2.)

Ví dụ parse:

• /check-promotion → thiếu loại → in bảng 39 loại + chờ user nhập STT/tên
• /check-promotion 22 → STT 22 = MỜI BẠN BÈ NHẬN QUÀ → checklist 22-moi-ban-be-nhan-qua.md, file = detect từ IDE
• /check-promotion vong-quay iframe_vong_quay.html → STT 39 → 39-vong-quay.md, file = iframe_vong_quay.html
• /check-promotion nap-tien → STT 13 = KHUYẾN MÃI NẠP → 13-khuyen-mai-nap.md, file = detect từ IDE
• /check-promotion "rút thăm may mắn & đổi quà" → STT 5 → 02-rut-tham-may-man.md
• /check-promotion abcxyz → không match → in bảng 39 loại + chờ user nhập lại
• /check-promotion shop → STT 12, chưa có checklist → báo lỗi theo skip rule (Bước 2)

Bước 1 — Xác định file target

Reuse logic từ skill fill-pm-class (cùng thứ tự ưu tiên):

1.1. SCAN MESSAGE HIỆN TẠI tìm tag <ide_opened_file>

Đọc chính xác message user vừa gửi. Tìm pattern:

<ide_opened_file>The user opened the file <PATH> in the IDE. ...</ide_opened_file>

Extract path từ tag.

1.2. Quyết định file target

Case A — Tag <ide_opened_file> tồn tại với path .html:

• Dùng path đó làm target NGAY LẬP TỨC.

Case B — User prompt có path/tên file .html (đã extract ở Bước 0):

• Full path → dùng luôn.
• Chỉ tên file → Glob **/<filename> để tìm full path.

Case C — KHÔNG có tag VÀ KHÔNG có path trong prompt:

1. Glob **/*.html lấy 5 file mới modify nhất.
2. AskUserQuestion với 4 options (file top 1-4).
3. Question ngắn: "File HTML nào cần check?".

1.3. Verification

Print dòng confirm: 🎯 Target: <path> Đọc file bằng Read tool. Nếu fail → báo lỗi + chuyển Case C.

Bước 2 — Load checklist

Tra cột Checklist trong bảng ở section "39 promotion type" phía trên để biết file cần load từ reference/. Ví dụ: STT 13 (nap-tien) → load reference/13-khuyen-mai-nap.md; STT 27 → load reference/27-diem-danh-rut-tham.md + reference/02-rut-tham-may-man.md. Checklist phụ (đã chốt ở Bước 0d): load thẳng reference/milestone.md hoặc reference/event.md, không tra bảng.

Extract từ (các) file:

• required_popups → danh sách popup bắt buộc (section ## required_popups).
• Popup structure rules (section ## POPUP STRUCTURE CHECK — duplicate trong mỗi file).

Merge rule (loại combo, nhiều file checklist): gộp required_popups của các file — union theo popup chính (popup_login, popup_register...), item trùng nhau thì gộp danh sách variant lại. Trong output ghi rõ item đến từ checklist nào nếu chỉ có ở 1 file.

Lưu ý: file reference có thể chứa section ## required_pm_classes — BỎ QUA section này, KHÔNG check pm__ class.

Skip rule: nếu cột Checklist của loại là — (hoặc file được map không tồn tại) → báo lỗi: "Loại <tên platform> (STT X) chưa có checklist. Vui lòng tạo reference/<STT>-<slug>.md và cập nhật cột Checklist trước khi dùng." KHÔNG tự dùng checklist của loại khác.

Bước 3 — Parse & validate HTML

Đọc toàn bộ file HTML target. Thực hiện 3 layer check:

Layer 1 — Popups Required

Scan: Tìm tất cả element container có id bắt đầu bằng popup — thường là <section> nhưng một số template (VD TLBB) dùng <div id="popup_*"> bọc trong section khác. Regex: <(?:section|div)[^>]*id="(popup[^"]*)".

Match logic: Mỗi item trong required_popups có thể list nhiều variant ID (cách nhau bởi "hoặc"). Item pass nếu BẤT KỲ variant nào match với popup ID tìm được trong file.

Ví dụ: popup_login (hoặc popup_dangnhap, popupDangnhap) → pass nếu file có popup_login HOẶC popup_dangnhap HOẶC popupDangnhap.

Optional popup: item có đánh dấu (optional...) trong required_popups → BỎ QUA hoàn toàn: KHÔNG check Pass/Fail ở Layer 1, KHÔNG tính vào X/Y ở Tổng kết; nếu popup (hoặc variant) tồn tại trong file → KHÔNG tính là popup thừa ở Layer 2 và KHÔNG chạy structure check Layer 3 cho popup đó. Không hiện trong bảng Popups Required (hoặc hiện với status ⏭️ Skip, không tính điểm). VD: popup_condition là optional với checklist payment (13-khuyen-mai-nap.md).

Kết quả: Mỗi item (trừ optional) → ✅ Pass (ghi popup ID match được) hoặc ❌ Fail.

Layer 2 — Popups Extra

So sánh: Lấy tất cả popup ID trong file TRỪ những ID đã match ở Layer 1 VÀ TRỪ các variant của item (optional).

Kết quả: Mỗi popup extra → ⚠️ Warning.

Layer 3 — Cấu trúc Popup Quan Trọng

Chỉ check cho popup đã tồn tại trong file. Đọc section "POPUP STRUCTURE CHECK" trong checklist — rules trong file checklist của loại đang check là CHUẨN và GHI ĐÈ default dưới đây. Default dưới đây chỉ áp dụng khi file checklist không định nghĩa riêng.

popup_register (hoặc variant — popup đăng ký thông tin): Check bên trong popup đó có (áp dụng cho MỌI loại promotion):

1. <form> bên trong popup → ✅/❌
2. Trong form: select[name="ServerID"] với <option> ĐẦU TIÊN có class server-select-title → ✅/❌ (select có nhưng option đầu sai/thiếu class → ❌, ghi lý do)
3. Trong form: select thứ 2 select[name="CharacterID"] với <option> ĐẦU TIÊN có class character-select-title → ✅/❌
4. Trong form: button[type="submit"] hoặc button/a đóng vai trò submit → ✅/❌

popup_condition (hoặc variant): Check bên trong popup đó có:

1. form có id chứa "condition" → ✅/❌
2. Ít nhất 1 input → ✅/❌
3. MỌI thẻ <form> trong popup có button submit RIÊNG nằm trong form đó (button[type="submit"] hoặc button/a submit) → ✅/❌ — NGOẠI TRỪ form invite (id/class/name chứa invite/loimoi/moiban) và form share FB (id/class/name chứa share/fb/facebook): 2 dạng này bỏ qua không check submit. Mỗi form vi phạm → 1 dòng ❌ Fail riêng, ghi rõ form (id/class + line).

popup_inform (hoặc variant): Check bên trong section đó có:

1. <p> trong .MS__content/.content → ✅/❌

QUAN TRỌNG: Khi check "bên trong popup", giới hạn scope từ tag mở của element popup (<section id="popup_xxx"> hoặc <div id="popup_xxx">) đến tag đóng tương ứng của nó. Không check toàn bộ file.

Bước 4 — Output kết quả

Print output theo format sau:

🎯 Target: <path>
📋 Loại: STT <X> — <TÊN TRÊN PLATFORM> (input user: <loại user gõ>) — checklist: <file(s).md>

## Popups Required
| # | Popup | Status | Ghi chú |
|---|-------|--------|---------|
| 1 | popup_login | ✅ Pass | Matched: popup_login (line XX) |
| 2 | popup_register | ❌ Fail | Không tìm thấy (variants: popup_register, popup_dangky, popupChonNV) |

## Popups Extra
| Popup | Ghi chú |
|-------|---------|
| popup_doiqua | ⚠️ Không nằm trong checklist 39-vong-quay |

(Nếu không có popup extra, ghi: "Không có popup thừa.")

## Cấu trúc Popup Quan Trọng
| Popup | Check | Status |
|-------|-------|--------|
| popup_register | form bên trong popup | ✅ Pass |
| popup_register | select[name="ServerID"] + option đầu class server-select-title | ✅ Pass |
| popup_register | select[name="CharacterID"] + option đầu class character-select-title | ❌ Fail — option đầu thiếu class character-select-title |
| popup_register | button submit | ✅ Pass |
| popup_condition | form id chứa "condition" | ✅ Pass |
| popup_condition | input | ✅ Pass |
| popup_condition | button submit | ✅ Pass |
| popup_inform | <p> trong content | ✅ Pass |

(Chỉ show popup nào tồn tại trong file. Popup không tồn tại → không hiện trong bảng này.)

## Tổng kết: X/Y Passed [ICON]
❌ Thiếu: [danh sách items fail]
⚠️ Warning: [danh sách warnings — popup thừa + ServerID thiếu]

Quy tắc tính X/Y ở Tổng kết: Y = tổng số item required popups (Layer 1) + tổng số structure check đã chạy (Layer 3, chỉ các popup tồn tại trong file). X = số item ✅ Pass trong đó. Warning không tính vào X/Y.

Header cho checklist phụ (milestone/event — không có STT): ghi 📋 Loại: Checklist phụ — <milestone|event> — checklist: <file>.md.

Quy tắc icon tổng kết:

• Tất cả Pass + không warning → ✅
• Tất cả Pass + có warning → ⚠️
• Có ít nhất 1 Fail → ❌

Bước 5 — Kết thúc

Sau khi output, KHÔNG tự sửa file. Skill này chỉ báo cáo (read-only).

Gợi ý cho user nếu có fail:

• Nếu thiếu popup → "Gợi ý: thêm popup section thủ công theo template chuẩn"

Nguyên tắc

1. Read-only: Chỉ đọc và báo cáo. KHÔNG sửa file.
2. Flexible ID matching: Popup ID có nhiều variant giữa các game — match bất kỳ variant nào.
3. KHÔNG check pm__ class: skill này chỉ check popup + cấu trúc popup. Section required_pm_classes trong reference (nếu có) → bỏ qua. Việc điền pm__ class thuộc skill fill-pm-class.
4. Popup structure scope: Check cấu trúc bên trong đúng popup section, không phải toàn file.
5. Warning vs Fail: Popup thừa = Warning. Mọi mục structure check của popup_register (form, ServerID + option class, CharacterID + option class, button submit) thiếu = Fail — áp dụng cho TẤT CẢ loại promotion. Còn lại theo checklist của loại.