@leejungkiin/awkit 1.4.0 → 1.4.3

package/skills/ai-sprite-maker/scripts/process_sprites.py

@@ -0,0 +1,140 @@
+import sys
+import os
+import math
+
+try:
+    from PIL import Image
+except ImportError:
+    print("Error: Module 'Pillow' is not installed. Vui lòng chạy: pip install Pillow")
+    sys.exit(1)
+
+def is_green_screen(r, g, b, tolerance=100):
+    """
+    Thuật toán nhận biết màu nền xanh (green screen / chroma key).
+    Bản gốc màu lý tưởng: #00FF00 (0, 255, 0).
+    """
+    dist = math.sqrt((r - 0)**2 + (g - 255)**2 + (b - 0)**2)
+    if dist < tolerance:
+        return True
+    if g > r + 40 and g > b + 40 and g > 130:
+        return True
+    return False
+
+def align_grid(img, cols, rows):
+    width, height = img.size
+    orig_cell_w = width // cols
+    orig_cell_h = height // rows
+    
+    frames = []
+    for r in range(rows):
+        for c in range(cols):
+            box = (c * orig_cell_w, r * orig_cell_h, c * orig_cell_w + orig_cell_w, r * orig_cell_h + orig_cell_h)
+            frames.append(img.crop(box))
+            
+    contents = []
+    valid_w = []
+    valid_h = []
+    
+    for frame in frames:
+        bbox = frame.getbbox()
+        if bbox:
+            content = frame.crop(bbox)
+            w = bbox[2] - bbox[0]
+            h = bbox[3] - bbox[1]
+            valid_w.append(w)
+            valid_h.append(h)
+            contents.append((content, w, h))
+        else:
+            contents.append(None)
+            
+    if not valid_w:
+        return img
+        
+    valid_w.sort()
+    valid_h.sort()
+    # Dùng median thay vì max để loại trừ khung bị lỗi do AI vẽ quá dài (outliers)
+    median_w = valid_w[len(valid_w) // 2]
+    median_h = valid_h[len(valid_h) // 2]
+            
+    padding = 20
+    cell_w = median_w + padding * 2
+    cell_h = median_h + padding * 2
+    
+    aligned_frames = []
+    for item in contents:
+        new_frame = Image.new("RGBA", (cell_w, cell_h), (0,0,0,0))
+        if item:
+            content, content_w, content_h = item
+            shift_x = (cell_w - content_w) // 2
+            shift_y = (cell_h - padding) - content_h
+            if shift_y < 0: shift_y = 0
+            new_frame.paste(content, (shift_x, shift_y))
+        aligned_frames.append(new_frame)
+        
+    out_img = Image.new("RGBA", (cell_w * cols, cell_h * rows), (0,0,0,0))
+    for i, frame in enumerate(aligned_frames):
+        row = i // cols
+        col = i % cols
+        out_img.paste(frame, (col * cell_w, row * cell_h))
+        
+    return out_img
+
+def remove_green_screen(input_path, output_path, align_cols=0, align_rows=0):
+    print(f"[*] Bắt đầu đọc tệp ảnh: {input_path}")
+    try:
+        img = Image.open(input_path).convert("RGBA")
+    except Exception as e:
+        print(f"[!] Không thể mở file ảnh gốc: {e}")
+        sys.exit(1)
+        
+    data = img.getdata()
+    new_data = []
+    
+    # Lặp qua các mảng Pixels và lọc màu Chroma-key
+    for r, g, b, a in data:
+        if a > 0 and is_green_screen(r, g, b, tolerance=110):
+            # Các viền pixel ám xanh sẽ được hạ alpha xuống trong suốt tuyệt đối (0)
+            new_data.append((255, 255, 255, 0))
+        else:
+            new_data.append((r, g, b, a))
+            
+    img.putdata(new_data)
+    
+    # Căn chỉnh lưới (Auto-Align) hoặc cắt gọn (Auto-Crop)
+    if align_cols > 0 and align_rows > 0:
+        print(f"[*] Đang căn chỉnh tự động các frame theo lưới {align_cols}x{align_rows} (đáy chạm đất, giữa tâm)...")
+        img = align_grid(img, align_cols, align_rows)
+    else:
+        bbox = img.getbbox()
+        if bbox:
+            img = img.crop(bbox)
+        
+    # Tạo cấu trúc thư mục nếu chưa tồn tại
+    os.makedirs(os.path.dirname(os.path.abspath(output_path)), exist_ok=True)
+    img.save(output_path, "PNG")
+    print(f"[*] Thành công! Đã xoá nền và lưu Sprite thành phẩm tại: {output_path}")
+
+if __name__ == "__main__":
+    if len(sys.argv) < 3:
+        print("Cú pháp: python process_sprites.py <file_raw.png> <file_output.png> [--align CxR]")
+        sys.exit(1)
+        
+    input_file = sys.argv[1]
+    output_file = sys.argv[2]
+    
+    align_c = 0
+    align_r = 0
+    
+    if len(sys.argv) >= 5 and sys.argv[3] == "--align":
+        try:
+            dims = sys.argv[4].lower().split('x')
+            align_c = int(dims[0])
+            align_r = int(dims[1])
+        except:
+            print("[!] Lỗi tham số --align. Ví dụ đúng: --align 3x2")
+    
+    if not os.path.exists(input_file):
+        print(f"[!] Lỗi: Không tìm thấy đường dẫn file ảnh gốc! ({input_file})")
+        sys.exit(1)
+        
+    remove_green_screen(input_file, output_file, align_c, align_r)

package/skills/code-review/SKILL.md

@@ -24,47 +24,35 @@ Review early, review often. Catch issues before they cascade.
 - Before refactoring (baseline check)
 - After fixing complex bug
 
-## The Review Process
+## The Review Process (Execution via Codex CLI)
 
-### Step 1: Prepare Context
+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.
 
-Gather what the reviewer needs:
+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
-# Get the diff scope
-git diff main..HEAD --stat
-git log main..HEAD --oneline
-
-# OR for specific task
-git diff HEAD~1..HEAD --stat
+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
 ```
 
-### Step 2: Construct Review Request
-
-Every review request needs:
-
-| Field | Description | Example |
-|-------|-------------|---------|
-| **WHAT** | What was implemented | "Water reminder notification system" |
-| **SPEC** | What it should do | "Send notification every 2h between 8am-10pm" |
-| **FILES** | Changed files | `WaterReminderManager.swift`, `NotificationService.swift` |
-| **SCOPE** | Review focus | "Logic correctness + thread safety" |
-
-### Step 3: Classify Findings
-
-| Severity | Action | Example |
-|----------|--------|---------|
-| 🔴 **Critical** | BLOCK — fix immediately | Thread-unsafe shared state, data loss risk |
-| 🟡 **Important** | Fix before proceeding | Missing error handling, incomplete validation |
-| 🟢 **Minor** | Note for later | Naming convention, code style preference |
-| ℹ️ **Suggestion** | Consider but optional | Performance optimization, alternative approach |
+### 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
+```
 
-### Step 4: Act on Feedback
+### 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
+```
 
-1. Fix 🔴 Critical issues IMMEDIATELY
-2. Fix 🟡 Important issues before proceeding to next task
-3. Log 🟢 Minor issues — fix in refactoring pass
-4. Evaluate ℹ️ Suggestions — adopt if clear improvement
+### 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)
 

package/skills/lucylab-tts/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: lucylab-tts
+description: |
+  Công cụ tạo Text-to-Speech (TTS) sử dụng API của LucyLab với nhiều giọng đọc khác nhau.
+  Hỗ trợ tạo giọng đọc từ kịch bản có sẵn, quản lý voice library và xuất file âm thanh chất lượng cao.
+metadata:
+  stage: workflow
+  version: "1.0"
+  requires: "python3, requests"
+  tags: [tts, lucylab, voice, audio, text-to-speech]
+trigger: explicit
+activation_keywords:
+  - "/lucylab"
+  - "/tts"
+  - "chuyển văn bản thành giọng nói"
+  - "tạo giọng đọc"
+  - "đọc script"
+  - "tạo tts"
+---
+
+# 🎙️ LucyLab TTS (Text-to-Speech Generator)
+
+> **Mục tiêu**: Tự động hóa quá trình tạo giọng đọc (Voiceover) từ văn bản hoặc kịch bản phân cảnh (Scenes) bằng API của LucyLab, hỗ trợ nhiều giọng đọc vùng miền và giới tính khác nhau. Được tách ra thành skill độc lập để dễ dàng gọi từ các workflow khác (ví dụ: short-maker).
+
+## 📡 Chế độ hoạt động (Triggers)
+
+- **Plain Text Mode**: Nhập một đoạn văn bản (text), Tool sẽ dùng một giọng mặc định để đọc toàn bộ.
+- **Script Scenes Mode**: Nhập kịch bản phân cảnh (SCENE 1, SCENE 2,...). Tool sẽ tự động phân tách từng câu thoại của mỗi cảnh và gọi LucyLab API để tạo các file lẻ. Rất phù hợp với quá trình tạo video tự động (Short Maker).
+
+## 🧱 Quy trình hoạt động (Mandatory Flow)
+
+0. **Giai đoạn Setup (Authentication)**: AI CẦN PHẢI KIỂM TRA QUYỀN TRUY CẬP TRƯỚC TIÊN:
+   - Quét file `.env` (tại thư mục làm việc hiện tại hoặc `~/.gemini/antigravity/.env`) tìm `LUCYLAB_BEARER`. Nếu KHÔNG TỒN TẠI, AI phải yêu cầu người dùng cung cấp API Key của LucyLab để lưu vào `.env`. Tuyệt đối không được chạy script trực tiếp để tránh lỗi do thiếu Authorization.
+1. **Chuẩn bị Kịch bản**: Kịch bản cần được đưa vào file text (ví dụ: `script.txt`) chứa thoại, hoặc truyền trực tiếp chữ thông qua `--text`.
+2. **Chọn Giọng đọc**: Dựa trên danh sách giọng trong `~/.gemini/antigravity/skills/lucylab-tts/resources/voices_library.json` hoặc truyền trực tiếp `--voice <id>`. Có các template phân nhóm: Nam/Nữ, miền Bắc/Nam.
+3. **Thực thi Tạo Audio**: 
+   - Tool kích hoạt script Python nằm trong: `~/.gemini/antigravity/skills/lucylab-tts/scripts/lucylab_tts.py`.
+   - Tool tự động lấy `LUCYLAB_BEARER` từ `.env` (hỗ trợ .env cục bộ hoặc ~/.gemini/antigravity/.env).
+4. **Hậu kiểm Output**: 
+   - Files MP3/WAV sẽ được lưu vào thư mục định sẵn (mặc định `outputs/tts-lucylab/<voice-slug>/`) với các file như `scene-01.mp3`, `scene-02.mp3`...
+   - Sẵn sàng dùng kết hợp với FFmpeg để ráp vào video.
+
+## 💻 Cấu trúc lệnh (CLI Reference)
+
+Để gọi engine TTS, bạn có thể thực thi lệnh thông qua bash:
+
+```bash
+# Đọc một đoạn text đơn giản (không chia cảnh)
+python ~/.gemini/antigravity/skills/lucylab-tts/scripts/lucylab_tts.py \
+    --text "Chào mừng bạn đến với hệ thống." \
+    --voice "12345:Giọng chuẩn" \
+    --mode plain \
+    --out-dir "outputs/sample"
+
+# Đọc từ kịch bản chia cảnh, chọn nhiều giọng từ thư viện
+python ~/.gemini/antigravity/skills/lucylab-tts/scripts/lucylab_tts.py \
+    --text-file "script.txt" \
+    --mode auto \
+    --voice-json "/Users/trungkientn/.gemini/antigravity/skills/lucylab-tts/resources/voices_library.json" \
+    --voices "Nam miền Bắc" \
+    --out-dir "outputs/tts"
+```
+
+> ⚠️ **Lưu ý**: Chắc chắn rằng biến môi trường `LUCYLAB_BEARER` đã được cấu hình trong dự án hiện tại (`.env`) hoặc `~/.gemini/antigravity/skills/lucylab-tts/scripts/.env` để được phép Authentication.