Bộ phận mua hàng có một dự án Supplier Management (quản lý nhà cung cấp) trong Studio, và ứng dụng được xây trên NocoBase Core. Zhou Hang, trưởng bộ phận mua hàng, không viết mã. Lần này bộ phận muốn xếp hạng nhà cung cấp, nên Zhou Hang nêu yêu cầu sau:
Chấm điểm nhà cung cấp theo tỷ lệ giao hàng đúng hạn, tỷ lệ đạt chất lượng và giá, rồi xếp vào các hạng A, B và C. Đơn đặt hàng với nhà cung cấp hạng C cần trưởng phòng mua hàng duyệt trước khi gửi đi.
- Nêu yêu cầuZhou HangAgent của tôi
Giải thích quy tắc xếp hạng bằng ngôn ngữ nghiệp vụ và trả lời câu hỏi của Agent. Agent viết thành một issue kèm các kịch bản nghiệm thu.
- Phân côngAgent điều phối
Nhờ một Agent giỏi thiết kế viết kế hoạch trước, rồi giao phần phát triển cho một Agent giỏi xây dựng tính năng.
- Trả lờiZhou Hang
Kế hoạch phát hiện một quy tắc phê duyệt có sẵn, và Zhou Hang quyết định đơn nhỏ từ nhà cung cấp hạng C có cần duyệt không.
- Xây dựngAgent thực thi
Xây trên Core trong nhánh riêng của issue, viết test và mở PR.
- Kiểm tra và reviewCI của repositoryAgent thực thi
CI chạy các kiểm tra và test, sau đó một model của nhà cung cấp khác review mã.
- Nghiệm thuZhou Hang
Đọc báo cáo bàn giao, tiêu chí nghiệm thu và ảnh chụp màn hình, dùng thử trong preview rồi merge.
- Phát hànhTrưởng dự án
Sau khi merge, thay đổi lên staging. Production cần con người duyệt, và có thể rollback nếu có sự cố.
- Ghi nhớAgent thực thi
Ghi những gì học được vào bộ nhớ dự án, để Agent đọc trước lần làm việc sau.
Nêu yêu cầu
Zhou Hang mở My sessions và trao đổi với Agent của riêng mình. Agent trước hết xem module nhà cung cấp hiện có, rồi hỏi hai câu: mỗi tiêu chí trong ba tiêu chí chiếm bao nhiêu phần trong điểm, và nhà cung cấp mới chưa có lịch sử đơn hàng thì xếp hạng nào? Zhou Hang chốt cả hai ngay: giao hàng đúng hạn và tỷ lệ đạt mỗi tiêu chí 40%, giá 20%, còn nhà cung cấp mới bắt đầu ở hạng B và được xếp lại theo điểm sau ba tháng.
Agent viết các quy tắc này vào mô tả issue và các kịch bản nghiệm thu, rồi thêm issue vào dự án Supplier Management. Zhou Hang bấm Start 1 issue, và issue chuyển sang In progress.
Claude Code · MacBook của Zhou Hang · 10:08
Tôi đã xem qua. Dữ liệu nhà cung cấp nằm trong bảng suppliers , và phê duyệt đơn hàng có thể dùng workflow phê duyệt của nền tảng. Có hai điều cần chốt trước khi tôi tạo issue: mỗi tiêu chí trong ba tiêu chí chiếm bao nhiêu trong điểm số, và nhà cung cấp mới chưa có lịch sử đơn hàng thì vào hạng nào?
Claude Code · MacBook của Zhou Hang · 10:12
Đã rõ. Tôi đã đưa quy tắc chấm điểm và các kịch bản nghiệm thu vào một issue trong dự án Supplier Management:
Zhou Hang là người phụ trách issue, và Agent điều phối là người thực hiện. Phiên trò chuyện giữ issue và tiến độ của nó, nên Zhou Hang có thể quay lại bất cứ lúc nào để hỏi tình hình.
Zhou Hang cũng có thể bỏ qua cuộc trò chuyện và bấm New issue để điền trực tiếp một issue. Xem Nêu yêu cầu.
Phân công
Agent điều phối đọc mô tả issue, quy định Purchase Approval Policy (chính sách phê duyệt mua hàng) trong cơ sở tri thức, và các Skill của dự án. Thay đổi này đụng đến cấu trúc dữ liệu và phê duyệt, nên thay vì đi thẳng vào phát triển, nó nhờ một Agent giỏi thiết kế viết một kế hoạch ngắn trước.
@Claude · Opus 5.5 hãy viết một kế hoạch ngắn: field điểm nằm ở đâu, hạng được tính thế nào, và phê duyệt đơn hàng hạng C gắn vào workflow nào.
- Đọc: mô tả issue, bài “Purchase approval policy” trong cơ sở tri thức, Skill của dự án
- Xong khi: kế hoạch được đăng dưới dạng trả lời, liệt kê các câu hỏi để người phụ trách issue xác nhận
- Lý do: thay đổi đụng đến cấu trúc dữ liệu và phê duyệt, nên cần chốt kế hoạch trước khi làm
Kế hoạch đã sẵn sàng: thêm field điểm và hạng, tính lại hạng mỗi đêm theo quy tắc, và chuyển đơn hàng hạng C qua workflow phê duyệt của nền tảng. Cần xác nhận: Purchase Approval Policy chỉ yêu cầu trưởng phòng mua hàng duyệt đơn trên ¥50.000, còn yêu cầu không nói đơn nhỏ từ nhà cung cấp hạng C có cần duyệt không.
Agent điều phối phân công theo thế mạnh của từng Agent và không tự viết mã. Mỗi lúc chỉ một bước được sửa mã, còn review và điều tra chạy song song ở chế độ chỉ đọc.
Trả lời
Khi viết kế hoạch, Agent phát hiện Purchase Approval Policy đã có một quy tắc: đơn hàng trên ¥50.000 cần trưởng phòng mua hàng duyệt. Yêu cầu không nói đơn nhỏ từ nhà cung cấp hạng C có cần duyệt không, và đó là quyết định nghiệp vụ.
Agent điều phối chuyển issue sang Blocked và nêu rõ trong thẻ Needs you những gì Zhou Hang cần quyết định. Zhou Hang thấy nó trong mục Waiting for you ở My issues và bấm Reply: mọi đơn hàng với nhà cung cấp hạng C đều cần duyệt bất kể giá trị, còn các nhà cung cấp khác giữ quy tắc theo giá trị. Khi đã có câu trả lời, Agent điều phối giao phần phát triển cho một Agent giỏi xây dựng tính năng.
Chấm điểm và xếp hạng nhà cung cấp
Zhou Hang: hiện nay đơn hàng chỉ cần trưởng phòng mua hàng duyệt khi trên ¥50.000. Mọi đơn hàng từ nhà cung cấp hạng C có cần duyệt bất kể số tiền không, hay vẫn áp dụng quy tắc theo số tiền? Việc phát triển sẽ bắt đầu khi anh xác nhận.
Xem giải thích mới nhất của Agent điều phốiXây dựng
Agent thực thi làm việc trên một runtime, trong thư mục làm việc riêng của issue, trên nhánh mặc định tên agent/PUR-23. Nó dùng nguyên các khối xây dựng về dữ liệu, phân quyền và phê duyệt của Core, chỉ xây phần chấm điểm và xếp hạng nhà cung cấp, và viết test cho các kịch bản nghiệm thu. Sau khi commit, nó mở PR, và Studio tự động liên kết PR với issue.
Đầu trang issue luôn cho thấy công việc đang ở đâu: Agent nào đang làm, đã bao lâu, trên máy nào, và việc gì tiếp theo.
Chấm điểm và xếp hạng nhà cung cấp
- Now
- CXCodex · GPT-5.5 đang chạy “Hiện thực chấm điểm và xếp hạng theo kế hoạch” · 12 phút · Server 02
- Next
- Khi hiện thực xong, một Agent của nhà cung cấp khác sẽ review, rồi chuyển sang nghiệm thu.
Kiểm tra và review
CI của repository chạy các kiểm tra lint, kiểu, test và build. Khi một kiểm tra lỗi, Studio đánh thức Agent điều phối để sắp xếp sửa. Nếu kiểm tra vẫn lỗi sau ba lần sửa liên tiếp, người phụ trách issue được thông báo.
Khi các kiểm tra đạt, Agent điều phối nhờ một Agent của nhà cung cấp khác review mã. Nếu không có Agent nào như vậy trực tuyến, nó dùng một model khác của cùng nhà cung cấp. Model đã viết mã không bao giờ tự review mã của mình.
test · Agent điều phối đã được đánh thức để sắp xếp việc sửaĐã kiểm tra phân quyền, migration và test: đơn hàng hạng C đi qua phê duyệt của nền tảng, migration tự chứa, và mọi kịch bản nghiệm thu đều có test. Mã do Codex · GPT-5.5 viết, nên lần review này dùng nhà cung cấp khác.
Nghiệm thu
Khi PR đã qua kiểm tra và review, Agent điều phối chuyển issue sang In review và đính kèm báo cáo bàn giao: trước đây thế nào, hướng làm đã thống nhất, những gì thay đổi, đã kiểm tra ra sao, các vấn đề còn mở kèm đề xuất, và cuối cùng là tiêu chí nghiệm thu. Agent xây dựng đã đính kèm một ảnh chụp màn hình cho mỗi kịch bản nghiệm thu.
Chấm điểm và xếp hạng nhà cung cấp
- Up next
- Zhou Hang xem báo cáo bàn giao và nghiệm thu PR #31.
Zhou Hang: hãy xem báo cáo bàn giao và nghiệm thu phần xếp hạng nhà cung cấp. Nếu đạt, merge PR #31; nếu không, trả lại.
Trước đây thế nào
Nhà cung cấp chỉ có hồ sơ cơ bản, không có điểm hay hạng. Đơn hàng chỉ cần trưởng phòng mua hàng duyệt khi trên ¥50.000.
Đã thay đổi gì
- Nhà cung cấp giờ có điểm và hạng A, B hoặc C, được tính lại mỗi đêm theo tỷ lệ giao hàng đúng hạn, tỷ lệ đạt chất lượng và giá
- Mọi đơn hàng gửi nhà cung cấp hạng C giờ được chuyển cho trưởng phòng mua hàng duyệt khi gửi, bất kể số tiền. Các nhà cung cấp khác giữ quy tắc theo số tiền
- Nhà cung cấp mới bắt đầu ở hạng B và được xếp hạng lại sau ba tháng
Đã kiểm tra thế nào
Đã chạy qua cả ba kịch bản nghiệm thu trên preview. Mọi test và CI đều qua, và một model của nhà cung cấp khác đã duyệt review.
Vấn đề còn mở
- Nhà cung cấp hiện có chỉ có hạng sau lần tính lại ban đêm đầu tiên. Đề nghị chạy tay một lần vào ngày phát hành.
Tiêu chí nghiệm thu
- Danh sách nhà cung cấp hiển thị hạng của từng nhà cung cấp (ảnh 1)
- Đơn hàng ¥10.000 gửi nhà cung cấp hạng C được chuyển cho trưởng phòng mua hàng duyệt khi gửi (ảnh 2 và 3)
CI của dự án này triển khai một preview cho mỗi PR. Zhou Hang mở preview từ trang issue, đăng nhập bằng tài khoản quản trị đầu tiên, đặt một đơn ¥10.000 với nhà cung cấp hạng C, và xác nhận đơn được chuyển cho trưởng phòng mua hàng duyệt.
Mọi thứ đúng như mong đợi, nên Zhou Hang bấm Merge, và issue chuyển sang Done. Nếu có gì chưa ổn, Zhou Hang sẽ bấm Send back for changes và nói lý do, rồi Agent điều phối sắp xếp sửa và bàn giao lại.
Phát hành
Sau khi merge, CI của repository triển khai thay đổi lên staging, và issue cho biết thay đổi đã đến những môi trường nào.
Production được bảo vệ. Khi phát hành phiên bản mới, một yêu cầu triển khai đến hộp thư của người duyệt, kèm phiên bản cần triển khai, commit tạo ra nó và log CI. Trong dự án này người duyệt là trưởng dự án, và phiên bản chỉ lên production sau khi được duyệt. Nếu có sự cố, bạn có thể rollback về phiên bản trước.
Các issue đã xong nhưng chưa phát hành được liệt kê trong mục Merged, not released của dự án.
PR chỉ có preview, và các lần merge, phát hành chỉ được triển khai lên từng môi trường, sau khi CI của repository đã kết nối với Studio. Xem Kết nối CI.
Ghi nhớ
Issue giữ lại phần thảo luận, các quyết định, mã, test và mọi lượt chạy, còn mã nằm trong repository. Agent thực thi cũng ghi những gì học được vào bộ nhớ dự án, như quy tắc Zhou Hang đã xác nhận: mọi đơn hàng với nhà cung cấp hạng C đều cần trưởng phòng mua hàng duyệt, bất kể giá trị. Bộ nhớ dự án nằm trong repository và được review, merge cùng PR.
Lần sau khi Zhou Hang muốn điều chỉnh điều khoản thanh toán theo hạng, Agent đọc bộ nhớ dự án trước khi bắt đầu và dựa trên cơ sở tri thức cùng các test hiện có. Zhou Hang không phải giải thích lại bối cảnh, và nếu người khác tiếp quản, hay một Agent khác làm việc, họ có thể tiếp tục từ chỗ người trước dừng lại.
Zhou Hang đã làm gì
Zhou Hang nói rõ cần gì bằng ngôn ngữ nghiệp vụ, chốt quy tắc chấm điểm với Agent của mình, trả lời một câu hỏi trước khi phát triển, dùng thử thay đổi trong preview, rồi merge. Đội Agent viết kế hoạch, mã và test, và lo phần sửa lỗi lẫn review. Trong khi Agent làm việc, Zhou Hang có thể bổ sung yêu cầu bất cứ lúc nào bằng cách bình luận trên issue. Xem Theo dõi tiến độ.