Vòng đời một task
Một task đi từ lúc nhận đến lúc nghiệm thu qua vài trạng thái, và mỗi bước có lệnh ph bandum tương ứng. Trang này nói rõ ai làm gì ở từng bước. Bạn cần thiết lập Phillip trong repo của dự án trước, xem Dev và Test.
Mã task có dạng GH-12, là số của issue. Trên GitLab bạn vẫn dùng tiền tố GH- với số issue trong project.
Vuốt ngang để xem hết sơ đồ.
Các trạng thái của task
Trạng thái nằm ở nhãn status: ... trên issue. Bandum và Phillip tự đặt nhãn này, bạn không cần gắn.
| Trạng thái | Nhãn | Khi nào |
|---|---|---|
| Todo | (chưa có nhãn status:) | Issue đã tạo, chưa ai nhận |
| In progress | status: in progress | Dev đã nhận task và đang làm |
| Review | status: review | Dev làm xong, chờ kiểm thử nghiệm thu |
| Approved | status: approved | Mọi testcase đạt, người kiểm thử bấm Approve |
| Rejected | status: rejected | Có testcase không đạt, task bị trả lại cho Dev |
| Done | (issue đã đóng) | PR đã merge. Mô tả PR có "Closes #n" nên issue tự đóng |
Một task đi thẳng từ Todo qua In progress, Review, Approved rồi Done. Nếu bị Rejected thì nó quay lại In progress để sửa, sau đó lại vào Review.
Vuốt ngang để xem hết sơ đồ.
Ngoài ra, mỗi issue có nhãn type: feature | bug | debt | risk và level: S | M | L. Mức level quyết định thư mục chứa tài liệu kiểm thử của task. Thiếu type: thì Phillip nhắc nhưng không chặn bạn.
Nhận task
ph bandum start GH-12Lệnh gán task cho bạn, đặt nhãn status: in progress, tạo nhánh feature/GH-12-<tiêu-đề> và tạo khung testcases.md đúng chỗ. Khung này chưa được commit, và mỗi AC của task có sẵn một mục ## TC-n (AC-x.y) <fill in the name> để bạn điền.
Bạn xem task của sprint, hoặc chỉ task của riêng mình, bằng:
ph bandum board # task của sprint theo trạng thái
ph bandum board --mine # chỉ task gán cho bạnLàm việc cùng agent
Bạn làm việc bình thường với Claude Code qua ph, trên nhánh vừa tạo. Trong lúc đó, hãy điền testcases.md để mỗi AC có ít nhất một testcase. File nằm ở docs/acceptance/GH-12/ với task mức S, M và ở docs/features/GH-12-<tên>/ với mức L. Nếu không chắc vị trí, bạn hỏi Phillip bằng ph bandum paths.
Trước khi commit, bạn kiểm tra:
ph bandum checkLệnh báo lỗi định dạng, trùng mã TC, AC chưa có testcase và mục còn khung chưa điền. Nó thoát với mã 0 khi không có lỗi và 2 khi có lỗi.
Nếu mở phiên AI bằng mã task, trên nhánh đúng dạng feature/GH-12-..., thì chi phí AI được gắn vào task trong số liệu của dự án.
Mở PR
Bạn push nhánh rồi mở PR (trên GitLab là MR) với "Closes #12":
git push -u origin HEAD
ph bandum pr GH-12Chuyển sang kiểm thử
Nếu dự án có .bandum.json, bạn chạy kiểm thử tự động trước, rồi mới chuyển:
ph bandum verify GH-12 # chạy test nghiệm thu tự động của nhánh PR
ph bandum review GH-12 # kiểm PR và testcase, đặt nhãn status: reviewph bandum review từ chối khi còn AC chưa có testcase. Sau đó người kiểm thử (Test hoặc BA) nhận task ở cột Waiting for testing (chờ kiểm thử) và chấm Pass hoặc Fail, xem Kiểm thử và nghiệm thu. Người mở PR không tự duyệt PR của mình.
Task bị trả lại thì sửa thế nào?
Task bị trả lại sẽ có nhãn status: rejected. Bạn xử lý bằng hai lệnh:
ph bandum pull GH-12 # xem nhận xét: TC không đạt, AC, ghi chú
ph bandum fix GH-12 # đặt lại in progress, checkout nhánh PR, giao agent sửa theo nhận xétKhi bạn chạy ph bandum fix, agent sửa theo nhận xét, testcase và AC, rồi commit và push. Sau đó bạn chạy lại ph bandum verify và ph bandum review. Mỗi lần kiểm thử được ghi nối tiếp vào acceptance.md, không ghi đè lần cũ.
Khi mọi testcase đạt, người kiểm thử bấm Approve (duyệt) và task chuyển sang status: approved. Bạn merge PR, issue tự đóng và task xong.