#Quy Tắc & Quy Trình (Rules & Workflows)
#Tổng Quan
Antigravity cung cấp hai cơ chế để tùy chỉnh hành vi của Agent: Rules (Quy tắc) và Workflows (Quy trình). Hai khái niệm này bổ sung cho nhau nhưng phục vụ mục đích khác nhau.
#Rules — Quy Tắc
#Định Nghĩa
Rules là các ràng buộc do người dùng định nghĩa nhằm hướng dẫn hành vi của Agent. Chúng hoạt động như chỉ thị cấp hệ thống (system-level instructions) để Agent tuân thủ các tiêu chuẩn coding, thực hành documentation hoặc các quy ước cụ thể của dự án.
#Phạm Vi Áp Dụng
- Global Rules (Quy tắc toàn cục): Áp dụng cho mọi workspace. Thường chứa các quy ước tổng quát như coding standards, naming conventions.
- Workspace Rules (Quy tắc workspace): Chỉ áp dụng cho một workspace cụ thể. Chứa các quy ước riêng của dự án.
#Đặc Điểm
- Rules là thụ động (passive) — chúng không kích hoạt hành động, mà ràng buộc cách Agent hành động
- Agent sẽ luôn tuân thủ rules khi thực thi tác vụ
- Rules được lưu trong file cấu hình đặc biệt trong thư mục dự án
#Ví Dụ Rules
- Luôn viết code theo chuẩn TypeScript strict
- Sử dụng camelCase cho tên biến và hàm
- Mọi component React phải có PropTypes hoặc TypeScript interface
- Viết tài liệu bằng Tiếng Việt, giữ nguyên thuật ngữ kỹ thuật Tiếng Anh
- Không sử dụng any type trong TypeScript
#Workflows — Quy Trình
#Định Nghĩa
Workflows là các prompt đã lưu (saved prompts) định nghĩa một chuỗi bước để Agent thực hiện các tác vụ lặp lại. Chúng hoạt động như mẫu hành động (action templates) cho các quy trình phổ biến.
#Định Dạng
- Được lưu dưới dạng file Markdown (
.md) - Có thể được gọi bằng slash commands (
/tên-workflow) trong giao diện Agent - Chứa các bước cụ thể, có thể bao gồm lệnh terminal, kiểm tra điều kiện, và hướng dẫn chi tiết
#Đặc Điểm
- Workflows là chủ động (active) — chúng được kích hoạt bởi người dùng thông qua slash commands
- Có thể chứa logic điều kiện, kiểm tra tiên quyết và xử lý lỗi
- Tái sử dụng được và chia sẻ trong team
#Ví Dụ Workflows
MARKDOWN
---
description: Triển khai code theo kế hoạch
---
1. Đọc kế hoạch triển khai trong docs/ke_hoach/
2. Xác định task chưa hoàn thành
3. Viết code cho task được chọn
4. Chạy build check
5. Cập nhật trạng thái vào PROJECT_STATE.md#So Sánh Rules vs Workflows
| Đặc Điểm | Rules | Workflows |
|---|---|---|
| Loại | Thụ động (ràng buộc) | Chủ động (hành động) |
| Kích hoạt | Tự động — luôn áp dụng | Thủ công — qua slash command |
| Mục đích | Định nghĩa "Agent NÊN làm gì" | Định nghĩa "Agent LÀM GÌ theo trình tự" |
| Phạm vi | Global hoặc Workspace | Workspace |
| Định dạng | Danh sách quy tắc | File Markdown có bước cụ thể |
#Cách Thiết Lập
#Tạo Rules
- Tạo file
GEMINI.md(hoặc tương đương) tại thư mục gốc workspace - Viết các quy tắc mà Agent cần tuân thủ
- Agent sẽ tự động đọc và áp dụng rules khi làm việc
#Tạo Workflows
- Tạo thư mục
.agents/workflows/trong dự án - Tạo file
.mdcho mỗi workflow (VD:trien-khai.md) - Sử dụng slash command
/trien-khaiđể kích hoạt workflow