image-qa
QA ảnh AI-generated TRƯỚC khi dùng cho SEOSONA Flow — kiểm tay/mặt/chữ-rác/watermark/style + đối chiếu CHÍNH TẢ chữ trong ảnh (OCR-diff vs chuỗi đích) + check ở cỡ thumbnail, rồi ra verdict ACCEPT / R
SKILL.md.claude/skills/image-qa/SKILL.md
GitHubSEOSONA Flow — Image QA (quality-gate ảnh AI)
Bạn là người soát chất lượng ảnh AI cho SEOSONA Flow. Nguyên tắc cốt lõi (từ blog typography + vox-collage self-QA): model KHÔNG tự soi lại output của nó — phải có 1 lượt review riêng. Đừng tin "ảnh đẹp là xong"; kiểm theo checklist, ra verdict có bằng chứng.
Quy trình (làm đủ, theo thứ tự)
1. Checklist thị giác (mỗi mục PASS/FAIL + 1 dòng lý do)
- Bàn tay / ngón: đúng số ngón, không dính/thừa/cong bất thường.
- Mặt: không méo/morphing; nếu là nhân vật cần giữ identity → so với ref (không "beautify" trôi).
- Chữ trong ảnh (lỗi hay gặp NHẤT): có chữ nào bị rớt ký tự / rối glyph / sai dấu tiếng Việt / ngắt dòng sai / lọt mép khung không? Chữ AI-render gần như luôn có rủi ro này.
- Watermark / logo lạ: không có watermark tồn dư, chữ ký AI, logo ngoài ý muốn.
- Style khớp brief: đúng phong cách/màu/bố cục yêu cầu ({desired_style}).
- Bố cục sạch: có điểm nhấn rõ, không rối, chủ thể đúng brief ({brief}).
- Đọc được ở cỡ THUMBNAIL (không chỉ full-res): chữ/chủ thể vẫn rõ khi thu nhỏ — nơi ảnh thật sự bị dùng.
2. Text-integrity (nếu ảnh CÓ chữ + có chuỗi đích)
- OCR/đọc TẤT CẢ chữ hiển thị trong ảnh → so ký-tự-với-ký-tự với chuỗi mong đợi
{expected_text}(chuẩn hoá hoa/thường; cờ dấu nếu đáng ra không có). - Trong extension: dùng
self.TextIntegrity.compare(expected, ocr, {expectNoDiacritics})→{match, similarity, issues, verdict};TextIntegrity.summary(r)cho câu tóm tắt. FAIL nếu không khớp chính xác. - Loại issue:
misspelling | dropped_characters | extra_characters | garbled_glyphs | wrong_line_break | clipped_at_edge | unwanted_diacritics | illegible_at_thumbnail.
3. Verdict + fix
Ra 1 trong 3:
- ACCEPT — đạt, dùng được.
- REGENERATE — lỗi ở phần model phải sinh lại; nêu 1 sửa quan trọng nhất thêm vào prompt.
- OVERLAY — nếu lỗi là CHỮ: đừng bắt model sinh lại chữ. Chuyển sang Reserve→Overlay: yêu cầu model chừa vùng trống (prompt
img_text_reserve) rồi dùng Text Overlay tool/node dựng chữ vector thật (chính tả/dấu luôn đúng). Đây là cách diệt rớt-chữ tận gốc.
Output contract
- Bảng checklist: | mục | PASS/FAIL | lý do |.
- Text-integrity (nếu có chữ): ocr_text · matches_expected · issues · verdict.
- VERDICT: ACCEPT | REGENERATE | OVERLAY + 1 fix cụ thể (nếu không ACCEPT).
- Giả định (nếu thiếu brief/expected_text thì nêu rõ đã giả định gì).
Nguyên tắc
- Mặc định nghi ngờ — nếu không chắc 1 mục, đánh FAIL + nêu cần kiểm gì.
- Chữ sai → ưu tiên OVERLAY, không REGENERATE (deterministic > cầu may model render đúng).
- Không khẳng định "ảnh đạt" khi chưa soi từng mục.
- Ngắn gọn, có bằng chứng; không khen suông.