Xem xét pull request đầu tiên của bạn

Những gì bạn sẽ xây dựng

Khi kết thúc hướng dẫn này, bạn sẽ:

• Mở một pull request trong bàn làm việc PR của Control Center
• Đọc diff của PR và để lại một bình luận nội tuyến
• Gửi một kết luận đánh giá
• Hợp nhất PR

Điều kiện tiên quyết: đã hoàn thành Điều phối agent đầu tiên và có một pull request đang mở trên một kho mã đã đăng ký trong không gian làm việc này. Với các bước xem xét, hãy chọn một PR bạn không phải người mở — nút Đánh giá bị ẩn trên PR của chính bạn. Hợp nhất vẫn hoạt động trên PR do bạn tạo.

Bước 1: Mở pull request

1. Nhấp vào Pull requests trên thanh bên
2. Tìm PR của bạn và nhấp vào đó

Điểm kiểm tra. PR mở ra dưới dạng một bàn làm việc có nhiều tab — Tổng quan, Diff, Kiểm soát mã nguồn, Chat, Hành động — tập trung vào tab Tổng quan: tiêu đề và các hành động, phần mô tả cùng dòng thời gian hoạt động, và một thanh bên hiển thị trạng thái, người đánh giá, người được giao, các kiểm tra và các tệp đã thay đổi. Nhấp vào một tệp ở đó sẽ nhảy tới tệp đó trong tab Diff. Tab Review PR không mở sẵn cho đến khi có ai đó yêu cầu đánh giá bằng AI.

Hàng đợi trống kèm lời nhắc “kết nối GitHub”

Trạng thái đó nghĩa là máy chủ không giữ token GitHub nào — máy khách của bạn không bao giờ giữ token. Hãy đặt một token trong Cài đặt → Không gian làm việc → Hồ sơ & danh tính → Lưu trữ mã, rồi làm mới danh sách.

Bước 2: Đọc diff

Mở tab Diff. Một cây tệp có thể thu gọn nằm bên trái, và dải phía trên diff có bộ chọn khoảng commit — thu hẹp diff về một commit hoặc một loạt commit — cùng số lượng tệp và số dòng thêm vào, xóa đi đang được đếm.

Nút cài đặt trên thanh công cụ của diff điều khiển cách hiển thị:

• Chế độ xem Chia hoặc Gộp
• Ngắt dòng hoặc cuộn các dòng dài
• Chữ ghép phông mã

Đánh dấu một tệp là đã xem để theo dõi tiến độ của bạn qua một diff lớn. Điều hướng bằng bàn phím có trong Phím tắt.

Bước 3: Để lại bình luận nội tuyến

1. Di chuột qua một dòng trong diff — một nút + nhỏ hiện ra ở lề
2. Nhấp vào nút đó để bình luận trên dòng ấy, hoặc kéo nút theo chiều dọc trước để chọn một đoạn
3. Nhập phản hồi của bạn. Trình soạn đưa ra hai cách gửi:
   • Bắt đầu review (hoặc Thêm vào review nếu đang có một lượt đánh giá dở dang) sẽ xếp hàng bình luận. Luồng bình luận hiển thị Review đang chờ cho đến khi bạn gửi kết luận ở bước 4.
   • Thêm bình luận đơn đăng bình luận lên GitHub ngay lập tức. Luồng bình luận hiển thị Đang đăng…, rồi Đã đồng bộ, và cho phép thử lại nếu việc đăng thất bại.

Trong hướng dẫn này, hãy dùng Bắt đầu review để bình luận được gửi đi kèm với kết luận.

Bình luận đang xếp hàng thì chưa có trên GitHub

Bắt đầu review / Thêm vào review giữ bình luận lại tại máy của bạn cho đến khi bạn gửi kết luận. Chỉ Thêm bình luận đơn mới đăng ngay lập tức. Phần nội dung đánh giá bạn viết ở bước 4 là một bản nháp riêng.

Bước 4: Gửi đánh giá

1. Nhấp vào Đánh giá trong hàng hành động ở tab Tổng quan — nút này cũng nằm trên thanh công cụ của tab Diff. Nút bị ẩn trên PR do bạn tạo và trên PR đã đóng hoặc đã merge.
2. Viết phần tóm tắt trong trình soạn. Nội dung tự động lưu thành bản nháp, nên bạn có thể đóng lớp phủ rồi quay lại.
3. Chọn một kết luận:
   • Yêu cầu thay đổi
   • Bình luận
   • Phê duyệt

Kết luận chính là nút bấm. Sau khi chọn Phê duyệt hoặc Yêu cầu thay đổi, nút tự đổi nhãn thành Đã phê duyệt hoặc Thay đổi được yêu cầu. Kết luận Bình luận để nguyên nhãn Đánh giá.

Điểm kiểm tra. Nút hiển thị “Đã phê duyệt” hoặc “Thay đổi được yêu cầu” nếu bạn chọn một trong hai mục đó.

Bước 5: Hợp nhất

Nút Hợp nhất luôn xuất hiện khi GitHub báo PR có thể hợp nhất — nút không phụ thuộc vào việc bạn đã phê duyệt hay chưa. Màu của nút thể hiện mức sẵn sàng chứ không phải quyền: màu chính khi các phê duyệt bắt buộc và các kiểm tra đều xanh, màu phụ khi một kiểm tra vẫn đang chạy, màu nguy hiểm khi người đánh giá được chỉ định chưa phê duyệt hoặc một kiểm tra đang thất bại.

1. Nhấp vào Hợp nhất
2. Chọn một phương thức: Squash and merge, Tạo merge commit hoặc Rebase and merge
3. Với hai phương thức đầu, hãy sửa tiêu đề và nội dung commit đã được điền sẵn
4. Xác nhận

Mọi vấn đề còn tồn đọng — “Checks thất bại”, “Một số review đang chờ” — đều được liệt kê trong bảng trượt trước khi bạn xác nhận.

Hợp nhất là thao tác không thể hoàn tác

Hợp nhất sẽ đẩy các commit lên GitHub. Thao tác này không bao giờ vào ngăn xếp hoàn tác của Control Center và không thể hoàn tác từ đây.

Sau khi hợp nhất, một sự kiện miền PrMerged được phát ra; analytics và thông báo tiêu thụ sự kiện đó. Xem Sự kiện miền để biết còn những gì lắng nghe sự kiện này.

Đánh giá bằng AI

Control Center có thể gắn một quy trình người đánh giá vào một PR đang mở, nhưng chỉ khi bạn yêu cầu: mẫu pr_review chỉ có trình kích hoạt thủ công và không có gì khác.

1. Mở menu tràn trong hàng hành động ở tab Tổng quan và chọn Hỏi AI. Control Center bắt đầu lượt chạy và mở tab Review PR, để bạn theo dõi các chuyên gia làm việc.
2. Các agent đánh giá ghi lại phát hiện của mình dưới dạng nút đánh giá trong space của PR; bước cuối cùng hợp nhất chúng thành một báo cáo.

Quy trình cố ý không đăng lên GitHub — nó kết thúc sau khi hợp nhất. Việc xuất bản là một bước riêng do bạn tự thực hiện, bằng nút Xuất bản lên GitHub trên tab Review PR. Xem Dùng đánh giá hỗ trợ AI.

Tóm tắt

Bạn đã mở một PR trong bàn làm việc, đọc diff với tô sáng cú pháp, để lại một bình luận nội tuyến, gửi một kết luận và hợp nhất — mà không cần rời khỏi ứng dụng.

Tiếp theo: Xây dựng quy trình đầu tiên để tự động hóa các quy trình nhiều bước.