Understand — Phân tích codebase

Tạo knowledge graph từ codebase để hiểu architecture, components, và dependencies. Hỗ trợ onboarding, code review, và impact analysis.

Sử dụng GitLab Knowledge Graph (GKG) engine bên dưới. Hỗ trợ go-to-definition, find-usages, impact analysis.

Cú pháp

/understand                      # Scan codebase, tạo knowledge graph
/understand-chat                 # Hỏi đáp về codebase dựa trên graph
/understand-dashboard            # Mở dashboard web để visualize graph
/understand-diff                 # Phân tích git diff/PR — affected components
/understand-explain "file/func"  # Giải thích sâu 1 file hoặc function
/understand-onboard              # Tạo onboarding guide cho thành viên mới

Bảng tham chiếu nhanh

Lệnh	Mô tả	Use case
`/understand`	Scan + build knowledge graph	Lần đầu phân tích codebase
`/understand-chat`	Hỏi đáp interactive về code	”API auth flow hoạt động thế nào?”
`/understand-dashboard`	Web dashboard visualize	Xem architecture diagram
`/understand-diff`	Phân tích changes	Review PR, impact analysis
`/understand-explain`	Deep-dive 1 file/function	Hiểu logic phức tạp
`/understand-onboard`	Generate onboarding guide	Thành viên mới join team

Luồng hoạt động

Bước 1: Scan codebase

Đọc toàn bộ source files, parse imports, exports, function calls.

Bước 2: Build knowledge graph

Tạo graph với nodes (files, functions, classes) và edges (imports, calls, dependencies).

Bước 3: Analyze patterns

Phát hiện architectural patterns, circular dependencies, coupling metrics.

Bước 4: Interactive query

Cho phép query graph: “file nào depend vào UserService?”, “component nào bị ảnh hưởng nếu đổi schema?”

Ví dụ thực tế

/understand-explain
/understand-diff
/understand-onboard

/understand-explain "src/modules/auth/auth.service.ts"

Output: Giải thích chi tiết từng method, dependencies, security flow.

/understand-diff #42

Output: PR #42 ảnh hưởng 5 modules, 2 API endpoints, 1 database migration.

/understand-onboard

Output: Guide cho dev mới — architecture overview, key files, setup steps.

GKG — GitLab Knowledge Graph

/gkg là engine bên dưới, cung cấp semantic code intelligence:

Tính năng	Mô tả
Go-to-definition	Nhảy đến nơi function/class được define
Find-usages	Tìm tất cả nơi sử dụng 1 symbol
Impact analysis	Đánh giá ảnh hưởng khi thay đổi code
Dependency graph	Visualize module dependencies

Khi nào dùng / không dùng

Dùng	Không dùng
Onboarding thành viên mới	Tìm 1 file cụ thể (dùng `/scout`)
Review PR phức tạp	Debug lỗi (dùng `/investigate` — iron law, hoặc `/ck-debug` cho systematic)
Hiểu legacy codebase	Task đơn giản, đã biết code
Đánh giá refactoring impact	Generate code (dùng `/cook`)

Bắt đầu

Quan trọng

AgentKit (AK) — Migration mới

Tham khảo

Dev — Bắt đầu

Dev — Lệnh chính

Dev — Phân tích & Nghiên cứu

Dev — Công cụ hỗ trợ

Dev — Skills nổi bật

QA — Bắt đầu

QA — Use Cases

PM — Bắt đầu

PM — Lập kế hoạch

PM — Vận hành

PM — Kỹ thuật

PM — Skills nổi bật

DevOps — Bắt đầu

DevOps — Triển khai

DevOps — Bảo mật & Chất lượng

DevOps — Giám sát

DevOps — Skills nổi bật

Design — Bắt đầu

Design — Công cụ

Design — Quy trình

Design — Skills nổi bật

Marketing — Bắt đầu

Marketing — Nội dung

Marketing — Phân phối

Marketing — Quản lý

Understand

Understand — Phân tích codebase

Cú pháp

Bảng tham chiếu nhanh

Luồng hoạt động

Ví dụ thực tế

GKG — GitLab Knowledge Graph

Khi nào dùng / không dùng

​Understand — Phân tích codebase

​Cú pháp

​Bảng tham chiếu nhanh

​Luồng hoạt động

​Ví dụ thực tế

​GKG — GitLab Knowledge Graph

​Khi nào dùng / không dùng

Understand — Phân tích codebase

Cú pháp

Bảng tham chiếu nhanh

Luồng hoạt động

Ví dụ thực tế

GKG — GitLab Knowledge Graph

Khi nào dùng / không dùng