Chuyển tới nội dung chính

Bài 3 — Chạy task đầu tiên

Trang này hướng dẫn chạy một task trọn vòng từ tạo task và theo dõi agent đến duyệt và merge, để bạn phối hợp đúng giữa người làm và người duyệt ngay lần đầu.

Đối tượng: member (làm task) + admin (duyệt) phối hợp lần đầu. Điều kiện: đã có Space sau Bài 2; agent CLI có trên PATH (kiểm tra GET /api/agents; chưa có thì dùng AGENTBOARD_FAKE_AGENT=1 ở dev). Thời gian: ~30 phút (tùy agent chạy lâu hay nhanh).

Toàn cảnh một vòng task​

Nút Start Agent không phải lúc nào cũng chạy ngay — server từ chối khi:

Tình huốngServer trảBạn làm gì
Task còn blocker chưa done400 … blocked by unresolved tasksMở task phụ thuộc, xong blocker rồi chạy lại
Đã có agent đang chạy trên task409 agent already runningTheo dõi tiếp hoặc Stop rồi chạy lại
Bấm liên tục / 2 người cùng bấm409 run already claimed hoặc 429Đợi vài giây, refresh — chỉ một lượt chạy thắng claim

Member: tạo task & chạy agent​

  1. Bấm New Task (phím N) và điền:
    • title — ví dụ "Thêm endpoint health check" (bài đầu nên chọn việc nhỏ, an toàn);
    • description — càng cụ thể càng tốt; agent chỉ biết những gì bạn viết cộng .board/wiki/**;
    • type = task, priority, agentType (CLI sẽ thực thi);
    • repoPath kế thừa Space, baseBranch = main, useWorktree = bật.
  2. Kéo task sang In Progress → bấm Start Agent (hoặc POST /api/tasks/:id/run). Cần nhảy giữa Space, task hay view thì bấm Cmd+K / Ctrl+K rồi gõ mờ tên cần tìm.
  3. Theo dõi realtime: panel bên phải stream qua WebSocket — thinking, lệnh chạy, file sửa. Tab Changes xem diff đang hình thành.
  4. Muốn bổ sung yêu cầu giữa chừng? Tab Follow-up → gửi tin nhắn (POST /api/tasks/:id/message).
  5. Agent xong → task tự sang Review (reviewState = peer-review).

Muốn dừng giữa đường: Stop Agent — worktree giữ nguyên để kiểm tra (task đánh dấu failed, không mất code đang làm dở; bấm Start lại để chạy tiếp).

Viết description thế nào cho agent làm đúng

Agent chỉ biết những gì bạn viết cộng .board/wiki/**. Công thức đủ dùng cho bài đầu: mục tiêu 1 câu + phạm vi file (sửa file nào, cấm đụng file nào) + tiêu chí xong (chạy được lệnh gì để chứng minh). Ví dụ tệ: "Sửa lỗi đăng nhập". Ví dụ tốt: "Thêm GET /health trả {status:ok} trong packages/server/src/index.ts; không đụng auth; xong khi curl localhost:8080/api/health trả 200".

Admin: duyệt & merge (người thứ hai)​

  1. Vào Review View: đọc 3 tab — Automated Verdict (điểm + findings của Reviewer Agent), Code Changes (diff), Quality Checks (tham khảo, không phải cổng chặn).
  2. Đạt → bấm Approve (phím a): hệ thống merge (merge-local → git merge --no-ff vào main), task sang done/approved.
  3. Chưa đạt → Request Changes với ghi chú cụ thể → agent rework trên cùng worktree → duyệt lại.

Chi tiết: Duyệt & approve.

Xác minh (cả hai cùng xem)​

  • Cột Review từng có task; .board/result.json trong worktree hợp lệ; tab Changes từng hiện diff.
  • Sau approve: git log trên baseBranch có commit merge --no-ff; task ở done/approved.
  • GET /api/tasks/:id/reviews có bản ghi reviewer_actor_type: 'human'.

Học tiếp theo role​

Bạn làĐọc tiếp
Stakeholder / POTheo dõi tiến độ
DeveloperTạo task & chạy agent → AI Planner
Tech Lead / ReviewerDuyệt & approve → Pentest Human Gate
Chủ dự ánTạo Space & quản thành viên
Người làm tri thứcNạp tài liệu vào Wiki

Gặp lỗi? Xử lý sự cố — agent không chạy, task kẹt Review, approve 403/409.

Chúc mừng — bạn đã chạy xong vòng đầu! Đào sâu theo vai trò ở bảng trên, hoặc tra cứu API hay dùng khi muốn gọi thẳng endpoint.

Cập nhật lần cuối vào