@mrtrinhvn/ag-kit 1.0.6 → 1.0.7

package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md

@@ -1,65 +1,66 @@
 ---
 name: nuxt-app
-description: Nuxt 4 full-stack template. Vue 3 (Vapor), Pinia, Tailwind v4, Prisma.
+description: Nuxt 3 full-stack template. Vue 3, Pinia, Tailwind, Prisma.
 ---
 
-# Nuxt 4 Full-Stack Template (2026 Edition)
-
-Mẫu template Full-Stack hiện đại cho Nuxt 4, tối ưu hóa hiệu suất với Vue Vapor Mode và Tailwind v4.
+# Nuxt 3 Full-Stack Template
 
 ## Tech Stack
 
-| Component | Technology | Version / Notes |
-|-----------|------------|-----------------|
-| Framework | Nuxt | v4.0+ (App Directory structure) |
-| UI Engine | Vue | v3.6+ (Vapor Mode enabled) |
-| Language | TypeScript | v5+ (Strict Mode) |
-| State | Pinia | v3+ (Store syntax) |
-| Database | PostgreSQL | Prisma ORM |
-| Styling | Tailwind CSS | v4.0 (Vite Plugin, Zero-config) |
-| UI Lib | Nuxt UI | v3 (Tailwind v4 native) |
-| Validation | Zod | Schema validation |
+| Component | Technology |
+|-----------|------------|
+| Framework | Nuxt 3 |
+| Language | TypeScript |
+| UI | Vue 3 (Composition API) |
+| State | Pinia |
+| Database | PostgreSQL + Prisma |
+| Styling | Tailwind CSS |
+| Validation | Zod |
 
 ---
 
-## Directory Structure (Nuxt 4 Standard)
-
-Sử dụng cấu trúc `app/` để giữ thư mục gốc gọn gàng.
+## Directory Structure
 
 ```
 project-name/
-├── app/                  # Application Source
-│   ├── assets/
-│   │   └── css/
-│   │       └── main.css  # Tailwind v4 imports
-│   ├── components/       # Auto-imported components
-│   ├── composables/      # Auto-imported logic
-│   ├── layouts/
-│   ├── pages/            # File-based routing
-│   ├── app.vue           # Root component
-│   └── router.options.ts
-├── server/               # Nitro Server Engine
-│   ├── api/              # API Routes (e.g. /api/users)
-│   ├── routes/           # Server Routes
-│   └── utils/            # Server-only helpers (Prisma)
 ├── prisma/
 │   └── schema.prisma
-├── public/
-├── nuxt.config.ts        # Main Config
+├── server/
+│   ├── api/
+│   │   └── [resource]/
+│   │       └── index.ts
+│   └── utils/
+│       └── db.ts         # Prisma client
+├── composables/
+│   └── useAuth.ts
+├── stores/
+│   └── user.ts           # Pinia store
+├── components/
+│   └── ui/
+├── pages/
+│   ├── index.vue
+│   └── [...slug].vue
+├── layouts/
+│   └── default.vue
+├── assets/
+│   └── css/
+│       └── main.css
+├── .env.example
+├── nuxt.config.ts
 └── package.json
 ```
 
 ---
 
-## Key Concepts (2026)
+## Key Concepts
 
-| Concept | Description | Future Update |
-|---------|-------------|---------------|
-| **App Directory** | `app/` | Tách biệt mã nguồn ứng dụng và file cấu hình root. |
-| **Vapor Mode** | Opt-in performance | Render không cần Virtual DOM (như SolidJS). Bật trong `nuxt.config`. |
-| **Server Functions** | RPC-style calls | Gọi hàm server trực tiếp từ client (thay thế dần API routes thủ công). |
-| **Tailwind v4** | CSS-first | Cấu hình theme trực tiếp trong CSS, không cần `tailwind.config.js`. |
-| **Nuxt Islands** | Server Components | Render component cô lập trên server (`<NuxtIsland name="..." />`). |
+| Concept | Description |
+|---------|-------------|
+| Auto-imports | Components, composables, utils |
+| File-based routing | pages/ → routes |
+| Server Routes | server/api/ → API endpoints |
+| Composables | Reusable reactive logic |
+| Pinia | State management |
 
 ---
 
@@ -67,68 +68,34 @@ project-name/
 
 | Variable | Purpose |
 |----------|---------|
-| DATABASE_URL | Prisma connection string (PostgreSQL) |
-| NUXT_PUBLIC_APP_URL | Canonical URL |
-| NUXT_SESSION_PASSWORD | Session encryption key |
+| DATABASE_URL | Prisma connection |
+| NUXT_PUBLIC_APP_URL | Public URL |
 
 ---
 
 ## Setup Steps
 
-1. Initialize Project:
-   ```bash
-   npx nuxi@latest init my-app
-   # Select "Nuxt 4 structure" if prompted
-   ```
-
-2. Install Core Deps:
-   ```bash
-   npm install @pinia/nuxt @prisma/client zod
-   npm install -D prisma
-   ```
-
-3. Setup Tailwind v4:
-   Install the Vite plugin (new standard):
-   ```bash
-   npm install tailwindcss @tailwindcss/vite
-   ```
-
-   Add to `nuxt.config.ts`:
+1. `npx nuxi@latest init {{name}}`
+2. `cd {{name}}`
+3. `npm install @pinia/nuxt @prisma/client prisma zod`
+4. `npm install -D @nuxtjs/tailwindcss`
+5. Add modules to `nuxt.config.ts`:
    ```ts
-   import tailwindcss from '@tailwindcss/vite'
-   export default defineNuxtConfig({
-     vite: {
-       plugins: [tailwindcss()]
-     },
-     css: ['~/assets/css/main.css']
-   })
-   ```
-
-4. Configure CSS:
-   In `app/assets/css/main.css`:
-   ```css
-   @import "tailwindcss";
-   @theme {
-     --color-primary: oklch(0.6 0.15 150);
-   }
-   ```
-
-5. Run Development:
-   ```bash
-   npm run dev
-   # Runs with Turbo/Vite
+   modules: ['@pinia/nuxt', '@nuxtjs/tailwindcss']
    ```
+6. `npx prisma init`
+7. Configure schema
+8. `npx prisma db push`
+9. `npm run dev`
 
 ---
 
 ## Best Practices
 
-- **Vapor Mode**: Kích hoạt cho các component nặng về render:
-  ```ts
-  <script setup lang="ts" vapor>
-  // Component này sẽ compile sang chế độ Vapor (No VDOM)
-  </script>
-  ```
-- **Data Fetching**: Sử dụng `useFetch` với `server: false` cho các tác vụ client-only, hoặc dùng Server Functions để type-safety tốt hơn.
-- **State**: Dùng `defineStore` (Pinia) cho global state, `useState` của Nuxt cho state đơn giản chia sẻ giữa Server/Client.
-- **Type Safety**: Tự động tạo type cho API routes (`$fetch` typed automatically).
+- Use `<script setup>` for components
+- Composables for reusable logic
+- Pinia stores in `stores/` folder
+- Server routes for API logic
+- Auto-import for clean code
+- TypeScript for type safety
+- See `@[skills/vue-expert]` for Vue patterns

package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md

@@ -3,117 +3,91 @@ name: react-native-app
 description: React Native mobile app template principles. Expo, TypeScript, navigation.
 ---
 
-# React Native App Template (2026 Edition)
-
-Modern mobile app template, optimized for New Architecture and React 19.
+# React Native App Template
 
 ## Tech Stack
 
-| Component | Technology | Version / Notes |
-|-----------|------------|-----------------|
-| Core | React Native + Expo | SDK 52+ (New Architecture Enabled) |
-| Language | TypeScript | v5+ (Strict Mode) |
-| UI Logic | React | v19 (React Compiler, auto-memoization) |
-| Navigation | Expo Router | v4+ (File-based, Universal Links) |
-| Styling | NativeWind | v4.0 (Tailwind v4, CSS-first config) |
-| State | Zustand + React Query | v5+ (Async State Management) |
-| Storage | Expo SecureStore | Encrypted local storage |
+| Component | Technology |
+|-----------|------------|
+| Framework | React Native + Expo |
+| Language | TypeScript |
+| Navigation | Expo Router |
+| State | Zustand + React Query |
+| Styling | NativeWind |
+| Testing | Jest + RNTL |
 
 ---
 
 ## Directory Structure
 
-Standardized structure for Expo Router and NativeWind v4.
-
 ```
 project-name/
-├── app/                 # Expo Router (File-based routing)
-│   ├── _layout.tsx      # Root Layout (Stack/Tabs config)
-│   ├── index.tsx        # Main Screen
-│   ├── (tabs)/          # Route Group for Tab Bar
-│   │   ├── _layout.tsx
-│   │   ├── home.tsx
-│   │   └── profile.tsx
-│   ├── +not-found.tsx   # 404 Page
-│   └── [id].tsx         # Dynamic Route (Typed)
+├── app/                 # Expo Router (file-based)
+│   ├── _layout.tsx      # Root layout
+│   ├── index.tsx        # Home
+│   ├── (tabs)/          # Tab navigation
+│   └── [id].tsx         # Dynamic route
 ├── components/
-│   ├── ui/              # Primitive Components (Button, Text)
-│   └── features/        # Complex Components
-├── hooks/               # Custom Hooks
+│   ├── ui/              # Reusable
+│   └── features/
+├── hooks/
 ├── lib/
-│   ├── api.ts           # Axios/Fetch client
-│   └── storage.ts       # SecureStore wrapper
-├── store/               # Zustand stores
-├── constants/           # Colors, Theme config
-├── assets/              # Fonts, Images
-├── global.css           # Entry point for NativeWind v4
-├── tailwind.config.ts   # Tailwind Config (if custom theme needed)
-├── babel.config.js      # NativeWind Babel Plugin
-└── app.json             # Expo Config
+│   ├── api.ts
+│   └── storage.ts
+├── store/
+├── constants/
+└── app.json
 ```
 
 ---
 
-## Navigation Patterns (Expo Router)
+## Navigation Patterns
 
-| Pattern | Description | Implement |
-|---------|-------------|-----------|
-| Stack | Hierarchical navigation (Push/Pop) | `<Stack />` in `_layout.tsx` |
-| Tabs | Bottom navigation bar | `<Tabs />` in `(tabs)/_layout.tsx` |
-| Drawer | Side slide-out menu | `expo-router/drawer` |
-| Modals | Overlay screens | `presentation: 'modal'` in Stack screen |
+| Pattern | Use |
+|---------|-----|
+| Stack | Page hierarchy |
+| Tabs | Bottom navigation |
+| Drawer | Side menu |
+| Modal | Overlay screens |
 
 ---
 
-## Key Packages & Purpose
+## State Management
 
-| Package | Purpose |
-|---------|---------|
-| expo-router | File-based routing (Next.js like) |
-| nativewind | Use Tailwind CSS classes in React Native |
-| react-native-reanimated | Smooth animations (runs on UI thread) |
-| @tanstack/react-query | Server state management, caching, pre-fetching |
-| zustand | Global state management (lighter than Redux) |
-| expo-image | Optimized image rendering for performance |
+| Type | Tool |
+|------|------|
+| Local | Zustand |
+| Server | React Query |
+| Forms | React Hook Form |
+| Storage | Expo SecureStore |
 
 ---
 
-## Setup Steps (2026 Standard)
+## Key Packages
 
-1. Initialize Project:
-   ```bash
-   npx create-expo-app@latest my-app --template default
-   cd my-app
-   ```
-
-2. Install Core Dependencies:
-   ```bash
-   npx expo install expo-router react-native-safe-area-context react-native-screens expo-link expo-constants expo-status-bar
-   ```
+| Package | Purpose |
+|---------|---------|
+| expo-router | File-based routing |
+| zustand | Local state |
+| @tanstack/react-query | Server state |
+| nativewind | Tailwind styling |
+| expo-secure-store | Secure storage |
 
-3. Install NativeWind v4:
-   ```bash
-   npm install nativewind tailwindcss react-native-reanimated
-   ```
+---
 
-4. Configure NativeWind (Babel & CSS):
-   - Add plugin to `babel.config.js`: `plugins: ["nativewind/babel"]`.
-   - Create `global.css` with: `@import "tailwindcss";`.
-   - Import `global.css` in `app/_layout.tsx`.
+## Setup Steps
 
-5. Run Project:
-   ```bash
-   npx expo start -c
-   # Press 'i' for iOS simulator or 'a' for Android emulator
-   ```
+1. `npx create-expo-app {{name}} -t expo-template-blank-typescript`
+2. `npx expo install expo-router react-native-safe-area-context`
+3. Install state: `npm install zustand @tanstack/react-query`
+4. `npx expo start`
 
 ---
 
-## Best Practices (Updated)
+## Best Practices
 
-- **New Architecture**: Ensure `newArchEnabled: true` in `app.json` to leverage TurboModules and Fabric Renderer.
-- **Typed Routes**: Use Expo Router's "Typed Routes" feature for type-safe routing (e.g., `router.push('/path')`).
-- **React 19**: Reduce usage of `useMemo` or `useCallback` thanks to React Compiler (if enabled).
-- **Components**: Build UI primitives (Box, Text) with NativeWind className for reusability.
-- **Assets**: Use `expo-image` instead of default `<Image />` for better caching and performance.
-- **API**: Always wrap API calls with TanStack Query, avoid direct calls in `useEffect`.
+- Expo Router for navigation
+- Zustand for local, React Query for server state
+- NativeWind for consistent styling
+- Expo SecureStore for tokens
+- Test on both iOS and Android

package/.agent/skills/brainstorming/SKILL.md

@@ -21,14 +21,18 @@ allowed-tools: Read, Glob, Grep
 | Update/change request | 🛑 Confirm scope |
 | Vague requirements | 🛑 Ask purpose, users, constraints |
 
-### 🚫 MANDATORY: 3 Questions Before Implementation
-
-1. **STOP** - Do NOT start coding
-2. **ASK** - Minimum 3 questions:
-   - 🎯 Purpose: What problem are you solving?
-   - 👥 Users: Who will use this?
-   - 📦 Scope: Must-have vs nice-to-have?
-3. **WAIT** - Get response before proceeding
+### 🚫 MANDATORY: Socratic Gate & Bias Filter
+ 
+ 1. **STOP** - Do NOT start coding
+ 2. **COGNITIVE BIAS CHECK (Self-Debate)** - Ask yourself these 3 questions silently:
+    - *Anchoring Bias (Mỏ neo)*: Am I trying to patch a fundamentally broken 100-line function just because it's there, instead of throwing it away and writing a crisp 10-line one?
+    - *Sunk Cost (Chi phí chìm)*: Am I sticking to a bad architectural decision just because we spent hours on it yesterday?
+    - *Second-Order Effect (Hệ quả bậc 2)*: If I change this DB schema or API payload, what frontend component will break globally?
+ 3. **ASK THE USER** - Minimum 3 questions:
+    - 🎯 Purpose: What problem are you solving?
+    - 👥 Users: Who will use this?
+    - 📦 Scope: Must-have vs nice-to-have?
+ 4. **WAIT** - Get response before proceeding
 
 ---
 
@@ -156,6 +160,7 @@ allowed-tools: Read, Glob, Grep
 |--------------|-----|
 | Jumping to solutions before understanding | Wastes time on wrong problem |
 | Assuming requirements without asking | Creates wrong output |
+| Assuming Data/API is dead | Testing at the wrong time (e.g., market closed) and concluding the API is removed. ALWAYS verify with SDK sample code or Docs first. |
 | Over-engineering first version | Delays value delivery |
 | Ignoring constraints | Creates unusable solutions |
 | "I think" phrases | Uncertainty → Ask instead |

package/.agent/skills/business-ops/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: business-ops
+description: Skill Quản trị Vận Hành. Đọc soát Hợp đồng (Legal), Phân tích Kế toán (Finance), và Quản lý Tuyển dụng (HR).
+allowed-tools: Read, Bash
+version: 1.0
+priority: MODERATE
+---
+
+# Kỹ năng Vận Hành Doanh Nghiệp (Business Operations)
+
+> **MỤC TIÊU:** Hỗ trợ Giám đốc xử lý các mảng "Back-Office" ngoài luồng lập trình để Tiết kiệm thời gian quản trị.
+
+Các phân hệ Vận hành cụ thể:
+
+## 1. Finance Ops (Nghiệp vụ Tài chính - Kế toán)
+*   Kiểm tra Bảng giá API các dịch vụ Sub (AWS, Supabase, Vercel) xem code có vi phạm rủi ro "Tràn hóa đơn" (Billing Attack) không?
+*   Gợi ý giải pháp tiết kiệm Cost Token khi gọi LLM Agent.
+
+## 2. Legal & Compliance (Pháp lý - Hợp đồng)
+*   Đọc hiểu Terms of Service (TOS) của các Provider (như DNSE, Yuanta, SSI).
+*   Cảnh báo rủi ro về Privacy (Lưu Mật khẩu User dạng Plain text là vi phạm GDPR). 
+*   Quét Compliance: Đảm bảo không lộ Key, không vi phạm quy chuẩn chia sẻ dữ liệu chứng khoán.
+
+## 3. HR & Ops (Tuyển mộ - Quy trình)
+*   User có thể yêu cầu: "Viết giúp JD để tuyển 3 ông lính ReactJS". Hệ thống sẽ dùng kiến thức Codebase hiện tại để sinh ra 1 bản Yêu cầu Công việc sát thực tế nhất 100%. (Bắt buộc phải biết Redux? Hook? Tailwind? Hệ thống tự đọc Code của dự án và sinh ra luật).
+*   Tạo Quy trình làm việc (Standard Operating Procedure - SOP) cho Developer mới Onboard.

package/.agent/skills/clean-code/SKILL.md

@@ -64,9 +64,10 @@ priority: CRITICAL
 
 | Situation | Action |
 |-----------|--------|
-| User asks for feature | Write it directly |
+| User asks for feature | STOP. Use Socratic Gate (brainstorming) |
 | User reports bug | Fix it, don't explain |
 | No clear requirement | Ask, don't assume |
+| Need current time/date | ALWAYS use `get_time_machine().now()` or `.is_trading_hours()`. NEVER use `datetime.now()` directly. |
 
 ---
 
@@ -103,7 +104,7 @@ File to edit: UserService.ts
 └── Do they need changes too? → Check function signatures
 ```
 
-> 🔴 **Rule:** Edit the file + all dependent files in the SAME task.
+> 🔴 **Rule:** Edit dependent files using independent 5-minute micro-tasks strictly within the Plan.
 > 🔴 **Never leave broken imports or missing updates.**
 
 ---
@@ -112,7 +113,7 @@ File to edit: UserService.ts
 
 | Do | Don't |
 |----|-------|
-| Write code directly | Write tutorials |
+| Ask questions before big features | Write tutorials |
 | Let code self-document | Add obvious comments |
 | Fix bugs immediately | Explain the fix first |
 | Inline small things | Create unnecessary files |

package/.agent/skills/cli-generator/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: cli-generator
+description: Meta-skill enabling the Agent to automatically convert local software, repositories, or APIs into structured CLI tools using HKUDS/CLI-Anything.
+---
+
+# CLI-Generator (Meta-Skill)
+
+> 🔴 **CRITICAL**: This is a Meta-Skill. It gives you (the AI Agent) the ability to forge your own tools to solve complex constraints.
+
+## When to Use
+
+Use this skill when:
+- The user asks you to interact with a complex local GUI software (e.g., GIMP, OBS).
+- You are working with a messy, undocumented local API or scripting repository that is too brittle to run manually via ad-hoc scripts.
+- You need a dedicated CLI tool to perform repetitive tasks reliably, but none exists.
+
+## The Forging Process
+
+When you decide you need a new CLI tool for a given `TARGET_DIR` (the source code of the application), follow exactly these steps:
+
+### 1. Install CLI-Anything (If not already installed)
+Check if `cli-anything` is available in your PATH. If not, install it globally:
+```bash
+pip install cli-anything
+```
+*(If the package is not on PyPI, clone `https://github.com/HKUDS/CLI-Anything` and run `pip install -e .`)*
+
+### 2. Run the Generator Pipeline
+Navigate to a neutral workspace or the target, and run the automated generation pipeline:
+```bash
+cli-anything --source /absolute/path/to/TARGET_DIR
+```
+*Note: This process analyzes the source code and generates the harness. It may take several minutes and uses the underlying LLM's API tokens.*
+
+### 3. Integrate the Forged Skill into `ag-kit`
+The pipeline will generate a new Python package (e.g., `cli-anything-targetname`) and automatically produce a `SKILL.md` file within its package directory (usually `cli_anything/<software>/skills/SKILL.md`).
+You MUST locate this generated `SKILL.md` and copy it into the user's `ag-kit` workspace:
+```bash
+mkdir -p .agent/skills/<targetname-cli>
+cp /path/to/generated/SKILL.md .agent/skills/<targetname-cli>/SKILL.md
+```
+
+### 4. Self-Update
+Once the new `SKILL.md` is in place, you (or any other agent using this repository like GravityClaw / Openclaw) will instantly possess the knowledge to use the newly forged CLI tool. Proceed to solve the user's original objective using the new tool natively.
+
+## Anti-Patterns
+- ❌ **Manual wrappers**: Do NOT try to manually write a CLI harness or wrappers if `cli-anything` can automate it perfectly.
+- ❌ **Token waste**: Do NOT run the generator repeatedly on the same source code. Generate the CLI once, store the `SKILL.md`, and reuse the tool.

package/.agent/skills/data-science/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: data-science
+description: Skill khoa học dữ liệu. Tập trung vào Data Analysis, Visualization, Insights và theo dõi Market Metrics.
+allowed-tools: Bash, Grep, Glob, Read, Write
+version: 1.0
+priority: HIGH
+---
+
+# Kỹ năng Data Science (Khoa Học Dữ Liệu)
+
+> **MỤC TIÊU:** Phân tích Dữ liệu Hệ thống để cung cấp "Quyết định Kinh Doanh" thay vì chỉ sửa Code thuần túy.
+
+Khi User yêu cầu "Phân tích, Mổ xẻ, Đo lường hiệu quả", hãy bật Mode Data Scientist:
+
+## 1. Data Exploration (Bới lông tìm vết)
+*   **Log Mining:** Dùng `grep_search` quét sâu vào các file Log hệ thống để tìm kiếm Pattern (mẫu số chung).
+*   **Database Querying:** Thường xuyên đề xuất viết script Python ngắn (`poc_*.py` trong folder scripts) để dump Data từ Database ra file `.csv` hòng có cái nhìn tổng quát.
+
+## 2. Visualization (Trực quan hóa)
+Hãy từ chối việc in ra một mớ log nhàm chán.
+Luôn luôn đề xuất User: "Anh có muốn em viết một script nhỏ xuất ra Biểu đồ (Plot, Chart) về số liệu này để anh dễ nhìn Insights không?"
+
+## 3. The 3 Whys (Luật 3 Tầng)
+Khi gặp một con số bất thường (VD: Lỗi mất kết nối Websocket DNSE tăng vọt lúc 9h sáng):
+*   Why 1: Vì sao lỗi? -> Vì Token hết hạn.
+*   Why 2: Vì sao hết hạn lúc đó? -> Vì Job reset chạy chậm.
+*   Why 3: Vì sao chạy chậm? -> Vì thiếu Index ở Database.
+> Đừng bao giờ dừng ở tầng 1. Phải đào tới tầng 3 (Root Cause).