@leejungkiin/awkit 1.6.6 → 1.7.0

package/workflows/ui/image-gen.md

@@ -0,0 +1,118 @@
+---
+description: 🎨 Image Generator — Tạo App Icons, Mascots và Pets (Hatch-style) với chất lượng Studio (Soft-Edge & Hole-Aware)
+---
+
+# /image-gen — High-Quality Asset Production Workflow
+
+> Quy trình tạo Asset chuyên nghiệp, tự động tách nền và xử lý cạnh mượt mà (PicWish Style).
+> Hỗ trợ tạo Pet Bundle (Trứng + Thú cưng) tương tự Codex nhưng chất lượng cao hơn.
+
+// turbo-all
+
+---
+
+## Sub-commands
+
+### `/image-gen:icon` — Tạo bộ App Icon
+
+1. Hỏi user về chủ đề (Theme), phong cách (Style - mặc định: `vector`), và **Kích thước lưới** (Grid - mặc định: `3x3`).
+2. Tự động tính toán số lượng `{count}` dựa trên lưới (vd: 3x3 -> 9 icons).
+3. Thông báo user: "🎨 Đang phác thảo bộ Icon Set {grid} cho chủ đề: {theme}..."
+4. Thực thi lệnh tạo:
+```bash
+create-icon {theme} {grid} {style}
+```
+5. Sau khi ảnh được tạo, thông báo: "✅ Đã tạo xong và xử lý Soft-Edge. File lưu tại: `assets/generated/`."
+
+### `/image-gen:mascot` — Tạo bộ Linh vật / Mascot
+
+1. Hỏi user về nhân vật (Character), phong cách (Style - mặc định: `chibi`), và **Kích thước lưới** (Grid - mặc định: `3x3`).
+2. Tự động tính toán số lượng `{count}` dựa trên lưới.
+3. Thông báo user: "🧸 Đang thiết kế bộ Mascot {grid} cho: {character}..."
+4. Thực thi lệnh tạo:
+```bash
+create-mascot {character} {grid} {style}
+```
+5. Sau khi ảnh được tạo, thông báo: "✅ Mascot đã sẵn sàng với nền trong suốt hoàn hảo!"
+
+### `/image-gen:pet` — Tạo Pet Bundle (Ấp trứng)
+
+1. Hỏi user về loại Pet (ví dụ: `fire dragon`, `ice phoenix`) và **Kích thước lưới** (Grid - mặc định: `4x4` cho đầy đủ trạng thái).
+2. Thông báo user: "🐣 Đang tạo Pet Bundle ({grid}) cho: {pet_type}..."
+3. Thực thi lệnh tạo:
+```bash
+create-pet {pet_type} {grid}
+```
+4. Tạo thư mục cấu hình: `mkdir -p assets/pets/{pet_id}`
+5. Ghi file `pet.json` mẫu tương thích hệ thống Hatch Pet.
+6. Thông báo: "✨ Pet Bundle đã được đóng gói tại `assets/pets/{pet_id}/`."
+
+### `/image-gen:process` — Xử lý ảnh có sẵn (Hole-Aware)
+
+1. User cung cấp đường dẫn ảnh nguồn (`input_path`).
+2. Xác định tên file đầu ra (`output_name.webp`).
+3. Thực thi lệnh xử lý với thuật toán v3.1:
+```bash
+process-image {input_path} assets/generated/{output_name}.webp 15
+```
+
+### `/image-gen:openrouter` — Tạo ảnh qua OpenRouter (GPT-5.4-Image)
+
+Quy trình sử dụng script `openrouter_image_gen.py` (Codex-grade) hỗ trợ 3 chế độ:
+
+#### 1. Chế độ `generate` (Text-to-Image)
+Dùng để tạo mới asset từ mô tả văn bản, hỗ trợ các tham số Art Direction cực mạnh:
+```bash
+python3 ~/.gemini/antigravity/scripts/openrouter_image_gen.py generate \
+  --prompt "{chủ_thể}" \
+  --style "{phong_cách}" \
+  --lighting "{ánh_sáng}" \
+  --palette "{tông_màu}" \
+  --out "assets/generated/{filename}.webp"
+```
+
+#### 2. Chế độ `edit` (Image-to-Image / Style Transfer)
+Dùng để biến đổi ảnh có sẵn (Local path hoặc URL) sang phong cách khác hoặc chỉnh sửa chi tiết:
+```bash
+python3 ~/.gemini/antigravity/scripts/openrouter_image_gen.py edit \
+  --image "{đường_dẫn_ảnh_gốc}" \
+  --prompt "{mô_tả_chỉnh_sửa}" \
+  --style "{phong_cách_mới}" \
+  --out "assets/generated/{filename}.webp"
+```
+
+#### 3. Chế độ `generate-batch` (Chạy hàng loạt)
+Dùng để sinh hàng loạt asset từ file `.jsonl` (tối đa 100 jobs) với cơ chế Retry tự động:
+```bash
+python3 ~/.gemini/antigravity/scripts/openrouter_image_gen.py generate-batch \
+  --input "jobs.jsonl" \
+  --out-dir "assets/generated/batch/" \
+  --concurrency 3
+```
+
+> **Note**: Script tự động xử lý Upload ảnh local lên `tmpfiles.org` và có cơ chế Exponential Backoff để chống lỗi nghẽn (429).
+
+---
+
+## 🛠 Quality Standards (Codex Hatch Pet Technique)
+
+- **🚫 CẤM DÙNG "Nền trong suốt / Transparent Background"**: TUYỆT ĐỐI KHÔNG thêm các từ khóa "transparent background", "nền trong suốt", "alpha channel" vào prompt sinh ảnh. Việc này sẽ khiến AI (như DALL-E, Midjourney, OpenRouter) sinh ra **nền caro giả (fake checkerboard)** bám dính vào nhân vật, cực kỳ khó xoá.
+- **✅ Background**: LUÔN ưu tiên sử dụng `solid bright green background #00FF00` hoặc `solid white background #FFFFFF` (nếu nhân vật có màu xanh) để AI render chi tiết tốt nhất, không bị đổ bóng (no shadows cast on the background).
+- **🛠 Hậu kỳ (Post-Processing)**: Sau khi sinh ảnh thô có nền Solid, BẮT BUỘC sử dụng công cụ Python Chroma-key cục bộ (process-image hoặc process_sprites.py) để gỡ nền.
+- **Edges & Holes**: Script Python sẽ tự động áp dụng Alpha Feathering (Blur 0x3) để triệt tiêu răng cưa, và xóa các vùng kẹt trong cánh/tay nhưng bảo vệ đôi mắt (Morphology Close).
+
+---
+
+## Communication
+
+Mỗi khi bắt đầu một lượt generate:
+```
+🎨 [Antigravity Artist] Đang khởi tạo xưởng vẽ cho {asset_type}...
+🚀 Chiến lược: Neutral White + Soft-Edge Alpha.
+```
+
+Sau khi hoàn tất:
+```
+✅ Hoàn tất! Asset của bạn đã được tối ưu hóa WebP và tách nền sạch sẽ.
+📍 Vị trí: [đường dẫn]
+```

package/skills/code-review/SKILL.md

@@ -1,115 +0,0 @@
----
-name: code-review
-description: Use when completing tasks, implementing features, or before merging. Dispatch structured code review with severity classification. Auto-triggers after task completion in subagent-driven or single-flow execution.
----
-
-<!-- ⚠️ REVIEW GATE — Spec compliance FIRST, then code quality. No merge without review. -->
-
-# Code Review
-
-## Overview
-
-Review early, review often. Catch issues before they cascade.
-
-**Core principle:** Structured review with actionable, severity-classified feedback.
-
-## When to Request Review
-
-**Mandatory:**
-- After completing each task in execution flow
-- After implementing major feature or fix
-- Before merge to main branch
-- Before deploy to production
-
-**Optional but valuable:**
-- When stuck (fresh perspective helps)
-- Before refactoring (baseline check)
-- After fixing complex bug
-
-## The Review Process (Execution via Codex CLI)
-
-Thay vì tự đọc diff và đánh giá, Antigravity **BẮT BUỘC** gọi `codex` CLI để thực hiện Code Review nhằm mở rộng Context Window và sử dụng subagent chuyên dụng.
-
-Có 3 chế độ review chính tùy theo bối cảnh:
-
-### 1. Review Toàn Bộ Codebase (Full Review)
-Sử dụng khi cần đánh giá tổng thể dự án, review architecture, security, hoặc chuẩn bị big release.
-```bash
-codex -p "Review toàn bộ codebase. Tập trung kiểm tra tính nhất quán kiến trúc (architecture), rủi ro bảo mật (security) và hiệu suất (performance)." --approval-mode auto
-```
-
-### 2. Review Những Thay Đổi (Changes / Diff Review)
-Sử dụng khi vừa hoàn thành xong code một tính năng hoặc fix bug (các thay đổi workspace, stashed, unstaged, hoặc dải diff ngắn).
-```bash
-codex -p "Review những thay đổi hiện tại (git diff/staged). Tập trung kiểm tra logic, edge cases và conventions." --approval-mode auto
-```
-
-### 3. Review Commit Cụ Thể (Specific Commit)
-Sử dụng khi cần review một nhánh git, PR, hoặc một commit hash cụ thể.
-```bash
-codex -p "Review commit <commit_hash> (hoặc range main..HEAD). Tập trung đánh giá xem code có giải quyết đúng vấn đề và compliance với Spec không." --approval-mode auto
-```
-
-### Cách Xử Lý Output Từ Codex
-1. Fix 🔴 **Critical** issues NGAY LẬP TỨC.
-2. Fix 🟡 **Important** issues trước khi kết thúc task hoặc chuyển sang Phase mới.
-3. Log 🟢 **Minor** issues để cấu trúc lại sau.
-4. Proceed nếu Subagent Codex báo "LGTM" hoặc không có issue nào nghiêm trọng.
-
-## Two-Stage Review (Subagent-Driven)
-
-For automated execution, run TWO separate review passes:
-
-### Stage 1: Spec Compliance Review
-```
-- Does the code implement ALL requirements from the spec/plan?
-- Is anything MISSING from the spec?
-- Is anything EXTRA that wasn't specified (scope creep)?
-- Does behavior match expected output for each requirement?
-```
-
-### Stage 2: Code Quality Review
-```
-- Is the code clean, readable, and well-structured?
-- Are there any thread safety issues?
-- Is error handling comprehensive?
-- Are there performance concerns?
-- Does it follow project coding conventions?
-- Are there any security vulnerabilities?
-```
-
-**Order matters:** Spec compliance FIRST, then code quality. No point reviewing quality of wrong code.
-
-## Self-Review Checklist (Before Requesting External Review)
-
-Before asking for review, verify yourself:
-
-- [ ] All requirements from plan/spec addressed
-- [ ] No TODO/FIXME/HACK left unresolved  
-- [ ] Error handling for all failure paths
-- [ ] No hardcoded values that should be configurable
-- [ ] Thread safety for shared state
-- [ ] Localization for user-facing strings
-- [ ] No print/debugPrint left in production code
-- [ ] File sizes < 500 lines
-
-## Integration
-
-**Used by:**
-- `single-flow-task-execution` — Review after each task
-- `symphony-enforcer` — Review before `symphony_complete_task`
-
-**Related skills:**
-- `verification-gate` — Run tests BEFORE requesting review
-- `systematic-debugging` — If review reveals bugs
-
-## Anti-Rationalization Table
-
-| Excuse | Reality |
-|--------|---------|
-| "It's a small change" | Small changes cause big bugs |
-| "Tests pass so it's correct" | Tests ≠ requirements. Review catches logic gaps |
-| "I'm confident in this code" | Confidence ≠ correctness |
-| "No time for review" | 5 min review saves 2 hours debugging |
-| "I'll review it later" | Later never comes. Review now |
-| "Only I understand this code" | That's exactly why someone else should review |