HERDR HANDBOOK · VI
Multi-Agent với Herdr
Dùng agent name, start/prompt/wait/read để điều phối Codex theo vai trò rõ ràng.
1. Phân vai agent
Architect / Main ├─ Frontend Agent ├─ Backend Agent ├─
Reviewer Agent └─ Tester Agent
Không nhất thiết lúc nào cũng cần 5 agent. Bắt đầu với Implementer + Reviewer là đủ để học.
2. Start agent trong pane có sẵn
# Pane phải đang ở shell prompt rảnh
herdr agent start reviewer --kind codex --pane w1:p2
# Có thể truyền args của agent sau --
herdr agent start reviewer --kind codex --pane w1:p2 -- -m gpt-5.4
agent start không tạo pane. Bạn phải tạo/split
pane trước.
3. Gửi prompt
herdr agent prompt reviewer "Review the current git diff"
herdr agent prompt reviewer "Review the current git diff. Focus on bugs and maintainability." --wait --timeout 120000
4. Wait và đọc kết quả
herdr agent wait reviewer --until blocked --timeout 120000
herdr agent read reviewer --source recent-unwrapped --lines 120
herdr agent send-keys reviewer esc
5. Pipeline nên dùng
- Implementer sửa feature trong worktree riêng.
- Reviewer đọc diff và trả issues.
- Implementer fix.
- Tester chạy test/linters.
- Chỉ merge khi branch sạch và checks pass.
6. Đừng orchestration quá sớm
Chi phí context
Nhiều agent không tự động tốt hơn. Nếu task nhỏ, một
Codex + một reviewer thường hiệu quả hơn 5 agents giao
tiếp chồng chéo.