Master Thiết Kế — 30-thiet-ke-master

Master design skill xử lý 8 loại thiết kế cho ai-business-skills. Một cửa cho cả thiết kế cá nhân (founder, creator) lẫn thương hiệu (logo, campaign, marketing hàng ngày). Tự đọc brand identity từ project context, compose prompt đúng brand voice, và route sang đúng tool: gen trực tiếp qua gpt-image-2, fallback prompt cho 5 nền tảng phổ biến, hoặc dispatch qua Open Design infrastructure.

Toàn bộ skill viết tiếng Việt phổ thông để client có thể đọc, hiểu và fill cùng. Tên field tiếng Anh giữ nguyên để AI parsing không bị phá.

Khi user đưa ảnh reference hoặc xin prompt tạo ảnh/video/storyboard, skill hoạt động như Prompt Director: phân loại intent, phân tích ảnh thành các prompt layer, xuất prompt tiếng Anh copy-paste-ready, rồi nêu rõ cần upload thêm asset nào cho từng ảnh.

8 loại thiết kế

| # | Type | Subject | Khi nào dùng | Tool | |---|------|---------|--------------|------| | 1 | personal-brand | Cá nhân (founder/creator) | Avatar profile, monogram, speaker cover, quote graphic cá nhân | gpt-image-2 raster | | 2 | business-logo | Thương hiệu — logo identity | Logo primary/secondary/mark | gpt-image-2 multi-variant 3-5 hướng + disclaimer human review | | 3 | business-campaign | Brand campaign visual | TVC still, OOH, product hero, key visual chiến dịch | gpt-image-2 raster | | 4 | marketing-day-to-day | Operational marketing | Social post, banner ad, email header, story | gpt-image-2 raster | | 5 | editorial | Long-form publication | Magazine cover, article hero, e-book, lookbook | gpt-image-2 raster | | 6 | infographic | Data/plan/process viz | Roadmap, process flow, comparison chart | gpt-image-2 (text minimal, icons-focused) | | 7 | web-mockup | UI screen sketch | Landing hero, app screen mockup | Hybrid: gen 1 hero image qua gpt-image-2 + recommend HTML skills cho mockup full interactive | | 8 | quote-graphic | Quote post | "Guru post" IG, LinkedIn quote, motivational | Hybrid: gpt-image-2 background + HTML text overlay |

Khi nào trigger / KHÔNG trigger

Triggers (gọi skill này)

• "thiết kế ảnh", "làm logo", "ảnh poster", "banner campaign"
• "social post design", "infographic", "key visual", "hero web mockup"
• "ảnh truyền thông", "avatar cá nhân", "monogram", "quote graphic"
• "prompt MidJourney", "prompt DALL-E", "prompt Leonardo", "prompt Imagen"

DO NOT INVOKE (route sang skill khác)

| Trường hợp | Route sang | |------------|------------| | Full interactive web UI mockup (multi-section, có behavior) | web-prototype / saas-landing / mobile-app / dashboard / frontend-design | | Video creation (TVC, ads video, UGC) | 04-script-video + Seedance/Kling/Sora dispatcher | | Animation, motion graphics, sprite | motion-frames / sprite-animation | | Audio asset (jingle, voiceover, SFX) | audio-jingle | | Document layout (PDF report, e-guide multi-page) | digital-eguide / finance-report / magazine-poster |

Mode detection cascade (Step 0)

Ba lớp phát hiện type theo thứ tự ưu tiên:

Layer 1 — Keyword auto-detect

| Keyword (Vietnamese hoặc English) | Type detect | |-----------------------------------|-------------| | "avatar", "ảnh đại diện", "monogram", "speaker cover", "profile pic" | personal-brand | | "logo", "wordmark", "lockup", "brand mark" | business-logo | | "key visual", "campaign visual", "TVC still", "OOH", "product hero" | business-campaign | | "social post", "banner ads", "email header", "story IG", "post Facebook" | marketing-day-to-day | | "magazine cover", "article hero", "e-book cover", "editorial", "lookbook" | editorial | | "infographic", "roadmap visual", "process flow", "comparison chart", "data viz" | infographic | | "hero web", "landing hero image", "app screen mockup" | web-mockup | | "quote", "quote graphic", "guru post", "motivational post" | quote-graphic | | "ảnh reference", "giống ảnh này", "prompt master", "same style", "same composition" | giữ type hiện tại + bật Prompt Director reference mode | | "đổi màu", "màu thương hiệu", "brand color", "thêm logo", "replace logo" | giữ type hiện tại + bật Prompt Director brand adaptation | | "nhìn AI quá", "chưa giống", "sửa prompt", "màu sai", "font khó đọc" | giữ type hiện tại + bật Prompt Director diagnosis |

Layer 2 — Explicit flag

User truyền --type=business-logo (hoặc 7 type khác) → override Layer 1.

Layer 3 — Ambiguous fallback

Nếu không match keyword và không có flag → hỏi 1 câu duy nhất:

> "Loại thiết kế nào trong 8 lựa chọn dưới? > 1) personal-brand (cá nhân) 2) business-logo 3) business-campaign 4) marketing-day-to-day 5) editorial 6) infographic 7) web-mockup 8) quote-graphic"

In ra transparency line trước khi tiếp tục:

[detect type: business-logo — keyword "logo" + "BHOP" match]

Prompt Director mode

Bật mode này khi user đưa ảnh reference, xin master prompt, muốn đổi mặt/màu/logo, hoặc feedback ảnh ra chưa đúng. Load references/prompt-director.md trước khi compose prompt.

Nguyên tắc xử lý:

• Không hỏi form dài trước. Nếu đủ input, tạo prompt ngay và chỉ ghi phần còn thiếu ở cuối.
• Ảnh reference = style/composition source, không tự xem đó là ảnh mặt/logo trừ khi user nói rõ.
• Asset thay thế phải hỏi rõ theo loại: face reference, logo file, brand palette hex, product image, background/location, exact text.
• Nhiều ảnh = nhiều luồng. Đặt tên Flow A/B/C, nêu vai trò từng ảnh, prompt riêng, negative prompt riêng, và danh sách asset cần upload cho từng flow.
• Prompt cuối cho image/video model mặc định tiếng Anh; phần giải thích và yêu cầu bổ sung dùng tiếng Việt.

Output nhanh khi có reference image:

markdown
## Luồng ảnh

| Flow | Ảnh đầu vào | Vai trò | Output |
|------|-------------|---------|--------|
| A | [file/path] | style/composition reference | master prompt |

## Copy-paste prompt — Flow A
[English prompt]

## Negative prompt / Avoid
[English avoid list]

## Cần upload thêm để cá nhân hóa Flow A
- Face reference:
- Logo:
- Brand colors:
- Exact text:
- Product/background:

Workflow runtime — 5 bước

Step 1 — DETECT design type

Chạy 3-layer cascade ở trên. Print [detect type: ...] trước khi sang Step 2.

Step 2 — LOAD references

Load theo nhu cầu (lazy):

• CONVENTIONS.md — load 1 lần đầu session
• references/prompt-director.md — load khi có ảnh reference, master prompt, đổi mặt/màu/logo, nhiều ảnh, hoặc feedback sửa prompt
• references/<type>.md — load đúng file cho type vừa detect (vd references/business-logo.md)
• references/brand-identity-source.md — load khi type bắt đầu bằng business-*
• references/fallback-prompt-format.md — load khi Tier Free (xem Step 5)
• templates/<format>.md — load template theo format yêu cầu (vd templates/poster.md, templates/social-square.md)

Step 3 — READ brand identity

Business modes (business-logo / business-campaign / marketing-day-to-day): BẮT BUỘC tìm brand identity. Auto-search theo priority:

1. assets/brand/logo.{svg,png,ai} — logo file primary
2. brand-guideline.md / brand-identity.md ở root project
3. 02-brief-chien-dich/output.md Section "Yêu cầu thương hiệu" — campaign brief có brand mandatories
4. prd.md frontmatter target_user + Section "Visual cues" — style direction
5. prd.md Section 6 — features cho visual concept

Nếu thiếu cho business mode → BLOCK + ask user upload logo + specify palette (3 màu hex) + chỉ định font family.

Personal modes (personal-brand / quote-graphic cá nhân): brand identity optional. Đủ với style adjectives (3-5 từ) + color preference (3 mood color).

Editorial / Infographic / Web-mockup: tùy ngữ cảnh — nếu là cho brand thì làm như business, nếu là cá nhân/general thì làm như personal.

Step 4 — ROUTE theo type

| Type | Route action | |------|--------------| | 1-5 (personal-brand, business-logo, business-campaign, marketing-day-to-day, editorial) | COMPOSE prompt raster → sang Step 5 | | 6 (infographic) | COMPOSE prompt với chiến lược text-minimal: icons-heavy, palette branded, tối đa 2-3 number stats, KHÔNG paragraph dài → sang Step 5 | | 7 (web-mockup hybrid) | COMPOSE 1 hero image prompt → Step 5 + print HTML skill recommendation block, exit gracefully sau khi gen hero | | 8 (quote-graphic) | COMPOSE background image prompt (KHÔNG có text in-image) + tạo HTML overlay template (text qua HTML, KHÔNG in-image text) |

Step 5 — CHECK API tier + GENERATE

Detect tier theo Bash:

bash
if [[ -n "$OPENAI_API_KEY" ]]; then
  TIER="pro"   # direct gpt-image-2
elif [[ -n "$OD_BIN" && -x "$OD_BIN" ]]; then
  TIER="enterprise"   # Open Design dispatcher
else
  TIER="free"   # prompt-only fallback
fi

Print line: [tier: <X>] [model: <Y>].

| Tier | Behavior | Output | |------|----------|--------| | Free | Không có API key | docs/design/<slug>-prompt.md với 5 platform paste-ready (DALL-E 3, MidJourney v6, Leonardo, Imagen 3, Bing/Copilot Designer) — xem references/fallback-prompt-format.md | | Pro | OPENAI_API_KEY có sẵn → call gpt-image-2 direct | docs/design/<slug>.png + docs/design/<slug>.md (metadata) | | Enterprise | $OD_BIN có và executable → dispatch qua Open Design infrastructure (existing image-poster infra) | docs/design/<slug>.png + docs/design/<slug>.md (metadata, ghi gen_mode: api-dispatcher) |

Type 7 web mockup — sau khi gen hero image (nếu tier Pro/Enterprise), in recommendation block:

[NEXT STEP] Hero image gen xong. Để có mockup full interactive đa section,
chạy thêm 1 trong các skill:
  - web-prototype (general landing/marketing page)
  - saas-landing (SaaS product page)
  - mobile-app (mobile app screens)
  - dashboard (admin/analytics dashboard)
  - frontend-design (Figma-style design tokens)

Type 8 quote graphic — output 2 file:

• docs/design/<slug>-bg.png — background image gen qua gpt-image-2 (KHÔNG có text)
• docs/design/<slug>.html — HTML overlay với text trên background (text qua HTML để tránh AI méo chữ)

Frontmatter schema cho output file

Mọi file metadata docs/design/<slug>.md PHẢI có frontmatter:

yaml
---
title: <Image asset name>
type_artifact: image-generated | image-prompt-fallback | infographic-html | web-hero-image
mode: personal-brand | business-logo | business-campaign | marketing-day-to-day | editorial | infographic | web-mockup | quote-graphic
subject: <1-line description>
source_brief: <path to source brief if any>
brand_identity:
  logo_path: <path or "none">
  palette: [<hex>, <hex>, ...]
  typography: <font family or "none">
  style_adjectives: [<adj>, <adj>, ...]
format: poster | social-square | social-vertical | banner-hero | magazine | infographic | logo-variant | quote
aspect_ratio: 1:1 | 9:16 | 16:9 | 3:4 | 4:3 | custom
gen_mode: api-direct | api-dispatcher | fallback-prompt | hybrid
model: gpt-image-2 | dall-e-3 | midjourney-v6 | flux | imagen-3 | manual
output_files:
  - <path>
created: 2026-05-20
last_updated: 2026-05-20
---

Tên field TIẾNG ANH — không dịch sang tiếng Việt (phá AI parsing). Body file có thể tiếng Việt phổ thông.

Error handling — 8 tình huống thực tế

| Tình huống | Xử lý | |------------|-------| | Type ambiguous (không match keyword, không có flag) | Ask 1 câu duy nhất với 8 options (xem Layer 3 ở Step 0) | | Business mode + brand identity thiếu | BLOCK + ask user upload logo + specify palette (3 hex) + font family | | OPENAI_API_KEY invalid / quota exceeded khi gọi gpt-image-2 | Fallback xuống Tier Free (prompt-only) + print error line | | Type 7 web mockup nhưng user thực sự muốn full UI multi-section | Hybrid OK: gen hero image + kèm recommend web-prototype (hoặc 4 skill kia) cho full mockup | | Logo gen nhưng user chưa có brand values | Grill 3 câu: tên brand, ngành, values (3-5 từ) — mới gen được logo có hồn | | Infographic text-heavy >5 data points | Warn: "Text trong AI-gen image unreliable. Recommend dùng Canva template cho infographic có nhiều text." Vẫn gen nếu user confirm. | | Quote graphic text >50 ký tự | Warn: similar — recommend chỉ dùng background image + HTML overlay (đã là default cho type 8) | | User yêu cầu format không match type vừa detect | Suggest mode tương ứng — vd "landing page banner" → mode=marketing-day-to-day format=banner-hero |

Anti-patterns CẤM

• Gen logo as final output → luôn multi-variant 3-5 hướng + human review disclaimer
• Text in-image >50 ký tự — AI gen sẽ méo chữ, sai chính tả, dấu tiếng Việt vỡ
• Web mockup raster pretend là interactive — phải hybrid + recommend HTML skill
• Skip brand identity check cho business modes — output sẽ rời rạc với brand
• Output prompt chỉ có keyword (vd "logo cafe đẹp") — phải structured 5 phần: subject + composition + lighting + palette + style + negatives
• Hardcode hex màu khi project đã có brand identity file — phải đọc từ source
• Translate field name trong frontmatter sang tiếng Việt — phá AI parsing
• Gen >1 image per turn trừ trường hợp logo multi-variant
• Save prompt mà không gen image khi đang ở Tier Pro/Enterprise — lãng phí API
• Gen image mà không save metadata .md — mất context cho lần sau

Self-test trước khi gen

Trước mỗi lần gọi gpt-image-2 hoặc xuất prompt, tự hỏi:

> "Output này có align với brand voice + identity không? Khách hàng nhìn vào có nhận ra brand không? Nếu là personal brand — có phản ánh đúng style adjectives mà user khai không?"

Nếu không chắc 2/3 câu trên → quay lại Step 3, re-read brand identity hoặc grill thêm 1-2 câu.

Examples reference

• examples/personal-founder-avatar.md — Avatar founder OPA (style: confident, warm, minimal)
• examples/bhop-fall-campaign-poster.md — Key visual chiến dịch BHOP cafe mùa thu (palette nâu + cam)
• examples/ai-monetization-quote-graphic.md — Quote graphic IG cho course "AI Kiếm Tiền" (background + HTML overlay)
• examples/opa-roadmap-infographic.md — Infographic roadmap sản phẩm OPA (icons-heavy, text minimal)

Cheat sheet — load file nào khi nào

| Khi cần | Load file | |---------|-----------| | Hiểu format frontmatter, output location, prompt rule chung | CONVENTIONS.md | | Ảnh reference, master prompt, đổi mặt/màu/logo, prompt diagnosis | references/prompt-director.md | | Compose prompt cho 1 trong 8 types | references/<type>.md (vd references/business-logo.md) | | Business mode — tìm brand identity source | references/brand-identity-source.md | | Tier Free — format prompt cho 5 platforms | references/fallback-prompt-format.md | | Template format cụ thể (poster, banner, story...) | templates/<format>.md | | Example output thực tế | examples/<example-name>.md |

Plain Vietnamese policy

Skill này dùng tiếng Việt phổ thông xuyên suốt — client có thể đọc, hiểu, fill cùng AI. Technical terms (gpt-image-2, DALL-E 3, MidJourney, CTR, CPM) giữ nguyên + giải thích lần đầu. Examples dùng OPA brands realistic (BHOP cafe, Lumière agency, AI Kiếm Tiền course).

Chuyển sang skill design chuyên biệt (41-50)

Skill này tạo ra ảnh/prompt. Khi việc cần làm là quy trình sản xuất visual theo campaign (lập danh sách asset, viết brief giao designer, duyệt thiết kế, resize hàng loạt), chuyển sang các skill dưới đây:

| Việc cần làm | Skill | |--------------|-------| | Liệt kê toàn bộ asset campaign cần thiết kế + deadline + owner | 41-campaign-asset-list | | Viết brief ảnh static / banner / thumbnail giao designer | 42-brief-hinh-anh | | Viết brief carousel (logic chuỗi slide) | 43-brief-carousel | | Viết brief cho editor dựng video | 44-brief-video-editor | | Direction cho designer làm trên Canva | 45-brief-canva | | Xây brand guideline (palette, typography, logo, component) | 46-brand-guideline | | Duyệt thiết kế, chấm điểm, feedback | 47-design-review | | Brief gấp khi campaign đang chạy (creative fatigue) | 48-quick-visual-brief | | Code email HTML responsive | 49-html-email-template | | Resize asset winner sang đa kích thước | 50-asset-resize |

Timeline chuẩn của designer theo campaign: T-14 lập asset list → T-7 concept MVP 30 phút để duyệt hướng → T-5 asset phức tạp (landing page, email) → T-3 asset trung bình (carousel, banner set) → T-1 asset nhanh (static, story) → launch day standby quick asset → D+1 đánh dấu winner/loser rồi resize winner.

Agent phụ trách cả pipeline này: agents/design-producer.md.