Điều kiện tiên quyết
- Ít nhất một repository đã được kết nối trong Thiết lập Review, với một MR/PR đã được review.
- Một vai trò workspace phù hợp với việc bạn muốn làm (xem Vai trò):
Quy tắc bảo vệ nhánh và phê duyệt của provider vẫn áp dụng cho mọi thao tác bạn làm ở đây. Lệnh push hoặc merge mà provider từ chối cũng thất bại trong CloudThinker.
Các vai trò này chỉ áp dụng bên trong CloudThinker. Lệnh bình luận trên provider tuân theo quyền bình luận của provider: bất kỳ ai có quyền bình luận đều chạy được
@cloudthinker-ai autofix. Xem cảnh báo về autofix.Phân loại danh sách Reviews
1
Mở danh sách
Vào Review → Reviews. Mọi MR/PR mà CloudThinker theo dõi nằm ở một trong bốn tab, mỗi tab có bộ đếm cập nhật trực tiếp.
2
Thu hẹp danh sách
Lọc bằng Search title or number…, repository, tác giả hoặc verdict. Dùng nút mật độ để chuyển giữa hàng Comfortable và Compact. Bộ lọc vẫn được giữ khi bạn chuyển tab.Trạng thái thành công: bộ đếm của các tab khớp với bộ lọc, và mỗi hàng hiển thị tiêu đề, tác giả, repository, verdict và số phát hiện còn chưa giải quyết.
Huy hiệu Conflict màu đỏ cạnh tiêu đề nghĩa là provider báo MR/PR không merge được vì các nhánh xung đột. Khi CloudThinker đã mở bản sửa cho MR/PR đó, hàng đó cũng liên kết đến Resolution MR (hoặc Resolution PR). Xem Tự động giải quyết xung đột.
Đọc một review
Nhấn vào một hàng để mở review. Trang có các tab sau:
Nơi xem các lượt chạy CI tùy thuộc vào provider:
Thanh bên cạnh các tab hiển thị Review summary: verdict, số phát hiện chưa giải quyết theo mức độ nghiêm trọng và danh mục, cùng các Learnings mà lượt review đã trích dẫn. Bên dưới, Rate this review cho phép chấm từ 1 đến 5 sao.
Nếu một extension tìm thấy ticket được liên kết, thẻ Ticket compliance đánh giá thay đổi là Fully compliant, Partially compliant hoặc Not compliant so với ticket, kèm ghi chú của agent.
Xử lý các phát hiện
1
Mở một phát hiện
Trên tab Findings, mở rộng một thẻ. Bạn sẽ thấy mức độ nghiêm trọng, tệp và dòng, giải thích của agent, mã gốc và bản sửa đề xuất, cùng chip của Learning mà phát hiện dựa vào (nếu có).
2
Bình chọn độ chính xác
Nhấn thumbs-up nếu phát hiện đúng. Nhấn thumbs-down nếu sai, và mô tả điểm sai trong ghi chú Inaccurate finding. Ghi chú được lưu theo repository: các lượt review sau của repository đó nhận 20 ghi chú mới nhất trong 90 ngày gần nhất, để không nêu lại cùng vấn đề trên mã không thay đổi. Cơ chế này tách biệt với Learnings.
3
Sửa lỗi
Chọn cách phù hợp:
Apply fix thất bại khi provider không cho danh tính đã kết nối push vào nhánh nguồn, ví dụ nhánh được bảo vệ hoặc MR/PR mở từ một fork. Khi đó thẻ hiển thị This branch can’t be updated automatically. Hãy dùng Copy prompt trong trường hợp này. Trên GitLab, token Maintainer có thể push vào nhánh được bảo vệ (xem xác thực provider).Apply fix không có trên Bitbucket, nhưng Fix all findings thì có.
4
Kết thúc phát hiện
Nhấn Mark resolved khi đã xử lý xong, hoặc Reopen để hoàn tác. Trên GitHub, GitLab, Bitbucket và Azure DevOps, thao tác resolve cũng resolve luồng bình luận tương ứng trên provider. Trên AWS CodeCommit, phát hiện chỉ được kết thúc trong CloudThinker.Trạng thái thành công: thẻ chuyển sang nhóm Resolved, và số phát hiện chưa giải quyết trên danh sách Reviews giảm xuống.
Hỏi về toàn bộ review
Nhấn Ask CloudThinker ở phần đầu trang. Một ngăn chat mở bên cạnh review, giới hạn trong MR/PR này và tách biệt với lượt review của chính agent. Hãy thử:Chạy lại, sửa và merge
Các nút ở phần đầu trang bao gồm những hành động thay đổi MR/PR. Các hành động ít dùng hơn nằm trong menu More actions (⋯).Merge cần tài khoản GitHub hoặc GitLab của riêng bạn đã được liên kết. CloudThinker yêu cầu bạn liên kết lần đầu tiên bạn nhấn Merge, hoặc bạn có thể làm trước trong Account Settings → Linked accounts: nhấn Link GitHub account hoặc Link GitLab account. Liên kết GitLab yêu cầu scope
api; liên kết GitHub là một ủy quyền người dùng GitHub App.
Khi nhấn Merge, hãy chọn phương thức merge (Create a merge commit, Squash and merge hoặc Rebase and merge, tùy repository cho phép) và chọn có Delete source branch hay không. Nếu lượt review yêu cầu thay đổi, một lượt review vẫn đang chạy, hoặc các commit mới nhất chưa được review, cảnh báo Check before you merge sẽ xuất hiện và nút chuyển thành Merge anyway.
Khắc phục sự cố
Apply fix thất bại
Apply fix thất bại
Nguyên nhân: mã đã thay đổi sau lượt review, nên các dòng gốc không còn hoặc xuất hiện nhiều lần, hoặc nhánh nguồn được bảo vệ hay nằm trong một fork. Cách sửa: chạy lại review để có bản sửa dựa trên mã hiện tại, hoặc áp dụng thay đổi qua Git provider.
Tôi không thấy Fix all findings, Re-run review hoặc Mark resolved
Tôi không thấy Fix all findings, Re-run review hoặc Mark resolved
Nguyên nhân: vai trò workspace của bạn là Viewer. Cách sửa: đề nghị Admin của workspace cấp vai trò Developer.
Không thấy Fix all findings dù tôi là Developer
Không thấy Fix all findings dù tôi là Developer
Nguyên nhân: MR/PR không còn phát hiện chưa giải quyết nào để sửa, hoặc repository nằm trên AWS CodeCommit, nơi không hỗ trợ tính năng này. Cách sửa: kiểm tra tab Findings để xác nhận mọi thứ đã được resolve. Trên CodeCommit, dùng Copy prompt cho từng phát hiện.
Re-run review bị mờ
Re-run review bị mờ
Kiểm tra: lý do bên dưới mục menu. Lượt review đang chạy phải hoàn tất hoặc bị dừng trước. Với MR/PR đã merge, mục này vẫn hiển thị nhưng bị vô hiệu hóa.
Không thấy MR/PR mà tôi cần trong danh sách
Không thấy MR/PR mà tôi cần trong danh sách
Kiểm tra: tab All sau khi xóa bộ lọc. Nếu vẫn không thấy, xác nhận repository đã được bật và webhook đã được thiết lập trong Thiết lập Review. MR/PR dạng draft không được review.
Bước tiếp theo
Lệnh mention
Chạy cùng các hành động từ bình luận MR/PR trên provider của bạn.
Learnings
Biến các phát hiện đã thống nhất của nhóm thành quy tắc repository.