@leejungkiin/awkit 1.7.4 → 1.7.5

package/skills/qwen-conductor/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: qwen-conductor
+description: >-
+  Cost-Efficient Execution Flow — Antigravity invokes Qwen CLI
+  for boilerplate code generation, routine logic coding, and local code edits.
+  Runs on local resources or cost-optimized API providers, saving premium API tokens.
+metadata:
+  stage: core
+  version: "1.0"
+  requires: qwen (/Users/trungkientn/.nvm/versions/node/v22.22.0/bin/qwen)
+  tags: [conductor, qwen, cli, boilerplate, local, cost-optimized, execution]
+agent: Executor
+trigger: conditional
+invocation-type: auto
+priority: 4
+---
+
+# 🤖 Qwen Conductor Skill
+
+> **Purpose:** Tự động gọi Qwen Coder CLI qua script wrapper `scripts/qwen-exec.js` khi cần sinh mã nguồn boilerplate, hàm hỗ trợ, hoặc các logic phổ thông.
+> **Key Benefit:** Tận dụng mô hình nguồn mở tối ưu cho code (Qwen 2.5 Coder 32B/72B) chạy local/API giá rẻ ➔ Tiết kiệm ~85% chi phí so với gọi Claude cho toàn bộ task.
+
+---
+
+## 🎯 Trigger Conditions
+
+Kích hoạt khi AWKit ở chế độ `cost-optimized` (mặc định) và nhận diện các tác vụ:
+
+```yaml
+auto_trigger:
+  high_confidence:
+    - Boilerplate code generation (new files, routine structures)
+    - Simple function/utility implementation (<50 lines of code)
+    - Code formatting, lint errors fixing
+    - Local unit tests suite generation
+    - Script helpers writing
+  
+  medium_confidence (confirm before running):
+    - Refactoring local modules
+    - Translation or migration of small packages
+```
+
+---
+
+## 🔧 CLI Wrapper Invocation
+
+Hàm execution của AWKit sẽ ủy quyền cho Qwen thông qua wrapper:
+
+```bash
+node scripts/qwen-exec.js \
+  --prompt "<PROMPT>" \
+  --sandbox read-only \
+  --output "<OUTPUT_FILE>"
+```
+
+### Safety & Sandboxing Rules
+
+```yaml
+safety:
+  - Luôn chạy Qwen dưới quyền sandbox `read-only` trừ khi có chỉ thị ghi file cụ thể.
+  - Phục hồi an toàn (Fallback): Nếu Qwen CLI thoát với mã lỗi khác 0, tự động chuyển sang gọi Gemini CLI (agy) để hoàn thành task viết mã.
+  - Sử dụng file input tạm để xử lý các prompt chứa chuỗi và nháy kép phức tạp, tránh lỗi parse shell command.
+```
+
+---
+
+## 🔄 Integration Flow
+
+```
+1. AWKit nhận diện Gate 4 (Execution - Viết code) ở chế độ Cost-Optimized.
+2. Gom specs từ docs/specs/ và implementation_plan.md làm context.
+3. Chạy lệnh: run_command("node scripts/qwen-exec.js --prompt '...' --output '...'")
+4. Qwen CLI xử lý và ghi code trực tiếp ra file đích.
+5. Nếu Qwen lỗi ➔ tự động fallback sang agy (Gemini Flash) viết code.
+6. Kết thúc ➔ afplay báo chuông hoàn thành cho User.
+```
+
+## ⚙️ Configuration & Control Techniques
+
+### 1. Check Runner Status
+Verify if the Qwen runner is enabled globally:
+```bash
+awkit config qwen
+```
+
+### 2. Enable/Disable Runner
+To temporarily disable Qwen runner (forcing fallback to Gemini standard models) or enable it:
+```bash
+awkit config qwen off
+awkit config qwen on
+```
+
+### 3. Check All Runners
+```bash
+awkit config runners
+```
+
+### 4. Active Routing & Fallback
+If `qwen` is disabled or unavailable on the system, the pipeline automatically routes code generation tasks (Gate 4 execution) to **Gemini Flash** via `agy` CLI using `gemini-3.5-flash`.
+

package/workflows/multi-agent-pipeline.md

@@ -0,0 +1,52 @@
+# 🎼 Multi-Agent CLI Pipeline Workflow
+
+> **Command Shortcut:** `/multi-agent`  
+> **Central Script:** `scripts/multi-model-pipeline.js`  
+> **Orchestration:** Claude (Architect) ➔ Qwen (Executor) ➔ Codex (Inspector)  
+
+---
+
+## 📖 Overview
+
+Quy trình này tự động hóa việc phát triển tính năng bằng cách phân phối các bước thiết kế, code, và review cho các CLI chuyên dụng. Điều này tối ưu hóa chi phí API và cải thiện chất lượng sản phẩm cuối cùng.
+
+---
+
+## 🛠️ Step-by-Step Execution
+
+### Bước 1: Khởi chạy Lập kế hoạch (Plan Phase)
+Gọi Claude CLI để lập PRD và spec kiến trúc chi tiết:
+```bash
+awkit pipeline plan "FeatureName"
+```
+*Sản phẩm đầu ra:* `docs/PRD.md` và `docs/specs/feature_name_spec.md`.
+
+### Bước 2: Thiết kế giao diện & Mockup (UI Phase)
+Gọi Codex CLI để tạo demo và spritesheet/gui assets:
+```bash
+awkit pipeline ui "FeatureName"
+```
+*Sản phẩm đầu ra:* `assets/ui/demo_preview.html` và GUI assets.
+
+### Bước 3: Viết mã nguồn (Code Phase)
+Gọi Qwen Coder CLI (hoặc fallback Gemini) để thực thi viết mã và tự động chạy code review:
+```bash
+awkit pipeline code "FeatureName"
+```
+*Sản phẩm đầu ra:* Source code hoàn thiện và báo cáo review chi tiết.
+
+---
+
+## 🔔 Sound Notifications
+
+Sau khi mỗi Phase (Plan, UI, Code) hoàn tất, hệ thống sẽ tự động phát âm thanh thông báo hệ thống và giọng nói (trên macOS) để báo hiệu cho người dùng biết khi nào task background kết thúc:
+- `afplay /System/Library/Sounds/Glass.aiff`
+- `say "[Phase] đã hoàn thành"`
+
+---
+
+## 🚫 Fallback Policy
+
+- Nếu Claude CLI bị lỗi ➔ Tự động chuyển sang sử dụng `agy --model claude-opus` (Gemini CLI).
+- Nếu Qwen CLI bị lỗi ➔ Tự động chuyển sang sử dụng `agy --model gemini-2.5-flash` (Gemini CLI).
+- Quy trình không bị dừng hoặc crash giữa chừng, đảm bảo sự liên tục.