Làm việc với task
Mô tả task
Mô tả chỉ trả lời "task này làm gì và khi nào xong", gồm 4 mục ngắn:
| Mục | Nội dung |
|---|---|
| Mục tiêu | Task giải quyết vấn đề gì |
| Phạm vi | Làm gì, không làm gì |
| Output | Thứ phải tạo ra (file, màn hình, API...) |
| Input / Reference | Đường dẫn tài liệu, code, spec liên quan |
Tiến độ, kết quả khảo sát, nhật ký từng bước không ghi vào mô tả. Việc nhỏ, chi tiết từng bước thì tách thành task con.
Tiêu chí, điều kiện đóng và vướng mắc
Mỗi task có một danh sách các dòng có trạng thái, mỗi dòng có mã CHK-số để chép vào chat:
| Loại | Ý nghĩa |
|---|---|
| Tiêu chí nghiệm thu | Điều kiện task này phải đạt |
| Không làm hỏng | Tính năng đang chạy có thể bị ảnh hưởng, kèm cách kiểm lại. Đóng dòng này phải có bằng chứng đã kiểm |
| Điều kiện đóng | Điều kiện cuối cùng để coi là xong, ví dụ "Khách xác nhận kết quả" |
| Vướng mắc | Câu hỏi hoặc trở ngại đang chờ trả lời |
Khi đạt đủ tiêu chí, agent chuyển task sang Chờ kiểm tra và báo bạn - không tự đóng task. Vướng mắc chưa trả lời được làm nổi bật trên trang task và nhắc lại cho agent ở mỗi phiên.
Trao đổi
- Bình luận là nơi mọi người trao đổi với nhau trên task. Gõ
@emailđể nhắc tên - agent của người đó sẽ thấy trong hộp thư. - Mỗi bình luận có mã
CMT-số. Chép mã vào chat để agent biết bạn đang nói tới bình luận nào. - Agent chỉ đăng bình luận khi bạn yêu cầu, không dùng bình luận để tự ghi chú.
Làm việc cả nhóm
- Phụ thuộc: task B chờ task A xong. Khi A hoàn thành, người làm B được báo trong hộp thư.
- Đang có người làm: agent được nhắc khi task đang do người khác làm.
- Không ghi đè: hai người cùng sửa một task thì lần ghi sau bị từ chối, phải đọc lại bản mới rồi mới ghi.
- Kiểm working tree: trước khi sửa code, agent phải kiểm
git statusvà dừng hỏi bạn nếu đang có thay đổi chưa commit không thuộc task.
Bảo mật nội dung
Mật khẩu, token, API key bị từ chối khi lưu vào task, bình luận hay ngữ cảnh dự án. Hãy ghi nơi lấy bí mật (ví dụ tên biến trong .env), không ghi giá trị.