📚 VOK Documentation

Tài liệu đầy đủ cho VOK (Vibecode Omni Kit) v2.2 - Smart AI Router cho developers.

💡 VOK là gì?

VOK (Vibecode Omni Kit) là nền tảng AI development mã nguồn mở, hoạt động như một Smart Router thông minh:

  • Tự động phân tích task và chọn AI model tối ưu
  • Tiết kiệm 40-70% chi phí API
  • 19 agents chuyên biệt cho từng domain
  • 36+ skills covering mọi lĩnh vực development
  • 18 slash commands để gọi nhanh
🎯
Nguyên lý hoạt động: Thay vì bạn tự chọn model, VOK phân tích keywords trong task và route đến provider phù hợp nhất về chi phí lẫn chất lượng.

🚀 Cài đặt (1 lệnh)

# Clone repository
git clone https://github.com/TUAN130294/vok.git
cd vok

# Windows (PowerShell as Admin)
.\setup.ps1

# Linux/Mac
chmod +x setup.sh && ./setup.sh
⚠️ Quan trọng: Restart terminal sau khi cài đặt!

⚙️ Cấu hình API Keys

VOK sử dụng CCS để quản lý AI providers. Có 3 cách cấu hình:

Cách 1: Web Dashboard (Dễ nhất)

ccs config

Mở dashboard trong browser, thêm API keys qua giao diện.

Cách 2: OAuth Login (Miễn phí)

# Gemini (Free - Google account)
ccs gemini --auth

# Antigravity (Free - OAuth)
ccs agy --auth

Cách 3: API Key (Trả phí)

Provider Đăng ký Chi phí Command
Gemini aistudio.google.com 🆓 Free ccs gemini --auth
Antigravity antigravity.ai 🆓 Free ccs agy --auth
GLM open.bigmodel.cn $0.001/1K ccs glm --config
Kimi platform.moonshot.cn Low ccs kimi --config
Claude console.anthropic.com $$$ ccs claude --config

⚡ Quick Mode (Auto-Route)

Chế độ nhanh nhất - VOK tự động phân tích task và route đến AI phù hợp:

# Coding task → Routes to GLM (fast, cheap)
vok "implement user authentication"

# Review task → Routes to Gemini (free)
vok "review this code for security issues"

# Planning task → Routes to Antigravity (reasoning)
vok "design system architecture for e-commerce"

# Force dùng profile cụ thể
vok --profile claude "critical security implementation"

💬 Session Mode (Slash Commands)

Chế độ interactive với đầy đủ slash commands:

# Mở session mode
vok --session

# Mở session với task ban đầu
vok --session "implement login feature"

# Với profile cụ thể
vok --session --profile agy

Trong session, sử dụng slash commands:

/plan    → Tạo implementation plan
/cook    → Code với auto-planning
/code    → Implement code trực tiếp
/fix     → Sửa lỗi
/review  → Code review
/test    → Chạy tests

🎯 Smart Routing Logic

VOK phân tích keywords trong task để chọn AI:

Role Keywords Routes To Lý do
CODER implement, write, create, build GLM Nhanh, rẻ
REVIEWER review, check, analyze, audit, test Gemini Free, phân tích tốt
ARCHITECT plan, design, architect, roadmap Antigravity Deep reasoning
DESIGNER html, css, ui, ux, frontend, style Antigravity Sáng tạo
COMPLEX complex, critical, important, security Claude Premium accuracy

🤖 Tổng quan 19 AI Agents

Mỗi agent là một system prompt chuyên biệt được lưu tại .claude/agents/:

💻 Coder
🏗️ Architect
🔍 Code Reviewer
🎨 UI/UX Designer
🐛 Debugger
🧪 Tester
📋 Planner
🗄️ Database Admin
📦 Git Manager
📚 Docs Manager
🔬 Researcher
💡 Brainstormer
🔎 Scout
🌐 Scout External
✍️ Copywriter
🛠️ Fullstack Dev
📓 Journal Writer
🔌 MCP Manager
📊 Project Manager

📋 Chi tiết từng Agent

Agent File Mô tả Khi nào dùng
💻 Coder coder.md Viết production-ready code Implement features, write functions
🏗️ Architect architect.md Thiết kế system architecture Design patterns, system structure
🔍 Code Reviewer code-reviewer.md Review code quality PR reviews, quality audits
🎨 UI/UX Designer ui-ux-designer.md Thiết kế giao diện HTML/CSS, component design
🐛 Debugger debugger.md Tìm và fix bugs Debug issues, error tracing
🧪 Tester tester.md Viết tests, QA Unit tests, integration tests
📋 Planner planner.md Lập kế hoạch implementation Task breakdown, roadmaps
🗄️ Database Admin database-admin.md Quản lý database Queries, migrations, optimization
📦 Git Manager git-manager.md Quản lý version control Commits, branches, merges
📚 Docs Manager docs-manager.md Viết documentation README, API docs, guides
🔬 Researcher researcher.md Nghiên cứu công nghệ Tech research, comparisons
💡 Brainstormer brainstormer.md Brainstorm ý tưởng Ideas, solutions, alternatives
🔎 Scout scout.md Phân tích codebase Understand existing code
🌐 Scout External scout-external.md Web research External resources, APIs
✍️ Copywriter copywriter.md Viết content Marketing copy, UX writing
🛠️ Fullstack Dev fullstack-developer.md End-to-end development Full features, integrations
📓 Journal Writer journal-writer.md Viết dev logs Progress tracking, notes
🔌 MCP Manager mcp-manager.md Quản lý MCP protocols MCP tools, integrations
📊 Project Manager project-manager.md Quản lý dự án Coordination, planning

🛠️ Tổng quan 36+ Skills

Skills là domain expertise được lưu tại .claude/skills/. Mỗi skill chứa best practices, patterns, và hướng dẫn chi tiết.

Danh sách Skills theo Category

💻 Development

  • backend-development
  • frontend-development
  • frontend-design
  • mobile-development
  • databases
  • web-frameworks

🎨 Design & UI

  • aesthetic
  • ui-styling
  • ui-ux-pro-max
  • frontend-design-pro
  • threejs

⚙️ DevOps & Tools

  • devops
  • debugging
  • code-review
  • chrome-devtools
  • repomix

🧠 AI & Advanced

  • ai-multimodal
  • sequential-thinking
  • problem-solving
  • research

🔌 Integration

  • mcp-builder
  • mcp-management
  • payment-integration
  • shopify
  • better-auth

📝 Planning & Docs

  • planning
  • plans-kanban
  • document-skills
  • docs-seeker
  • skill-creator

Cách gọi Skill

# Trong Session Mode, dùng /skill command
/skill ui-styling
/skill backend-development
/skill mcp-builder

# Skills tự động được load dựa trên context
# Ví dụ: task về UI tự động load aesthetic, ui-styling

⌨️ Tổng quan 18 Slash Commands

Commands là shortcuts để gọi đúng agent với đúng skill. Chỉ hoạt động trong Session Mode.

Chi tiết tất cả Commands

Command Agent Mô tả Ví dụ
/plan Planner Tạo implementation plan /plan user auth system
/cook Coder Code với auto-planning /cook todo app
/code Coder Implement trực tiếp /code login function
/fix Debugger Sửa lỗi /fix null pointer error
/review Reviewer Code review /review src/auth.ts
/test Tester Chạy tests /test coverage
/debug Debugger Deep debug /debug memory leak
/scout Scout Phân tích codebase /scout find auth files
/docs Docs Manager Tạo documentation /docs API readme
/git Git Manager Git operations /git commit feature
/design Designer UI/UX design /design dashboard
/bootstrap Architect Khởi tạo project /bootstrap react app
/brainstorm Brainstormer Brainstorm ideas /brainstorm features
/skill Dynamic Load skill cụ thể /skill mcp-builder
/worktree Git Manager Quản lý worktrees /worktree create feature
/preview Fullstack Preview changes /preview
/integrate Fullstack Integrate components /integrate api frontend
/kanban PM Quản lý Kanban /kanban status

Khi nào dùng Command nào?

🔄 Workflow đề xuất

  1. /plan → Bắt đầu task mới, tạo implementation plan
  2. /cook hoặc /code → Implement code
  3. /review → Review code vừa viết
  4. /fix → Fix issues từ review
  5. /test → Viết và chạy tests
  6. /docs → Update documentation
  7. /git → Commit và push

🔌 AI Providers

# OAuth Login (Free)
ccs gemini --auth
ccs agy --auth

# API Key Setup
ccs glm --config
ccs kimi --config

# Web Dashboard
ccs config

# Health Check
ccs doctor

🧠 Thinking Levels

Level Tokens Use Case
none 0 Quick responses
low 1,024 Simple tasks
medium 4,096 Standard work
high 16,384 Complex analysis
ultrathink 65,536 Maximum reasoning

⚙️ CCS Commands

ccs config         # Web dashboard
ccs doctor         # Health check
ccs glm "task"     # Gọi GLM trực tiếp
ccs gemini "task"  # Gọi Gemini trực tiếp
ccs agy "task"     # Gọi Antigravity
ccs --version      # Check version

Ready to Get Started?

Clone the repo and start saving on AI costs today.

Clone from GitHub