Chuyển đến nội dung chính
Extension cho phép Review đọc ticket đứng sau một pull request (PR) hoặc merge request (MR): khi phần mô tả có liên kết tới Jira issue, trang Confluence, issue Linear hoặc Backlog, hay issue GitHub hoặc GitLab, reviewer sẽ lấy nội dung đó về và kiểm tra code có làm đúng điều ticket yêu cầu hay không. Không có extension, Review chỉ đánh giá riêng diff và không thể báo cho bạn biết một tiêu chí chấp nhận đã bị bỏ sót.

Extension hiện có

GitHub Issues chỉ xuất hiện khi Review provider của bạn là GitHub, và GitLab Issues chỉ xuất hiện khi provider là GitLab. Chưa hỗ trợ: Jira và Confluence bản Data Center hoặc Server (kết nối Atlassian chỉ hoạt động với Atlassian Cloud), và Azure Boards, vốn chưa có extension. Với các công cụ này, hãy dán tiêu chí chấp nhận vào phần mô tả PR: Review đọc phần mô tả cùng với thay đổi.

Điều kiện tiên quyết

  • Review đã kết nối với ít nhất một repository. Xem Thiết lập Review.
  • Để kết nối một công cụ quản lý ticket: vai trò Admin của workspace và quyền truy cập More → Workspace settings → Connections. Các vai trò khác thấy nút View thay cho Connect trên các ô. Xem vai trò.
  • Một tài khoản trên công cụ quản lý ticket có quyền đọc các project chứa ticket của bạn.

Bật extension

1

Mở mục Extensions

Vào Review → Settings và cuộn tới Extensions (“Link tickets and specs so Review can check changes against them”). Mỗi công cụ quản lý ticket có một ô hiển thị trạng thái.
2

Kết nối công cụ quản lý ticket

Nhấn Connect trên ô. CloudThinker mở More → Workspace settings → Connections với biểu mẫu của kết nối đó đã sẵn sàng. Điền biểu mẫu theo hướng dẫn kết nối Atlassian, Linear hoặc Backlog, rồi lưu.Trạng thái thành công: quay lại Review → Settings → Extensions, ô hiển thị Connected.
3

Tham chiếu ticket trong phần mô tả PR

Đặt liên kết hoặc mã ticket vào phần mô tả PR hoặc MR. Không cần lệnh hay cài đặt nào.Mã ticket của Jira, Linear và Backlog trông giống nhau. Khi chỉ kết nối một trong ba, mã trần như OPS-1234 sẽ được tra trên công cụ đó. Khi kết nối nhiều hơn một, reviewer phải thử từng công cụ, và một mã tồn tại ở cả hai nơi có thể khớp nhầm ticket.
Khi kết nối nhiều hơn một công cụ dùng mã ticket, hãy luôn dùng URL đầy đủ của ticket.
4

Mở PR và đọc kết quả review

Review chạy như bình thường. Giờ đây phát hiện bao gồm cả những chỗ thay đổi chưa đáp ứng ticket, bên cạnh vấn đề trong chính code.Trạng thái thành công: khi thay đổi bỏ sót một phần của ticket, phát hiện của review nêu rõ phần nào.
Nhấn Manage trên ô đã kết nối, hoặc View trên các ô khác, để xem extension đó đọc gì và nhận diện những mẫu nào. Extension luôn bật khi workspace có kết nối tương ứng, kể cả kết nối ban đầu được tạo cho chat hoặc cho agent khác. Extension áp dụng cho mọi repository mà Review phụ trách. Không có công tắc riêng hay cài đặt theo từng repository.
Để Review ngừng đọc một công cụ quản lý ticket, bạn phải ngắt kết nối công cụ đó trong More → Workspace settings → Connections. Thao tác này gỡ kết nối khỏi mọi agent và mọi cuộc chat trong workspace, không chỉ riêng Review.

Ví dụ

Một phần mô tả PR như sau:
Giả sử OPS-1234 có tiêu chí chấp nhận “return 429 with a Retry-After header”, còn diff trả về 429 mà không kèm header. Với extension Jira, reviewer có sẵn tiêu chí đó và có thể đánh dấu header bị thiếu theo ticket, ví dụ: “The login endpoint returns 429 without the Retry-After header that OPS-1234 requires.” Không có extension, cùng diff đó trông hoàn toàn đúng. Trong review workspace, thẻ Ticket compliance còn chấm thay đổi là Fully compliant, Partially compliant hoặc Not compliant so với ticket. Thẻ hoạt động ở mọi chế độ review và hiển thị khi đúng một ticket Jira hoặc Linear được kiểm tra. Khi có nhiều ticket, hoặc là ticket Backlog hay issue Git, bình luận tóm tắt review sẽ dùng một bảng thay thế, mỗi ticket một kết luận.

Review đọc những gì

  • Chỉ phần mô tả. Review quét phần mô tả PR hoặc MR để tìm liên kết và mã ticket.
  • Không đọc trong code. Mã ticket nằm trong code block hoặc inline code (`OPS-1234`) bị bỏ qua, nên các ID ví dụ trong snippet không kích hoạt tra cứu.
  • Tối đa 20 tham chiếu mỗi PR, lấy từ 65.535 ký tự đầu tiên của phần mô tả. Hãy đặt ticket quan trọng nhất lên đầu.
  • Ticket mà kết nối của bạn xem được. Review đọc bằng quyền truy cập của tài khoản đã kết nối, nên ticket trong project mà tài khoản đó không mở được sẽ không có trong review.
  • Hiển thị cho workspace của bạn. Nội dung reviewer lấy từ ticket có thể xuất hiện trong phát hiện. Các phát hiện này hiện trong bình luận review trên PR và với bất kỳ ai có quyền truy cập Review trong workspace. Với repository công khai, ai xem được PR cũng đọc được các bình luận đó, nên đừng đưa chi tiết mật vào ticket bạn liên kết ở đó. Xem bảo vệ dữ liệu.

Viết ticket giúp review hiệu quả

  • Liệt kê từng tiêu chí chấp nhận trên một dòng riêng. Mỗi tiêu chí trở thành một điểm reviewer kiểm tra được. “Chạy tốt” thì không kiểm tra được; “trả về 429 sau 5 lần thử sai trong 1 phút” thì được.
  • Liên kết cả đặc tả, không chỉ ticket. Một trang Confluence chứa hợp đồng API cho reviewer biết chính xác tên trường và mã trạng thái.
  • Tham chiếu mọi ticket mà PR đóng. PR sửa hai bug thì nên nêu cả hai.

Khắc phục sự cố

Kiểm tra: tham chiếu nằm trong phần mô tả, không chỉ ở tên nhánh hay commit message, và không nằm trong dấu backtick hay code block. Xác nhận ô hiển thị Connected.Cách sửa: sửa phần mô tả, rồi bình luận @cloudthinker-ai review trên PR để review chạy lại và đọc phần mô tả mới. Trên AWS CodeCommit, hãy push một commit mới lên nhánh nguồn của PR thay vào đó. Xem lệnh mention.
Các ô này chỉ xuất hiện với Review provider tương ứng. Trên Bitbucket, Azure DevOps hoặc AWS CodeCommit, hãy dùng Jira, Linear hoặc Backlog.
Chỉ Admin của workspace mới kết nối được công cụ quản lý ticket. Hãy nhờ Admin của workspace kết nối, hoặc đổi vai trò cho bạn. Xem vai trò.
Tài khoản đã kết nối không mở được project chứa ticket đó. Hãy cấp quyền cho tài khoản trong công cụ quản lý ticket, hoặc kết nối lại bằng tài khoản có quyền.

Bước tiếp theo

Lệnh mention

Chạy lại review sau khi bạn cập nhật phần mô tả PR.

Learnings

Đưa quy ước code của nhóm bạn vào mọi lượt review.