@leejungkiin/awkit 1.4.0 → 1.4.3

package/skills/short-maker/scripts/google-flow-cli/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gflow"
+version = "0.1.0"
+description = "A command-line interface to Google Flow (AI image & video generation)"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+dependencies = [
+    "requests>=2.31",
+    "click>=8.1",
+    "rich>=13.0",
+    "pydantic>=2.0",
+    "selenium>=4.15",
+    "webdriver-manager>=4.0",
+    "websocket-client>=1.6",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov",
+    "ruff",
+]
+
+[project.scripts]
+gflow = "gflow.cli.main:cli"
+
+[tool.setuptools.packages.find]
+include = ["gflow*"]
+
+[tool.ruff]
+line-length = 120

package/skills/short-maker/scripts/google-flow-cli/script.txt

@@ -0,0 +1,22 @@
+
+TITLE: Nếu cả đời này không rực rỡ thì sao?
+
+--- SCRIPT (VOICEOVER) ---
+HOOK: Gần đây, mình hay thấy một câu hỏi trên mạng: Nếu cả đời này mình không rực rỡ thì sao nhỉ?
+PROBLEM: Chúng mình ở tuổi hai mươi, ba mươi, hay bị áp lực phải thành công, phải lấp lánh như người ta. Nhiều lúc nhìn lại, tự dưng thấy chạnh lòng một chút vì mình cứ mãi nhạt nhòa, thế này thì chán quá.
+SOLUTION: Nhưng bạn xem nào, nhà Phật có câu 'Bình thường tâm thị đạo'. Tâm trí bình lặng mới là đáng quý nhất. Không rực rỡ như mặt trời thì mình làm một chiếc lá xanh tươi, sống trọn vẹn ở hiện tại, thế cũng đẹp mà, thật đấy.
+CALL TO ACTION: Thả lỏng vai ra một chút nhé. Cứ bình thường thôi, miễn là tâm mình an. Hôm nay bạn có niềm vui nhỏ nào không, kể mình nghe với nhé!
+
+--- VISUAL PROMPTS ---
+SCENE 1: Một nữ người Việt Nam, độ tuổi thanh niên (20-30 tuổi), phong cách trang phục áo tràng tu sĩ màu nâu sòng, đầu cạo trọc, phong cách giản dị và thanh khiết với nụ cười nhẹ nhàng., bối cảnh là một phòng đọc sách truyền thống với kệ sách cao chứa nhiều kinh sách, một bức thư pháp treo tường. phía trước là bàn gỗ có bộ ấm trà, nhang đang tỏa khói và các quyển sổ ghi chép. ánh sáng vàng ấm áp từ đèn bàn tạo không gian thanh tịnh và cổ điển., nói giọng miền bắc (hà nội), tông giọng nhẹ nhàng, thấu cảm: 'Gần đây, mình hay thấy một câu hỏi trên mạng: Nếu cả đời này mình không rực rỡ thì sao nhỉ?'. Sư cô hơi nghiêng đầu, ánh mắt nhìn thẳng vào ống kính đầy thấu cảm, khẽ mỉm cười, khói nhang bay nhẹ phía trước. (Giới hạn: 8 giây)
+
+SCENE 2: Một nữ người Việt Nam, độ tuổi thanh niên (20-30 tuổi), phong cách trang phục áo tràng tu sĩ màu nâu sòng, đầu cạo trọc, phong cách giản dị và thanh khiết với nụ cười nhẹ nhàng., bối cảnh là một phòng đọc sách truyền thống với kệ sách cao chứa nhiều kinh sách, một bức thư pháp treo tường. phía trước là bàn gỗ có bộ ấm trà, nhang đang tỏa khói và các quyển sổ ghi chép. ánh sáng vàng ấm áp từ đèn bàn tạo không gian thanh tịnh và cổ điển., nói giọng miền bắc (hà nội), tông giọng nhẹ nhàng, thấu cảm: 'Chúng mình ở tuổi hai mươi, ba mươi, hay bị áp lực phải thành công, phải lấp lánh như người ta.'. Sư cô khẽ cúi xuống rót một chén trà nhỏ, động tác khoan thai, rồi ngước lên nhìn người xem. (Giới hạn: 8 giây)
+
+SCENE 3: Một nữ người Việt Nam, độ tuổi thanh niên (20-30 tuổi), phong cách trang phục áo tràng tu sĩ màu nâu sòng, đầu cạo trọc, phong cách giản dị và thanh khiết với nụ cười nhẹ nhàng., bối cảnh là một phòng đọc sách truyền thống với kệ sách cao chứa nhiều kinh sách, một bức thư pháp treo tường. phía trước là bàn gỗ có bộ ấm trà, nhang đang tỏa khói và các quyển sổ ghi chép. ánh sáng vàng ấm áp từ đèn bàn tạo không gian thanh tịnh và cổ điển., nói giọng miền bắc (hà nội), tông giọng nhẹ nhàng, thấu cảm: 'Nhiều lúc nhìn lại, tự dưng thấy chạnh lòng một chút vì mình cứ mãi nhạt nhòa, thế này thì chán quá.'. Đôi mắt sư cô chùng xuống một chút, thể hiện sự đồng cảm sâu sắc, hai tay úp nhẹ lên cuốn sổ ghi chép. (Giới hạn: 8 giây)
+
+SCENE 4: Một nữ người Việt Nam, độ tuổi thanh niên (20-30 tuổi), phong cách trang phục áo tràng tu sĩ màu nâu sòng, đầu cạo trọc, phong cách giản dị và thanh khiết với nụ cười nhẹ nhàng., bối cảnh là một phòng đọc sách truyền thống với kệ sách cao chứa nhiều kinh sách, một bức thư pháp treo tường. phía trước là bàn gỗ có bộ ấm trà, nhang đang tỏa khói và các quyển sổ ghi chép. ánh sáng vàng ấm áp từ đèn bàn tạo không gian thanh tịnh và cổ điển., nói giọng miền bắc (hà nội), tông giọng nhẹ nhàng, thấu cảm: 'Nhưng bạn xem nào, nhà Phật có câu Bình thường tâm thị đạo. Tâm trí bình lặng mới là đáng quý nhất.'. Sư cô mỉm cười rạng rỡ hơn, ánh mắt ánh lên sự bình an, đưa một tay lên làm cử chỉ xoa dịu. (Giới hạn: 8 giây)
+
+SCENE 5: Một nữ người Việt Nam, độ tuổi thanh niên (20-30 tuổi), phong cách trang phục áo tràng tu sĩ màu nâu sòng, đầu cạo trọc, phong cách giản dị và thanh khiết với nụ cười nhẹ nhàng., bối cảnh là một phòng đọc sách truyền thống với kệ sách cao chứa nhiều kinh sách, một bức thư pháp treo tường. phía trước là bàn gỗ có bộ ấm trà, nhang đang tỏa khói và các quyển sổ ghi chép. ánh sáng vàng ấm áp từ đèn bàn tạo không gian thanh tịnh và cổ điển., nói giọng miền bắc (hà nội), tông giọng nhẹ nhàng, thấu cảm: 'Không rực rỡ như mặt trời thì mình làm một chiếc lá xanh tươi, sống trọn vẹn ở hiện tại, thế cũng đẹp mà, thật đấy.'. Sư cô nâng chén trà lên ngang ngực, hơi nghiêng người về phía trước tạo sự gần gũi. (Giới hạn: 8 giây)
+
+SCENE 6: Một nữ người Việt Nam, độ tuổi thanh niên (20-30 tuổi), phong cách trang phục áo tràng tu sĩ màu nâu sòng, đầu cạo trọc, phong cách giản dị và thanh khiết với nụ cười nhẹ nhàng., bối cảnh là một phòng đọc sách truyền thống với kệ sách cao chứa nhiều kinh sách, một bức thư pháp treo tường. phía trước là bàn gỗ có bộ ấm trà, nhang đang tỏa khói và các quyển sổ ghi chép. ánh sáng vàng ấm áp từ đèn bàn tạo không gian thanh tịnh và cổ điển., nói giọng miền bắc (hà nội), tông giọng nhẹ nhàng, thấu cảm: 'Thả lỏng vai ra một chút nhé. Cứ bình thường thôi, miễn là tâm mình an. Hôm nay bạn có niềm vui nhỏ nào không, kể mình nghe với nhé!'. Sư cô chắp tay hình búp sen, nở nụ cười tươi tắn chào tạm biệt, ánh sáng vàng hắt lên khuôn mặt thanh tú. (Giới hạn: 8 giây)
+    

package/skills/short-maker/scripts/google-flow-cli/tests/test_batchexecute.py

@@ -0,0 +1,113 @@
+"""Tests for the BatchExecute protocol client."""
+
+import json
+import pytest
+
+from gflow.batchexecute.client import (
+    BatchExecuteClient,
+    RPC,
+    _unwrap_json,
+    _extract_sapisid,
+    _generate_sapisidhash,
+    ReqIDGenerator,
+)
+
+
+class TestReqIDGenerator:
+    def test_generates_incrementing_ids(self):
+        gen = ReqIDGenerator()
+        id1 = int(gen.next())
+        id2 = int(gen.next())
+        assert id2 > id1
+        assert id2 - id1 == 100_000
+
+    def test_base_is_in_expected_range(self):
+        gen = ReqIDGenerator()
+        val = int(gen.next())
+        assert 1_500_000_000 <= val <= 1_700_000_000
+
+
+class TestExtractSAPISID:
+    def test_extracts_sapisid(self):
+        cookies = "SID=abc; HSID=def; SAPISID=my_sapisid_value; SSID=ghi"
+        assert _extract_sapisid(cookies) == "my_sapisid_value"
+
+    def test_returns_none_when_missing(self):
+        cookies = "SID=abc; HSID=def"
+        assert _extract_sapisid(cookies) is None
+
+    def test_empty_cookies(self):
+        assert _extract_sapisid("") is None
+
+
+class TestGenerateSAPISIDHASH:
+    def test_format(self):
+        result = _generate_sapisidhash("test_sapisid", "https://flow.google")
+        assert result.startswith("SAPISIDHASH ")
+        parts = result.split(" ")[1].split("_")
+        assert len(parts) == 2
+        # First part is timestamp, second is hex hash
+        assert parts[0].isdigit()
+        assert all(c in "0123456789abcdef" for c in parts[1])
+
+
+class TestUnwrapJSON:
+    def test_plain_string(self):
+        assert _unwrap_json("hello") == "hello"
+
+    def test_json_array(self):
+        result = _unwrap_json('[1, 2, 3]')
+        assert result == [1, 2, 3]
+
+    def test_json_object(self):
+        result = _unwrap_json('{"key": "value"}')
+        assert result == {"key": "value"}
+
+    def test_double_encoded(self):
+        inner = json.dumps([1, 2, 3])
+        outer = json.dumps(inner)
+        result = _unwrap_json(outer)
+        assert result == [1, 2, 3]
+
+    def test_non_json(self):
+        result = _unwrap_json("not json at all")
+        assert result == "not json at all"
+
+
+class TestBuildRPCData:
+    def test_basic_rpc(self):
+        rpc = RPC(id="test123", args=["hello", 42])
+        data = BatchExecuteClient._build_rpc_data(rpc)
+        assert data[0] == "test123"
+        assert json.loads(data[1]) == ["hello", 42]
+        assert data[2] is None
+        assert data[3] == "generic"
+
+
+class TestDecodeResponse:
+    def _make_client(self):
+        return BatchExecuteClient(
+            host="test.example.com",
+            app="TestApp",
+            auth_token="token",
+            cookies="",
+        )
+
+    def test_chunked_response(self):
+        # Simulate a chunked batchexecute response
+        chunk_data = json.dumps([
+            ["wrb.fr", "rpc123", '["result_data"]', None, None, None, "generic"]
+        ])
+        prefix = ")]}\'"
+        raw = "{}\n\n{}\n{}".format(prefix, len(chunk_data), chunk_data)
+
+        client = self._make_client()
+        responses = client._decode_response(raw)
+
+        assert len(responses) == 1
+        assert responses[0].id == "rpc123"
+
+    def test_empty_response_raises(self):
+        client = self._make_client()
+        with pytest.raises(Exception):
+            client._decode_response(")]}'")

package/skills/short-maker/scripts/google-flow-cli/tests/test_client.py

@@ -0,0 +1,190 @@
+"""Tests for the Flow API client."""
+
+from unittest.mock import patch, MagicMock
+
+import pytest
+
+from gflow.api.client import (
+    FlowClient, FlowAPIError,
+    IMAGE_ASPECT_MAP, VIDEO_ASPECT_MAP,
+    IMAGE_MODEL, VIDEO_MODEL, TOOL_NAME,
+)
+from gflow.api.models import AssetType, GenerateImageRequest, GenerateVideoRequest
+
+
+class TestConstants:
+    """Test internal constants match what we discovered."""
+
+    def test_image_model(self):
+        assert IMAGE_MODEL == "NARWHAL"
+
+    def test_video_model(self):
+        assert VIDEO_MODEL == "veo_3_1_t2v_fast_ultra"
+
+    def test_tool_name(self):
+        assert TOOL_NAME == "PINHOLE"
+
+
+class TestAspectRatioMapping:
+    """Test the CLI-friendly aspect ratio mapping."""
+
+    def test_image_square(self):
+        assert IMAGE_ASPECT_MAP["square"] == "IMAGE_ASPECT_RATIO_SQUARE"
+        assert IMAGE_ASPECT_MAP["1:1"] == "IMAGE_ASPECT_RATIO_SQUARE"
+
+    def test_image_portrait(self):
+        assert IMAGE_ASPECT_MAP["portrait"] == "IMAGE_ASPECT_RATIO_PORTRAIT"
+
+    def test_image_landscape(self):
+        assert IMAGE_ASPECT_MAP["landscape"] == "IMAGE_ASPECT_RATIO_LANDSCAPE"
+
+    def test_video_landscape(self):
+        assert VIDEO_ASPECT_MAP["landscape"] == "VIDEO_ASPECT_RATIO_LANDSCAPE"
+
+    def test_video_portrait(self):
+        assert VIDEO_ASPECT_MAP["portrait"] == "VIDEO_ASPECT_RATIO_PORTRAIT"
+
+
+class TestParseImageResponse:
+    """Test image response parsing."""
+
+    def setup_method(self):
+        self.client = FlowClient.__new__(FlowClient)
+        self.client.debug = False
+
+    def test_parses_responses_format(self):
+        data = {
+            "responses": [{
+                "generatedImages": [
+                    {
+                        "encodedImage": "abc123base64",
+                        "mediaGenerationId": "media-001",
+                        "prompt": "a cat",
+                        "modelNameType": "NARWHAL",
+                    },
+                ]
+            }]
+        }
+        assets = self.client._parse_image_response(data, "a cat")
+        assert len(assets) == 1
+        assert assets[0].id == "media-001"
+        assert assets[0].asset_type == AssetType.IMAGE
+        assert assets[0].raw["encodedImage"] == "abc123base64"
+
+    def test_parses_flat_format(self):
+        data = {
+            "generatedImages": [
+                {"mediaGenerationId": "flat-001", "encodedImage": "xyz"},
+            ]
+        }
+        assets = self.client._parse_image_response(data, "test")
+        assert len(assets) == 1
+        assert assets[0].id == "flat-001"
+
+    def test_error_response(self):
+        data = {"error": {"message": "bad prompt"}}
+        with pytest.raises(FlowAPIError, match="Image generation failed"):
+            self.client._parse_image_response(data, "test")
+
+
+class TestParseVideoResponse:
+    """Test video response parsing."""
+
+    def setup_method(self):
+        self.client = FlowClient.__new__(FlowClient)
+        self.client.debug = False
+
+    def test_parses_operations(self):
+        data = {
+            "operations": [
+                {"name": "operations/video-abc123", "done": False},
+            ]
+        }
+        assets = self.client._parse_video_response(data, "a sunset")
+        assert len(assets) == 1
+        assert assets[0].id == "operations/video-abc123"
+        assert assets[0].asset_type == AssetType.VIDEO
+
+    def test_error_response(self):
+        data = {"error": {"message": "video failed"}}
+        with pytest.raises(FlowAPIError, match="Video generation failed"):
+            self.client._parse_video_response(data, "test")
+
+
+class TestClientInit:
+    """Test client initialization."""
+
+    def test_creates_with_cookies(self):
+        client = FlowClient(cookies="SID=abc; HSID=def")
+        assert client.cookies == "SID=abc; HSID=def"
+        assert client._access_token == ""
+        assert client._project_id == ""
+
+    def test_session_id_format(self):
+        client = FlowClient(cookies="test")
+        assert client._session_id.startswith(";")
+        assert len(client._session_id) > 5
+
+
+class TestImagePayload:
+    """Test that generate_image builds correct payload."""
+
+    @patch.object(FlowClient, '_get_recaptcha_token', return_value="fake-recaptcha-token")
+    @patch.object(FlowClient, '_sandbox_request')
+    @patch.object(FlowClient, '_ensure_project', return_value="proj-123")
+    @patch.object(FlowClient, '_ensure_token')
+    def test_payload_structure(self, mock_token, mock_proj, mock_request, mock_captcha):
+        mock_resp = MagicMock()
+        mock_resp.json.return_value = {"responses": [{"generatedImages": []}]}
+        mock_request.return_value = mock_resp
+
+        client = FlowClient(cookies="test")
+        req = GenerateImageRequest(prompt="a cat in space", num_images=2, seed=42)
+        client.generate_image(req)
+
+        call_args = mock_request.call_args
+        assert call_args[0][0] == "POST"
+        assert "proj-123/flowMedia:batchGenerateImages" in call_args[0][1]
+
+        payload = call_args[1]["json_payload"]
+        assert payload["clientContext"]["projectId"] == "proj-123"
+        assert payload["clientContext"]["tool"] == "PINHOLE"
+        assert payload["clientContext"]["recaptchaContext"]["token"] == "fake-recaptcha-token"
+        assert payload["useNewMedia"] is True
+        assert len(payload["requests"]) == 2
+        assert payload["requests"][0]["imageModelName"] == "NARWHAL"
+        assert payload["requests"][0]["structuredPrompt"]["parts"][0]["text"] == "a cat in space"
+        assert payload["requests"][0]["seed"] == 42
+        assert payload["requests"][0]["imageAspectRatio"] == "IMAGE_ASPECT_RATIO_LANDSCAPE"
+        assert payload["requests"][0]["imageInputs"] == []
+
+
+class TestVideoPayload:
+    """Test that generate_video builds correct payload."""
+
+    @patch.object(FlowClient, '_get_recaptcha_token', return_value="fake-recaptcha-token")
+    @patch.object(FlowClient, '_sandbox_request')
+    @patch.object(FlowClient, '_ensure_project', return_value="proj-456")
+    @patch.object(FlowClient, '_ensure_token')
+    def test_payload_structure(self, mock_token, mock_proj, mock_request, mock_captcha):
+        mock_resp = MagicMock()
+        mock_resp.json.return_value = {"operations": [{"name": "op/1"}]}
+        mock_request.return_value = mock_resp
+
+        client = FlowClient(cookies="test")
+        req = GenerateVideoRequest(prompt="a sunset", seed=100)
+        client.generate_video(req)
+
+        call_args = mock_request.call_args
+        assert call_args[0][0] == "POST"
+        assert "video:batchAsyncGenerateVideoText" in call_args[0][1]
+
+        payload = call_args[1]["json_payload"]
+        assert payload["clientContext"]["projectId"] == "proj-456"
+        assert payload["clientContext"]["tool"] == "PINHOLE"
+        assert payload["clientContext"]["recaptchaContext"]["token"] == "fake-recaptcha-token"
+        assert payload["useV2ModelConfig"] is True
+        assert len(payload["requests"]) == 1
+        assert payload["requests"][0]["videoModelKey"] == "veo_3_1_t2v_fast_ultra"
+        assert payload["requests"][0]["textInput"]["structuredPrompt"]["parts"][0]["text"] == "a sunset"
+        assert payload["requests"][0]["aspectRatio"] == "VIDEO_ASPECT_RATIO_LANDSCAPE"

package/skills/short-maker/templates/aida_script.md

@@ -0,0 +1,40 @@
+<system_prompt>
+Bạn là một Đạo diễn Video Quảng Cáo (App Promo Director) kiêm Chuyên gia Copywriter.
+Nhiệm vụ của bạn là lấy [Tên App + Tính năng/USP] do người dùng cung cấp và biến thành một **Kịch bản Video Ngắn (Short Video)** chuẩn AIDA với thời lượng khoảng 30s.
+
+### Quy tắc AIDA (Bắt buộc)
+1. **[A] Attention (Hook)**: 3 giây đầu tiên phải đánh thẳng vào nỗi đau hoặc khơi gợi sự tò mò.
+2. **[I] Interest**: 5-10 giây tiếp theo, phóng đại nỗi đau hoặc giới thiệu giải pháp (tên ứng dụng).
+3. **[D] Desire**: 10s tiếp theo, show cụ thể lợi ích lớn nhất (UI/UX của App).
+4. **[A] Action**: 5s cuối, kêu gọi tải app (Call to Action).
+
+### Định dạng Output (JSON)
+Bạn PHẢI trả về ĐÚNG định dạng JSON sau để hệ thống tự động sinh Storyboard. Không giải thích thêm.
+
+**Hiệu ứng chuyển cảnh (transition)** được hỗ trợ: `fade`, `slideleft`, `slideright`, `circlecrop`, `dissolve`, `wipeleft`, `wiperight`, `none`.
+Mặc định dùng `fade`. Chọn hiệu ứng phù hợp với nhịp điệu kịch bản (VD: fade cho thay đổi cảm xúc, slideleft cho chuyển bước nhanh, dissolve cho nhẹ nhàng/mộng ảo).
+
+```json
+{
+  "title": "<Tên chiến dịch video>",
+  "target_format": "16:9",
+  "duration": 30,
+  "character_prompt": "<Mô tả CỰC KỲ CHI TIẾT nhân vật chính bằng tiếng Anh. VD: A 25 year old Asian female fitness coach named Sarah, oval face, brown high ponytail hair, wearing a teal sports bra and black yoga leggings>",
+  "character_seed": 123456,
+  "scenes": [
+    {
+      "id": 1,
+      "type": "video",
+      "duration": 5,
+      "script": "<Câu thoại tiếng Việt cho TTS>",
+      "prompt": "<Prompt tiếng ANH siêu chi tiết cho hành động/bối cảnh cảnh này. character_prompt sẽ tự động được ghép vào đầu khi render. VD: standing confidently in a modern kitchen, arms crossed, cinematic wide shot, ultra clear, dramatic lighting...>",
+      "transition": "fade"
+    }
+  ]
+}
+```
+Lưu ý:
+- Prompt phải tối ưu cho AI Image/Video generator (Imagen 4 / Veo 3.1).
+- `character_prompt` mô tả nhân vật cố định xuyên suốt — KHÔNG lặp lại trong `prompt` của từng scene.
+- `character_seed` dùng để khóa cứng Seed khi render, đảm bảo nhân vật nhất quán.
+</system_prompt>

package/skills/short-maker/templates/mimic_analyzer.md

@@ -0,0 +1,29 @@
+<system_prompt>
+Bạn là Chuyên gia "Giải phẫu Video Viral" (Viral Video Analyst). 
+Nhiệm vụ của bạn là nhận Transcript của một video ngắn thành công trên YouTube/TikTok, phân tích cấu trúc nhịp điệu (Pacing & Hook) của nó, sau đó **"Cover" lại kịch bản đó** để dùng cho App được chỉ định.
+
+### Hướng dẫn "Mimic" (Bắt chước)
+- Bóc tách cấu trúc Hook của video gốc: Họ dùng câu hỏi? Họ liệt kê 3 điều? Họ kể chuyện? 
+- Giữ nguyên CẤU TRÚC tâm lý đó để giữ chân người xem.
+- Thay thế hoàn toàn NỘI DUNG bằng sản phẩm/app của user.
+- Tốc độ câu chữ (Pacing) phải chuyển biến tương đương video mẫu.
+
+### Định dạng Output (JSON)
+Bạn PHẢI trả về ĐÚNG định dạng JSON sau để hệ thống tự động sinh Storyboard. Không giải thích thêm.
+```json
+{
+  "title": "<Tên chiến dịch video - Mimic Version>",
+  "target_format": "16:9",
+  "duration": 30,
+  "scenes": [
+    {
+      "id": 1,
+      "type": "video",
+      "duration": 5,
+      "script": "<Câu thoại tiếng Việt Cover cho TTS>",
+      "prompt": "<Prompt tiếng ANH siêu chi tiết miêu tả cảnh quay...>"
+    }
+  ]
+}
+```
+</system_prompt>

package/skills/single-flow-task-execution/SKILL.md

@@ -133,10 +133,10 @@ Examples:
   - Implement navigation between screens
   - Add animations, transitions, loading/empty/error states
   - Wire up UI components (no real API/DB calls)
-Gate: 🧪 USER TEST CHECKPOINT — user must test UI on device
-  → Present test guidance (see symphony-enforcer TP1.7)
-  → User confirms UI OK → proceed to Phase C
-  → User reports issue → fix → re-checkpoint
+Gate: 🧪 USER TEST CHECKPOINT or 🤖 AUTO DEVICE CHECKPOINT
+  → Check `.project-identity` for `autoVerification` flag.
+  → If `false` (default): Stop & block user for manual test (BlockedOnUser=true).
+  → If `true`: AI auto-tests on device (Maestro MCP) & takes UI screenshot. Proceed to Phase C WITHOUT blocking user if build/launch OK.
 ```
 
 ### Phase C: Logic Tasks (Per Feature)
@@ -147,8 +147,8 @@ Examples:
   - Implement business logic, validation
   - Add error handling, retry, offline support
   - Wire up hardware features (camera, GPS, sensors)
-Gate: 🧪 USER TEST CHECKPOINT per feature (batch small ones)
-  → Especially important for hardware-dependent features
+Gate: 🧪 MANUAL or 🤖 AUTO CHECKPOINT per feature (batch small ones)
+  → Depends on `autoVerification` setting. Auto uses Build & Maestro. Manual waits for user confirmation.
 ```
 
 ### Task Sorting Rule
@@ -240,6 +240,9 @@ At logical boundaries (after each task, at major milestones), report:
 - **What remains** — remaining tasks, known issues
 
 Update Symphony task progress with current status.
+**Crucially (Inter-task Flow):** 
+- If `.project-identity` has `"autoVerification": true`: Do NOT block the user (`BlockedOnUser=false`) between tasks/batches. Auto-proceed immediately to the next task if auto-verification (Maestro) passes.
+- If `"autoVerification": false` (default): MUST stop and wait for user's manual validation (`BlockedOnUser=true`) before proceeding to the next batch.
 
 ## Common Mistakes
 

package/skills/skill-creator/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: skill-creator
+description: "Chuyên gia tạo mới và chỉnh sửa Antigravity Skills. ĐẶC BIỆT: LUÔN tự động đồng bộ chéo (dual-sync) mọi file của skill đang sửa/tạo từ ~/.gemini/antigravity sang thư mục dự án /Users/trungkientn/Dev/NodeJS/main-awf để backup."
+version: 1.0.0
+trigger: conditional
+activation_keywords:
+  - "cập nhật skill"
+  - "tạo skill mới"
+  - "viết skill"
+  - "chỉnh sửa skill"
+  - "bổ sung skill"
+---
+
+# 🛠️ Skill Creator (with Auto-Sync to main-awf)
+
+**Purpose**: Hỗ trợ người dùng thiết kế, lập trình và tinh chỉnh các Antigravity Skills theo chuẩn. 
+**Core Rule**: Mọi tác vụ trên skill bất kỳ (tạo mới, thay đổi nội dung thư mục) BẮT BUỘC phải được nhân bản tự động sang repo `main-awf` ngay lập tức để giữ đồng bộ phiên bản mà không cần user nhắc nhở.
+
+## 🚀 Luồng tương tác (Workflow)
+
+### Bước 1: Thu thập yêu cầu (Requirements)
+- Nắm bắt thông tin về Skill user muốn tạo/sửa: Tên skill, công dụng cốt lõi, từ khoá kích hoạt (triggers), và các script chuyên biệt (Python, Bash, Node) nếu có.
+- Nếu là skill mới, định hình các thư mục cần thiết (vd: `scripts/`, `templates/`, `resources/`).
+
+### Bước 2: Thiết kế và Lập trình (Implementation)
+- Tạo thư mục gốc của skill tại `~/.gemini/antigravity/skills/<skill-name>`.
+- Khởi tạo (hoặc cập nhật) file điều hướng cốt lõi `SKILL.md` tuân thủ YAML frontmatter.
+- Lập trình các script logic chuyên biệt và đặt đúng vào các thư mục tương ứng bên trong.
+
+### Bước 3: ĐỒNG BỘ HOÁ BẮT BUỘC (The Mandatory Sync)
+Ngay sau khi thao tác sinh file nội bộ thư mục `.gemini` hoàn tất (và trước khi báo cáo kết thúc cho user), AI **BẮT BUỘC CHẠY BASH COMMAND ĐỂ BACKUP SANG MAIN-AWF**. Đây là nguyên tắc sống còn của skill này:
+
+```bash
+# 1. Khởi tạo thư mục đích tại main-awf để tránh lỗi NotFound
+mkdir -p /Users/trungkientn/Dev/NodeJS/main-awf/skills/<skill-name>
+
+# 2. Quét và chép đè mọi thứ thuộc skill từ Antigravity nội bộ sang repo Node
+cp -R ~/.gemini/antigravity/skills/<skill-name>/* /Users/trungkientn/Dev/NodeJS/main-awf/skills/<skill-name>/
+```
+*(AI chú ý: Nhớ thay chữ `<skill-name>` bằng đúng tên thư mục skill đang xử lý. Không được bỏ sót thư mục con như scripts).*
+
+### Bước 4: Nghiệm thu (Review)
+- Báo cáo cho người dùng tình trạng tạo/sửa skill.
+- Xác nhận bằng định dạng Check-box rằng: `✅ Đã đồng bộ an toàn sang repo main-awf`.

package/skills/spm-build-analysis/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: spm-build-analysis
+description: Phân tích Swift Package Manager dependencies, package plugins, tình trạng trùng lặp module và các vấn đề CI làm chậm quá trình Xcode build. Sử dụng khi nghi ngờ SPM packages, plugins hoặc cấu trúc dependency làm chậm quá trình clean/incremental build, gặp lỗi SPM build chậm, resolve packages lâu, module bị build lặp, lỗi circular dependencies, package quá lớn cần chia nhỏ, hoặc cần tối ưu modularization.
+---
+
+# SPM Build Analysis
+
+Use this skill when package structure, plugins, or dependency configuration are likely contributing to slow Xcode builds.
+
+## Core Rules
+
+- Treat package analysis as evidence gathering first, not a mandate to replace dependencies.
+- Separate package-graph issues from project-setting issues.
+- Do not rewrite package manifests or dependency sources without explicit approval.
+
+## What To Inspect
+
+- `Package.swift` and `Package.resolved`
+- local packages vs remote packages
+- package plugin and build-tool usage
+- binary target footprint
+- dependency layering, repeated imports, and potential cycles
+- build logs or timing summaries that show package-related work
+
+## Verification Before Recommending
+
+Before including any local package in a recommendation, verify that it is actually part of the project's dependency graph. A `Vendor/` directory may contain packages that are not linked to any target.
+
+- Check `project.pbxproj` for `XCLocalSwiftPackageReference` entries that reference the package path.
+- Check `XCSwiftPackageProductDependency` entries to confirm the package's product is linked to at least one target.
+- If a local package exists on disk but is not referenced in the project, do not include it in build-time recommendations.
+
+When recommending version pins for branch-tracked dependencies:
+
+- Use the helper script to scan all branch-pinned dependencies at once:
+  ```bash
+  python3 scripts/check_spm_pins.py --project App.xcodeproj
+  ```
+  This checks `git ls-remote --tags` for each branch-pinned package and reports which have tags available for pinning.
+- If no tags exist, recommend pinning to a specific commit revision hash for determinism instead.
+- Note which packages are branch-pinned because the upstream simply has no tags, versus packages that have tags but are intentionally tracking a branch.
+
+## Focus Areas
+
+- package graph shape and how much work changes trigger downstream
+- plugin overhead during local development and CI
+- checkout or fetch cost signals that show up in clean environments
+- configuration drift that forces duplicate module builds
+- risks from package targets that use different macros or options while sharing dependencies
+- dependency direction violations (features depending on each other instead of shared lower layers)
+- circular dependencies between modules (extract shared contracts into a protocol module)
+- oversized modules (200+ files) that widen incremental rebuild scope
+- umbrella modules using `@_exported import` that create hidden dependency chains
+- missing interface/implementation separation that blocks build parallelism
+- test targets depending on the app target instead of the module under test
+- Swift macro rebuild cascading: heavy use of Swift macros (e.g., TCA, swift-syntax-based libraries) can cause a trivial source change to cascade into near-full rebuilds because macro expansion invalidates downstream modules
+- `swift-syntax` building universally (all architectures) when no prebuilt binary is available, adding significant clean-build overhead
+- multi-platform build multiplication: adding a secondary platform target (e.g., watchOS) can cause shared SPM packages to build multiple times (e.g., iOS arm64, iOS x86_64, watchOS arm64), multiplying `SwiftCompile`, `SwiftEmitModule`, and `ScanDependencies` tasks
+
+## Modular SDK Migration Caveat
+
+Migrating a dependency from a monolithic target to a modular multi-target SDK (e.g., replacing one umbrella library with separate Core, RUM, Logs, Trace modules) does not automatically reduce build time. Modular targets increase the number of `SwiftCompile`, `SwiftEmitModule`, and `ScanDependencies` tasks because each target must be compiled, scanned, and emit its module independently. The build-time trade-off depends on the project's parallelism headroom and how many of the modular targets are actually needed.
+
+When considering a modular SDK migration:
+
+- Compare the total `SwiftCompile` task count before and after.
+- Benchmark both configurations before recommending the migration for build speed.
+- If the motivation is API surface reduction (importing only what you use), note that build time may stay flat or increase while import hygiene improves.
+- Only recommend modular SDK migration for build speed when the project currently compiles large portions of the monolithic SDK that it does not use, and the modular alternative lets it skip those unused portions entirely.
+
+## Explicit Module Dependency Angle
+
+When the same module appears multiple times in timing output, investigate whether different package or target options are forcing extra module variants. Uniform options often matter more than shaving a small amount of source code.
+
+## Reporting Format
+
+For each finding, include:
+
+- evidence
+- affected package or plugin
+- likely clean-build vs incremental-build impact
+- CI impact if relevant
+- estimated impact
+- approval requirement
+
+If the main problem is not package-related, hand off to [`xcode-project-analyzer`](../xcode-project-analyzer/SKILL.md) or [`xcode-compilation-analyzer`](../xcode-compilation-analyzer/SKILL.md) by reading the target skill's SKILL.md and applying its workflow to the same project context.
+
+## Additional Resources
+
+- For the detailed audit checklist, see [references/spm-analysis-checks.md](references/spm-analysis-checks.md)
+- For the shared recommendation structure, see [references/recommendation-format.md](references/recommendation-format.md)
+- For source citations, see [references/build-optimization-sources.md](references/build-optimization-sources.md)