🎯 VOK Command Workflow Guide

Hướng dẫn trực quan giúp bạn hiểu cách VOK hoạt động và chọn đúng lệnh cho từng tình huống.

🔄 VOK Flow Diagram

Tổng quan cách VOK hoạt động từ khi gọi lệnh đến khi nhận kết quả.

ENTRY POINT

Bạn gõ `vok` từ bất kỳ đâu

⚡

vok Global command - hoạt động ở mọi thư mục

CONFIG CHECK

VOK kiểm tra cấu hình

❓ Đã có config?

❌ Chưa

🛠️ SETUP MENU

Chọn default model

✅ Rồi

➡️ CONTINUE

Load config

MODE SELECTION

Chọn chế độ chạy

⚡

Quick Mode

vok "task"

Chạy 1 task, auto-route đến AI phù hợp, trả kết quả

Task → Smart Route → AI → Result

💬

Session Mode

vok --session

Mở Claude Code terminal, dùng slash commands

/plan → /cook → /review → /git

🖥️

Interactive Mode

vok

REPL - gõ nhiều tasks liên tiếp

Prompt ↔ Response ↔ Prompt

SMART ROUTING

Tự động chọn AI Model

Task của bạn

"implement user auth"

🧠 Keyword Analyzer

implement → CODING

GLM Coding $0.001

Gemini Review FREE

Agy Planning FREE

Claude Complex $$$

EXECUTION

Thực thi qua CCS

1 📄 Load Agent Prompt
.claude/agents/coder.md

→

2 📋 Inject Context
PROJECT_PLAN.md, DEV_LOG.md

→

3 🚀 Execute via CCS
ccs glm -p "task"

→

4 ✅ Return Result
Code, explanations, files

💬 Session Mode Flow

Khi bạn dùng vok --session, Claude Code terminal mở ra với các slash commands.

Claude Code via CCS

> /plan "implement user authentication"

📝 Loading .claude/commands/plan.md...

🧠 Using Planner Agent...

✅ Created: plans/2024-12-25-auth/plan.md

> /code @plan.md

⚡ Implementing step by step...

Slash Commands Available

/plan Tạo implementation plan

/cook All-in-one: plan → code → test

/code Implement theo plan

/fix Sửa lỗi

/review Code review

/test Chạy tests

/git Git operations

/docs Documentation

/design UI/UX design

/scout Explore codebase

File References

@file.ts Reference file

@plan.md Reference plan

🌳 Decision Tree - Chọn lệnh nào?

Không biết dùng lệnh gì? Xem decision tree dưới đây!

🎯 Bạn muốn làm gì?

🆕 Dự án mới?

/bootstrap

📂 Join dự án?

/scout → /docs

🔨 Build feature?

⚡ Nhanh

/cook

🛡️ Kỹ

/plan → /code

🐛 Fix bug?

/debug → /fix

📦 Git?

/git

🆕 Bắt đầu dự án mới

vok --session

Mở session mode

/bootstrap e-commerce với React + Node

AI research, plan, setup structure

/git commit "Initial setup"

Commit và push

📂 Join dự án có sẵn

cd /project && vok --session

Navigate và mở session

/scout "find auth files"

Explore codebase

/docs "summarize this codebase"

Hiểu project

💡 Use Cases - Ví dụ thực tế

🔐

Thêm Authentication

# Nhanh
/cook "implement JWT auth"

# Kỹ
/plan "auth system" → /code @plan.md

🐛

Sửa Bug Production

/debug "500 error on checkout"
/fix "payment timeout issue"

🎨

Design Dashboard

/brainstorm "dashboard layout"
/design "admin panel with charts"

📱

Thêm API Endpoint

vok "create REST API for users"
# Routes to GLM (cheap, fast)

🔄 Common Workflows

⚡ FAST

Quick Feature

/cook

→

/git push

🛡️ SAFE

Careful Feature

/plan

→

/code

→

/review

→