Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:gkg

Đồ thị mã ngữ nghĩa GKG

Lập chỉ mục Git repo bằng GitLab Knowledge Graph, rồi truy vấn qua MCP hoặc HTTP để tìm định nghĩa, chỗ dùng, ảnh hưởng refactor và kiến trúc.

01

Xác nhận đúng việc

02

Kiểm tra repo

03

Lập chỉ mục mã

04

Khởi động máy chủ truy vấn

Nguyên tắc 01

Dùng GKG cho quan hệ ngữ nghĩa, không dùng như công cụ dump token thô.

Nguyên tắc 02

Lập chỉ mục trước khi truy vấn; kết quả chỉ đáng tin bằng đồ thị hiện có.

Nguyên tắc 03

Nêu rõ caveat khi cross-file refs của TS/JS/Python chưa đầy đủ.

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

01

Khởi động

Đầu vào, phạm vi, route

  1. 1 Xác nhận đúng việc Dùng GKG khi cần điều hướng ngữ nghĩa, tìm chỗ dùng, nhảy tới định nghĩa, phân tích ảnh hưởng, vẽ kiến trúc hoặc hiểu mã kiểu RAG; dùng repomix nếu chỉ cần dump ngữ cảnh nhanh hoặc ngôn ngữ chưa phù hợp.
  2. 2 Kiểm tra repo Bảo đảm mục tiêu là Git repo đã khởi tạo và nhớ rằng GKG lưu chỉ mục trong ~/.gkg/.
02

Xử lý

Agent / skill thực thi

  1. 3 Lập chỉ mục mã Chạy luồng lập chỉ mục đã ghi, như gkg index hoặc gkg index /path/to/project --stats, trước khi truy vấn.
  2. 4 Khởi động máy chủ truy vấn Khởi động gkg server start để công cụ MCP hoặc HTTP API tại localhost:27495 đọc được đồ thị.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Truy vấn ký hiệu Dùng get_references hoặc /api/graph/search để tìm chỗ dùng, định nghĩa và đường phụ thuộc của ký hiệu.
  2. 6 Rà soát ảnh hưởng Khi refactor, lập chỉ mục các repo liên quan và xem mọi call site trước khi đổi ký hiệu.
04

Đóng

Báo cáo, bàn giao, artifact

  1. 7 Tôn trọng giới hạn Báo rõ giới hạn hỗ trợ ngôn ngữ: Ruby/Java/Kotlin có cross-file refs đầy đủ, còn Python/TypeScript/JavaScript vẫn đang hoàn thiện.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:gkg [symbol or query]

Đối số

[symbol or query] Bắt buộc

Ký hiệu hoặc câu hỏi đồ thị

Tên ký hiệu, member đầy đủ hoặc câu hỏi code bằng ngôn ngữ tự nhiên cần giải bằng đồ thị repository hiện tại. Nêu repository hoặc ràng buộc khi ngữ cảnh chưa rõ.

/ak:gkg AuthService.createSession

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Tìm chỗ dùng Khuyến nghị
/ak:gkg AuthService.createSession
Dùng khi:
Khi cần biết mọi nơi dùng một hàm hoặc class trước khi sửa.
Kết quả:
Lập hoặc dùng đồ thị hiện tại, truy vấn references, rồi báo call site kèm caveat ngôn ngữ.
Phân tích ảnh hưởng
/ak:gkg impact of renaming UserRepository
Dùng khi:
Khi refactor có thể ảnh hưởng nhiều file hoặc package.
Kết quả:
Liệt kê ký hiệu bị ảnh hưởng và yêu cầu rà mọi call site trước khi refactor.

Phạm vi xử lý

  • Nhảy tới định nghĩa và tìm chỗ dùng
  • Phân tích ảnh hưởng refactor
  • Vẽ kiến trúc và đồ thị phụ thuộc
  • Truy vấn đồ thị qua MCP/HTTP

Artifact tạo ra

Kết quả đồ thị ngữ nghĩa

Mẫu đường dẫn

Mục tiêu đã index, truy vấn đã dùng, ký hiệu khớp, references và caveat.

Đầu ra hữu ích là tập ký hiệu và quan hệ có thể kiểm chứng, không phải tóm tắt mã chung chung.

Tiếp theo