Task Groups

Task Groups là cách Antigravity tổ chức và hiển thị các tác vụ phức tạp cho người dùng.

Task Groups là gì?

Khi Agent thực hiện một tác vụ lớn, nó sẽ:

Chia thành nhiều subtasks
Nhóm các subtasks liên quan
Hiển thị tiến độ theo nhóm

Giao diện Task Groups


📋 Task: Xây dựng feature authentication

├── 🔍 Planning
│   ├── ✅ Phân tích requirements
│   ├── ✅ Thiết kế database schema
│   └── ✅ Tạo implementation plan
│
├── 🛠️ Backend Implementation
│   ├── ✅ Tạo User model
│   ├── ✅ Implement register API
│   ├── 🔄 Implement login API
│   └── ⬜ Add JWT authentication
│
├── 💻 Frontend Implementation
│   ├── ⬜ Tạo Login form
│   ├── ⬜ Tạo Register form
│   └── ⬜ Auth state management
│
└── ✅ Verification
    ├── ⬜ Unit tests
    ├── ⬜ Integration tests
    └── ⬜ Manual testing

Trạng thái Task

Icon	Trạng thái	Mô tả
⬜	Pending	Chưa bắt đầu
🔄	In Progress	Đang thực hiện
✅	Completed	Hoàn thành
❌	Failed	Thất bại
⏸️	Paused	Tạm dừng (chờ approval)

Task Boundary

Agent sử dụng task_boundary tool để:

Đánh dấu bắt đầu task mới
Cập nhật tiến độ
Chuyển đổi giữa các modes

Ví dụ


PLANNING: Designing Authentication System
├── Status: Analyzing codebase
└── Summary: Reviewed existing user model and auth middleware

EXECUTION: Implementing User Registration  
├── Status: Creating register endpoint
└── Summary: Created User model, added validation

VERIFICATION: Testing Registration Flow
├── Status: Running integration tests
└── Summary: All unit tests passed, testing API endpoints

Tương tác với Task Groups

Xem chi tiết

Click vào một task group để xem:

Các subtasks bên trong
Logs và outputs
Files đã thay đổi

Pause/Resume

Bạn có thể:

Pause một task group đang chạy
Resume từ điểm dừng
Cancel nếu không cần tiếp tục

Retry

Nếu task failed:

Xem error details
Yêu cầu Agent retry
Hoặc modify approach

Best Practices

✅ Để Agent tự chia task

Agent tự động chia task thành các nhóm hợp lý. Bạn chỉ cần mô tả mục tiêu cuối cùng.

✅ Monitor tiến độ

Theo dõi task groups để:

Phát hiện sớm vấn đề
Điều chỉnh hướng đi nếu cần
Approve ở các điểm checkpoint

✅ Review ở từng giai đoạn

Sử dụng các điểm chuyển đổi giữa task groups để:

Review kết quả giai đoạn trước
Confirm approach cho giai đoạn tiếp
Provide feedback nếu cần

Task Groups và Artifacts

Mỗi task lớn thường tạo ra artifacts:

Task Stage	Artifact
Planning	`implementation_plan.md`
Execution	Code changes, `task.md`
Verification	Test results, `walkthrough.md`

Ví dụ thực tế

Feature Development Task


📋 Add User Profile Feature

├── 🔍 Planning (5 min)
│   └── ✅ Created implementation_plan.md
│
├── 🛠️ Backend (15 min)
│   ├── ✅ Added profile fields to User model
│   ├── ✅ Created GET /api/users/:id/profile
│   └── ✅ Created PATCH /api/users/:id/profile
│
├── 💻 Frontend (20 min)
│   ├── ✅ Created ProfilePage component
│   ├── ✅ Added profile edit form
│   └── ✅ Connected to API
│
└── ✅ Verification (10 min)
    ├── ✅ All tests passed
    └── ✅ Created walkthrough.md

Bug Fix Task


🐛 Fix Login Error

├── 🔍 Investigation (3 min)
│   └── ✅ Identified root cause in auth middleware
│
├── 🛠️ Fix (5 min)
│   └── ✅ Updated token validation logic
│
└── ✅ Verification (2 min)
    └── ✅ Manual testing successful