@cloudthinker-ai trong bình luận của merge request hoặc pull request (MR/PR) để chạy lại review, sửa các phát hiện của review, hoặc hỏi về thay đổi, mà không cần rời Git provider của bạn. Một phát hiện là một vấn đề mà review đánh dấu để người xem xét.
Điều kiện tiên quyết
- Một MR/PR đang mở trong repository đã kết nối ở thiết lập Review.
- Quyền bình luận trên MR/PR đó trong Git provider của bạn.
Lệnh
Viết lệnh dưới dạng văn bản thường, nằm riêng trên một dòng trong bình luận. Gõ chính xác@cloudthinker-ai, bất kể bot user của bạn tên là gì. Tính năng tự hoàn thành của provider có thể không gợi ý tên này, điều đó không sao.
review và review ultra phải chiếm trọn dòng. @cloudthinker-ai review this carefully được xử lý như một câu hỏi, không phải lệnh. Lời nhắc nằm trong code block, inline code hoặc phần trích dẫn trả lời cũng không bao giờ được chạy như lệnh.
Chạy lệnh
1
Mở MR/PR trên provider của bạn
Dùng MR/PR trên GitHub, GitLab, Bitbucket, Azure DevOps hoặc AWS CodeCommit mà CloudThinker đã review.
2
Đăng lệnh dưới dạng bình luận mới
Ví dụ, để chạy lại một lượt review đã dừng giữa chừng:Trạng thái thành công: bot trả lời CloudThinker Review Started. Khi lượt chạy kết thúc, một bình luận tóm tắt review mới xuất hiện trên MR/PR.
@cloudthinker-ai review để tiếp tục từ commit được review gần nhất. Trên AWS CodeCommit, hãy đẩy một commit mới lên nhánh nguồn.
Đặt câu hỏi
Nhắc bot, theo sau là câu hỏi của bạn:
Câu hỏi tiếp theo trong cùng luồng sẽ dựa trên các câu trả lời trước.
Phản bác một phát hiện
Nếu bạn là tác giả hoặc người được phân công MR/PR và cho rằng một phát hiện sai, hãy trả lời trong luồng của phát hiện đó. Không cần nhắc bot. Giải thích lý do, ví dụ:
Bạn có thể phản bác sau khi review đã kết thúc, trên mọi provider trừ AWS CodeCommit. Người khác vẫn có thể hỏi về một phát hiện bằng cách nhắc bot, nhưng câu trả lời của họ không chốt được phát hiện.
Sửa phát hiện bằng autofix
Chọn cách bạn muốn nhận các bản sửa:1
Đăng lệnh dưới dạng bình luận cấp cao nhất
2
Chờ lượt chạy sửa lỗi
CloudThinker đọc từng phát hiện chưa giải quyết, dù phát hiện đó có bản sửa đề xuất hay không, rồi sửa code, commit và đẩy lên. Mỗi MR/PR chỉ chạy một autofix tại một thời điểm. Yêu cầu thứ hai gửi khi autofix đang chạy sẽ không khởi động thêm lượt nào.CloudThinker không chạy test của bạn. CloudThinker bỏ qua phát hiện cần quyết định kiến trúc hoặc không có cách sửa rõ ràng. Lượt chạy sửa lỗi là một lượt chạy agent và tiêu tốn credit.Trạng thái thành công: một commit có tiêu đề
fix: autofix findings from code review of ... xuất hiện trên nhánh nguồn của bạn, hoặc một MR/PR mới được mở nhắm vào nhánh đó. Commit message liệt kê từng bản sửa dưới Fixed:, và từng phát hiện bị bỏ qua kèm lý do dưới Skipped:.@cloudthinker-ai autofix như một câu trả lời trong luồng của một phát hiện. Khi đó CloudThinker chỉ sửa phát hiện đó.
Bỏ qua review
Đặt dòng sau ở bất kỳ đâu trong phần mô tả MR/PR để CloudThinker không review MR/PR đó:Chạy Ultra review
Ultra là lượt review sâu hơn, chậm hơn và tốn nhiều credit hơn review thường. Ultra chạy code để kiểm chứng từng phát hiện trước khi đăng, và mất khoảng 10 phút. Ultra chỉ khả dụng khi Ultra review được bật cho instance CloudThinker của bạn. Đây không phải cài đặt workspace, nên không có công tắc nào trong Review → Settings.- Một lần: bình luận
@cloudthinker-ai review ultra. Chỉ tác giả hoặc người được phân công MR/PR mới khởi động được theo cách này. Lần đẩy tiếp theo sẽ nhận review thường.
Hỗ trợ theo provider
- Chỉ đọc câu trả lời của tác giả hoặc người được phân công MR/PR trong luồng của một phát hiện. Câu trả lời trong luồng của người khác, kể cả câu hỏi, không được phản hồi; họ có thể hỏi bằng bình luận cấp cao nhất.
- Chỉ bình luận cấp cao nhất, không dùng được trong luồng của một phát hiện.
review bao gồm cả review ultra. Trên AWS CodeCommit, review tự động vẫn chạy ở mỗi PR mới và mỗi lần đẩy lên nhánh nguồn của PR. Các lệnh bình luận review và autofix không được hỗ trợ ở đó, nên hãy đẩy một commit mới để review lại PR trên CodeCommit.
Lệnh mà provider của bạn không hỗ trợ sẽ bị bỏ qua, không có phản hồi.
Khắc phục sự cố
Bot không trả lời bình luận của tôi
Bot không trả lời bình luận của tôi
Kiểm tra:
- Lời nhắc là văn bản thường, không nằm trong backtick, code block hay phần trích dẫn.
- Provider của bạn hỗ trợ lệnh đó theo bảng ở trên.
- Trên Azure DevOps, đã có service hook Pull request commented on với Resource version đặt là 2.0, như mô tả trong Provider authentication.
- Lịch sử gửi webhook của provider cho thấy sự kiện bình luận đã được gửi và chấp nhận.
Lệnh của tôi được trả lời như một câu hỏi
Lệnh của tôi được trả lời như một câu hỏi
Nguyên nhân:
review và review ultra phải chiếm trọn dòng. Cách sửa: đăng @cloudthinker-ai review mà không có gì phía sau.Ultra review không khởi động từ bình luận
Ultra review không khởi động từ bình luận
Nguyên nhân: chỉ tác giả hoặc người được phân công MR/PR mới khởi động được Ultra từ bình luận, hoặc workspace của bạn chưa có Ultra review (beta). Cách sửa: nhờ tác giả bình luận.
Câu trả lời của tôi trong luồng phát hiện không chốt được phát hiện
Câu trả lời của tôi trong luồng phát hiện không chốt được phát hiện
Nguyên nhân: chỉ tác giả hoặc người được phân công MR/PR mới chốt được phát hiện bằng câu trả lời, và chỉ sau khi review đã kết thúc. Cách sửa: nhờ tác giả trả lời, hoặc đánh dấu đã giải quyết trong Review workspace.
Bước tiếp theo
Review workspace
Chạy các thao tác tương tự, cùng với merge, ngay trong CloudThinker.
Learnings
Xem các quy tắc CloudThinker học được từ những phát hiện đã chốt của nhóm bạn.