Tóm tắt nhanh:
ak-scouttìm trong repo và trả lại danh sách file liên quan, mỗi file kèm một dòng nói nó làm gì, cùng những câu hỏi chưa trả lời được. Hỏi một tên thì nó trả đường dẫn luôn, xong thường chuyển sangak-fix. Nó chỉ tìm và đọc, không sửa code.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn sắp sửa một chỗ nhưng chưa biết code nằm ở đâu. Nó không thay bước gỡ lỗi: scout chỉ khoanh vùng file, chứng minh nguyên nhân và sửa là việc của ak-debug và ak-fix.
flowchart LR
A["Chưa biết code nằm đâu"] --> B["ak-scout"]
B --> C["Danh sách file + câu hỏi còn mở"]
C --> D["ak-fix"]
C --> E["ak-debug hoặc ak-brainstorm"]
C --> F["Dừng, chỉ cần biết vị trí"]Nó chọn đường tìm theo việc bạn hỏi:
| Đường | Câu hỏi | Ví dụ |
|---|---|---|
| Đường nhanh | Bạn chỉ cần vị trí của một thứ? | "Hàm calculateShippingFee ở đâu?" trả đường dẫn đã kiểm và vai trò của file |
| Chia phạm vi | Việc trải qua nhiều vùng độc lập của repo? | src/payments/, src/api/, tests/, config/: mỗi vùng một phạm vi |
ext | Tìm tại chỗ không đủ và bạn cho phép dùng công cụ ngoài? | /ak-scout ext migration và schema DB chạy vài lệnh opencode run chỉ đọc |
| Báo cáo | Nhận lại gì khi tìm nhiều vùng? | Mục "Relevant Files" và mục "Unresolved Questions" |
Nó chỉ chia việc cho subagent khi bạn ghi rõ cho phép chạy song song. Không có cho phép đó thì agent chính tự tìm từng vùng: kết quả vẫn vậy, chỉ lâu hơn. Riêng --ultra không có đường lùi: runtime không chạy được song song thì nó dừng.
Prompt mẫu cho chuẩn bị sửa bug:
/ak-scout Lỗi: upload ảnh đại diện trên <tên app> báo thành công nhưng ảnh không đổi.
Tìm code upload, xử lý ảnh và nơi lưu URL ảnh.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--ultra | 5 bản scout độc lập, gộp kết quả đã kiểm | 2.13.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, giải thích cờ --ultra (dùng khi, không cần khi, nhận lại gì), lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-scout: tìm đúng file cần đụng tới trong codebase" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-scout". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-scout
