GEMINI.md (Gemini CLI): vị trí và cách các tool đọc tệp

GEMINI.md là tệp context mà Gemini CLI gửi kèm mỗi prompt. Tệp này cũng có thể đọc AGENTS.md hoặc tên tệp khác do bạn đặt trong context.fileName.

Vị trí

• Toàn cục: ~/.gemini/GEMINI.md.
• GEMINI.md trong thư mục workspace và các thư mục cha.
• GEMINI.md được tìm thấy theo yêu cầu trong các thư mục mà công cụ truy cập, cùng các thư mục cha của chúng cho đến thư mục gốc đáng tin cậy.

Định dạng

Markdown, không có frontmatter. Nhúng các tệp khác bằng @file.md, với đường dẫn tương đối hoặc tuyệt đối, thông qua Memory Import Processor. Có thể cấu hình tên tệp bằng context.fileName dưới dạng chuỗi hoặc danh sách.

# Project context

@./docs/architecture.md

## Commands

- Install: `uv sync`
- Test: `uv run pytest`
- Lint: `uv run ruff check .`

## Rules

- Target Python 3.13 with type hints on public functions.
- Keep database code in app/db/.
- Never run migrations against production.

Thứ tự ưu tiên và hợp nhất

Các tệp được tải theo thứ tự: toàn cục, sau đó là thư mục workspace và các thư mục cha, rồi đến các tệp được tìm thấy theo yêu cầu. Tất cả được nối lại và gửi kèm mỗi prompt, nên không có tệp nào ghi đè tệp khác.

Các tool đọc tệp này

Mẹo

• Đặt context.fileName thành ["AGENTS.md", "GEMINI.md"] trong .gemini/settings.json để dùng chung một tệp với các agent khác.
• Mọi tệp được tải đều được gửi kèm mỗi prompt, vì vậy hãy lược bỏ nội dung mà model không cần trong từng lần.
• Dùng /memory show để xem chính xác Gemini CLI đã tải những gì, và chạy /memory reload sau khi chỉnh sửa.

Các tệp hướng dẫn khác