Tạo task & chạy agent — dành cho Member

Đối tượng: developer trực tiếp biến yêu cầu thành task và giao cho agent. Role kỹ thuật: Board member — tạo/sửa task, chạy/dừng agent, apply plan, ghi Wiki draft; không approve/merge. Điều kiện: đã có Space và bạn đã là member trở lên (nếu 403 mọi thứ, xem Xử lý sự cố).

Ranh giới quan trọng nhất: "làm" (member) tách khỏi "duyệt" (admin). Nút Approve bị chặn với bạn là đúng thiết kế.

Màn hình liên quan

Màn hình	Bạn làm gì ở đây
Board View (màn hình chính)	New Task (phím N), tìm kiếm, filter chips, kéo-thả 4 cột; panel Agent bên phải (3 tab Event Stream / Changes / Follow-up)
Tree View	Xem cây epic → story → task sau Apply Plan; kiểm tra quan hệ blocks
Review View	Chỉ xem (không duyệt): biết task mình đang ở tầng thẩm định nào

Tạo task thủ công & chạy agent

1. Bấm New Task (phím N) và điền:
   • title, và description càng cụ thể càng tốt — agent chỉ biết những gì bạn viết cộng với .board/wiki/**;
   • type (task / bug / story / epic), priority, agentType (CLI sẽ thực thi);
   • repoPath (kế thừa từ Space, override được), baseBranch (thường main);
   • useWorktree — bật: agent làm việc trên bản checkout cách ly, không phá code bạn đang viết dở.
2. Kéo task sang In Progress → bấm Start Agent (POST /api/tasks/:id/run).
3. Theo dõi panel bên phải: dòng thinking, lệnh terminal, file sửa đổi (tab Changes cho diff đang hình thành).
4. Cần bổ sung yêu cầu giữa lúc agent chạy? Tab Follow-up → gửi tin nhắn (POST /api/tasks/:id/message) — không cần restart.
5. Agent xong → task tự chuyển sang Review với reviewState = peer-review. Việc của bạn tới đây là xong — chờ approver.

Muốn dừng giữa đường: Stop Agent (POST /api/tasks/:id/stop). Worktree được giữ nguyên để bạn kiểm tra.

Viết mô tả task cho agent làm tốt

Chất lượng đầu ra tỉ lệ thuận với chất lượng description:

• Liệt kê acceptance criteria cụ thể, kiểm chứng được (agent và Reviewer Agent đối chiếu từng tiêu chí).
• Thêm mục non-goals — những gì agent không được chạm (file, module, hành vi).
• Đừng copy-paste convention code vào mô tả: tri thức Wiki đã được bơm tự động vào .board/wiki/**. Xem Wiki hai chiều.

Việc bạn KHÔNG làm được ở trang này (và vì sao)

Bạn thử	Kết quả	Vì sao
Approve / Request Changes	403	Cần admin và human thật — service token cũng 403 vì phân giải về system
Kéo task bị block sang in-progress khi blocker chưa done	bị chặn kèm thông báo	Dependency gating bảo vệ bạn khỏi code trên nền cũ

Checklist tự xác minh

• Tạo task với useWorktree bật, chạy agent, thấy stream realtime và diff ở tab Changes.
• Dùng Follow-up nhắn bổ sung giữa chừng; biết Stop giữ nguyên worktree.
• Mô tả task có acceptance criteria cụ thể + non-goals.

Đọc tiếp: AI Planner — ý tưởng thành cây Epic/Task · Task không chạy / agent treo? · Khi agent treo / đi sai hướng.