Bỏ qua, đến phần nội dung

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.

Hành trình một task qua năm làn. BA viết issue có tiêu chí nghiệm thu. Dev nhận task bằng ph bandum start, agent làm việc dưới sự canh của Guardrails, rồi chạy verify, mở PR và chuyển sang kiểm thử bằng review. BA kiểm thử nghiệm thu, rồi Duyệt hoặc Trả lại. Trả lại thì dev chạy fix và quay lại làm việc với agent. Duyệt xong thì task Done, Ryoma ghi số liệu và gửi bản tin tuần cho PM.BA / PODev và agentGuardrailsBandumRyoma / PMViết issueAC và nhãnNhận taskph bandum startTạo nhánhkhung testcaseAgent làm việcdùng Claude CodeGuardrailschặn, che,ghi nhật kýKiểm tự độngph bandum verifyMở PRph bandum prChuyển kiểm thửph bandum reviewĐổi nhãnstatus: reviewKiểm thửnghiệm thuTrả lạicó TCkhông đạtDuyệtmọi TC đạtDoneđóng issueGhi số liệuFlow vàchi phí AIBản tin tuầngửi PMsáng thứ HaiKhông đạtĐạtph bandum fix

Vuốt ngang để xem hết sơ đồ.

Task bị trả lại thì vòng ph bandum fix lặp đến khi người kiểm thử bấm Duyệt. Bandum tự đổi nhãn trạng thái ở mỗi bước.

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áiNhãnKhi nào
Todo(chưa có nhãn status:)Issue đã tạo, chưa ai nhận
In progressstatus: in progressDev đã nhận task và đang làm
Reviewstatus: reviewDev làm xong, chờ kiểm thử nghiệm thu
Approvedstatus: approvedMọi testcase đạt, người kiểm thử bấm Approve
Rejectedstatus: rejectedCó 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.

Máy trạng thái của task. Todo chuyển sang In progress bằng ph bandum start. In progress chuyển sang Review bằng ph bandum review. Từ Review, người kiểm thử bấm Duyệt thì thành Approved rồi merge PR để sang Done, hoặc bấm Trả lại thì thành Rejected. Rejected quay về In progress bằng ph bandum fix.Todochưa có nhãn statusIn progressstatus: in progressReviewstatus: reviewRejectedstatus: rejectedApprovedstatus: approvedDoneissue đã đóngph bandum startph bandum reviewTrả lại trên web hoặc testph bandum fixDuyệtmerge PR

Vuốt ngang để xem hết sơ đồ.

Nhãn status do Bandum tự đặt ở mỗi lần chuyển, bạn không cần gắn tay. Task chưa có nhãn status là Todo, issue đã đóng là Done.

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.

Mỗi cột trên Board tương ứng một trạng thái trong bảng trên, và nhãn status trên issue quyết định task nằm cột nào.

Nhận task ​

bash
ph bandum start GH-12

Lệ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:

bash
ph bandum board              # task của sprint theo trạng thái
ph bandum board --mine       # chỉ task gán cho bạn

Là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:

bash
ph bandum check

Lệ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":

bash
git push -u origin HEAD
ph bandum pr GH-12

Chuyể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:

bash
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: review

ph 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:

bash
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ét

Khi 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.

Đọc thêm ​