Chuyển đến nội dung chính
Review đăng các phát hiện lên merge request và pull request (MR/PR) của bạn, đồng thời lưu bản sao của mọi lượt review tại Review → Reviews trong CloudThinker. Từ đó bạn có thể xem việc gì cần bạn xử lý, giải quyết từng phát hiện, commit bản sửa và merge (trên GitHub hoặc GitLab), tất cả tại một nơi.

Đ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.
Verdict là kết luận tổng thể của lượt review về MR/PR. Phát hiện (finding) là một vấn đề mà lượt review gắn cờ để con người xem xé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ử:
Ngăn chat giữ repository và phát hiện mà bạn mở chat từ đó làm ngữ cảnh cố định, để câu trả lời bám sát review này. Mỗi câu hỏi tiêu tốn credit như mọi tin nhắn chat.

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.
Fix all findings push commit vào nhánh nguồn mà không có bước phê duyệt riêng. Trên GitHub hoặc GitLab, hãy bình luận @cloudthinker-ai autofix stacked để nhận bản sửa trong một MR/PR riêng trước.

Khắc phục sự cố

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