Tối Ưu Hóa Quy Trình Duyệt PR Với Trợ Lý AI Tự Chủ Sử Dụng Antigravity SDK của Google

Trong bối cảnh phát triển công nghệ AI liên tục biến đổi, Google đã công bố một bản cập nhật quan trọng vào ngày 18 tháng 6 năm 2026, về việc ngừng hỗ trợ Gemini CLI và các tiện ích mở rộng Gemini Code Assist IDE cho Google AI Pro, Ultra, cũng như người dùng miễn phí cá nhân. Đây là một phần trong nỗ lực của Google nhằm hợp nhất các công cụ terminal AI của mình, chuyển đổi Gemini CLI hướng cộng đồng thành Antigravity CLI – một nền tảng mới ưu tiên tác tử (agent-first) được xây dựng cho các quy trình công việc phức tạp, đa tác tử. Sự chuyển đổi này đặt ra một yêu cầu cấp thiết cho các nhóm phát triển đang phụ thuộc vào Gemini CLI để quản lý kho lưu trữ và tự động hóa các tác vụ: cần phải thiết lập một lộ trình di chuyển rõ ràng.

Bài viết này sẽ hướng dẫn bạn cách chuyển đổi một cách liền mạch bằng cách xây dựng một hệ thống đánh giá yêu cầu kéo (Pull Request – PR) tự động, thực hiện “lượt kiểm tra đầu tiên” (first-pass) bằng cách sử dụng Antigravity SDK của Googlerun-agy-sdk, một GitHub Action tổng hợp. Giải pháp này không chỉ giúp bạn thích nghi với công cụ mới mà còn tối ưu hóa đáng kể quy trình làm việc của đội ngũ kỹ thuật.

“Thuế Điều Phối” – Gánh Nặng Quá Tải Nhận Thức Trong Phát Triển Hiện Đại

Giải pháp mà chúng tôi đề xuất còn giải quyết một vấn đề cấp bách khác mà các nhóm kỹ thuật hiện đại đang phải đối mặt: tình trạng quá tải nhận thức. Như Addy Osmani gần đây đã chỉ ra, có một “thuế điều phối” (orchestration tax) khi sử dụng AI để viết mã. Thời gian mà các nhà phát triển tiết kiệm được nhờ việc tạo mã bằng AI thường bị đẩy sang cho người đánh giá dưới dạng các PR lớn, phức tạp, gây ra việc chuyển đổi ngữ cảnh liên tục và mệt mỏi về mặt nhận thức.

Bằng cách giao phó việc tìm kiếm “lượt kiểm tra đầu tiên” tẻ nhạt cho một tác tử Antigravity, các nhà đánh giá con người có thể giảm nhẹ gánh nặng này và tập trung vào kiến trúc cấp cao cũng như đảm bảo chất lượng tổng thể của dự án. Điều này giúp nâng cao hiệu suất làm việc và giảm thiểu sai sót do con người gây ra.

Tại Sao Chúng Ta Cần Duyệt Mã Tự Động Bằng Trợ Lý AI Tự Chủ?

Mã do AI tạo ra có thể tốt một cách đáng kinh ngạc. Nó thường sạch sẽ, được tài liệu hóa tốt và đúng cú pháp, khiến người đánh giá khó phát hiện các lỗi logic tinh vi hoặc lỗ hổng bảo mật không dễ nhận thấy ngay lập tức. Trong một cơ sở mã lớn, việc xác minh thủ công mọi thay đổi là điều không khả thi. Đây là lý do tại sao chúng ta cần các tác tử tự động có thể đi sâu vào cơ sở mã và phân tích nó từ một góc nhìn mới mẻ.

Tuy nhiên, một câu hỏi đặt ra là: Nếu một nhà phát triển đã sử dụng LLM để tạo mã, làm thế nào chúng ta có thể tin tưởng một AI khác để tìm lỗi? Câu trả lời nằm ở kiến trúc tác tử và sự tách biệt ngữ cảnh.

Các nhà phát triển có thể viết mã bằng bất kỳ công cụ nào – cho dù đó là CLI, tiện ích mở rộng IDE, hoặc các mô hình khác nhau như Gemini 3.5 Flash hay Gemini 3.1 Pro. Tuy nhiên, tác tử đánh giá là một Antigravity Agent được quản lý, chạy thông qua một tích hợp SDK riêng biệt. Tác tử này có một “persona” chuyên biệt, ít tự do và các hướng dẫn hệ thống nghiêm ngặt, buộc nó phải hoạt động như một kiểm toán viên mã đối kháng (adversarial code auditor) chứ không phải một nhà phát triển. Hơn nữa, nó hoạt động trong một môi trường cô lập. Bởi vì nó có một lời nhắc hệ thống, các rào chắn an toàn và ranh giới ngữ cảnh khác biệt, tác tử sẽ xem xét các thay đổi với một góc nhìn hoàn toàn mới, phát hiện các lỗi logic và lỗ hổng mà trình tạo mã ban đầu có thể bỏ sót.

Kiến Trúc Pipeline Duyệt Mã Tự Động Bằng Antigravity Agent

Để minh họa thực tế, chúng tôi đã tạo ra một pipeline đánh giá bằng tác tử với các tính năng sau:

  1. Tận dụng một Antigravity Agent được quản lý được cấu hình qua SDK để đánh giá mã. Tác tử sử dụng khả năng suy luận nâng cao để khám phá các tệp và xác minh logic theo các hướng dẫn nghiêm ngặt.
  2. Chạy các đánh giá trong các không gian làm việc hoặc sandbox cô lập với các chính sách tùy chỉnh để ngăn chặn rủi ro thực thi shell hoặc mã tùy ý.
  3. Cho phép tác tử sử dụng máy chủ GitHub MCP để tương tác trực tiếp với môi trường, viết nhận xét và đánh giá yêu cầu kéo.
  4. Tránh sử dụng trigger synchronize trong các quy trình làm việc của yêu cầu kéo để ngăn chặn các lần chạy đánh giá thừa và các vòng lặp vô tận. Thay vào đó, chạy các đánh giá trên các sự kiện openedreopened, và kích hoạt các lượt kiểm tra tiếp theo thủ công bằng cách đăng một nhận xét @agy /review trên PR.

Hình ảnh minh họa sơ đồ pipeline đánh giá PR tự động bằng Antigravity Agent có thể được tìm thấy tại đây.

Bạn có thể tìm thấy toàn bộ mã nguồn tại run-agy-sdk.

run-agy-sdk: Công Cụ Cốt Lõi Cho Quy Trình Duyệt Mã Tự Động

Dự án run-agy-sdk là một GitHub Action tổng hợp, được thiết kế để chạy trực tiếp Google Antigravity SDK (google-antigravity) trên trình chạy (runner) của GitHub Actions. Điều này mang lại một phương pháp tích hợp mạnh mẽ và linh hoạt để tự động hóa các tác vụ liên quan đến Antigravity SDK ngay trong quy trình CI/CD của bạn.

Tại Sao Nên Chạy run-agy-sdk Trực Tiếp Trên Host Thay Vì Container?

Việc chạy trực tiếp trên host mang lại một lợi thế đáng kể: Antigravity SDK có quyền truy cập vào Docker daemon của host. Điều này cho phép SDK tạo các máy chủ MCP (Managed Control Plane) dựa trên Docker (như máy chủ GitHub MCP) để thực hiện các tác vụ quan trọng như đọc tệp, chạy thử nghiệm và đăng đánh giá. Cách tiếp cận này giúp tác tử có khả năng tương tác sâu rộng với môi trường mã nguồn và quy trình kiểm thử.

Về mặt bảo mật, các sub-container lý tưởng nên chạy với quyền truy cập mạng bị hạn chế và hệ thống tệp chỉ đọc (read-only filesystems) bất cứ khi nào có thể, nhằm ngăn chặn một LLM bị lừa thực thi các lệnh phá hoại tùy ý. Một bộ quyền hạn chế được xử lý trong cấu hình GitHub Action (chi tiết tại đây). Trong khi đó, tác tử Antigravity có một số lượng công cụ hạn chế mà nó có thể sử dụng từ GitHub MCP (xem tại đây).

Hơn nữa, quy trình làm việc được bảo vệ một cách rõ ràng khỏi việc tự động chạy trên các fork, ngăn chặn việc thực thi mã trái phép. Tác vụ đánh giá tự động sẽ chỉ chạy nếu yêu cầu kéo có nguồn gốc từ cùng một kho lưu trữ (xem chi tiết tại đây). Các đánh giá theo yêu cầu được kích hoạt bằng cách bình luận @agy /review được giới hạn chỉ có thể được khởi tạo bởi người bảo trì (maintainers) (xem ví dụ tại đây). Những biện pháp bảo mật này đảm bảo rằng quy trình tự động hóa được kiểm soát chặt chẽ và an toàn.

Trình Diễn Thực Tế: Antigravity PR Reviewer Hoạt Động

Để hình dung rõ hơn về cách hoạt động của hệ thống, bạn có thể xem video trình diễn dưới đây. Video này cho thấy cách action được kích hoạt bởi một PR mới, cách tác tử thực hiện đánh giá và tương tác với pull request.

Hướng Dẫn Triển Khai: Cài Đặt Action Trong Kho Lưu Trữ Của Bạn

Hãy cùng chúng tôi đi qua quy trình cài đặt từng bước một để tích hợp Antigravity PR Reviewer vào kho lưu trữ GitHub của bạn.

Bước 1: Thêm Khóa API Của Bạn Vào GitHub Secrets

Action này yêu cầu khóa API của Google Gemini hoặc Antigravity để xác thực các tương tác với mô hình ngôn ngữ.

  1. Tạo khóa API của bạn.
  2. Điều hướng đến kho lưu trữ GitHub mục tiêu của bạn và truy cập Settings > Secrets and variables > Actions.
  3. Tạo một Repository Secret mới có tên ANTIGRAVITY_API_KEY và dán khóa API của bạn vào làm giá trị.

Bước 2: Cấu Hình Quy Trình Làm Việc GitHub Actions

Thêm một tệp mới vào kho lưu trữ của bạn tại .github/workflows/antigravity-review.yml và thêm cấu hình sau:

name: '🔎 Antigravity PR Review'

on:
  pull_request:
    types: [opened, reopened]
  workflow_dispatch:

concurrency:
  group: '${{ github.workflow }}-${{ github.event.pull_request.number || github.ref_name }}'
  cancel-in-progress: true

jobs:
  antigravity-review:
    runs-on: 'ubuntu-latest'
    timeout-minutes: 20

    permissions:
      contents: 'read'
      pull-requests: 'write'
      issues: 'write'

    steps:
      - name: 'Checkout Repository'
        uses: 'actions/checkout@v6'
        with:
          persist-credentials: false

      - name: 'Run Antigravity PR Review'
        uses: 'rsamborski/run-agy-sdk@main'
        id: 'agy_pr_review'
        with:
          api-key: '${{ secrets.ANTIGRAVITY_API_KEY }}'
          github-token: '${{ secrets.GITHUB_TOKEN }}'
          mode: 'review'
          prompt: '/antigravity-review'
          trust-workspace: 'true'
          sandbox-profile: 'true'

Mẹo chuyên nghiệp: Nên ghim phiên bản action vào một commit SHA cụ thể (ví dụ: rsamborski/run-agy-sdk@<commit-sha>) thay vì sử dụng @main. Điều này giúp ngăn chặn các lỗi không mong muốn từ các bản cập nhật upstream.

Mặc dù bạn có thể tham chiếu trực tiếp run-agy-sdk trong các quy trình làm việc của mình, nhưng sức mạnh thực sự của nó nằm ở việc sử dụng nó như một bản thiết kế. Chúng tôi khuyến khích bạn fork repository này và sử dụng nó như một mẫu để xây dựng các GitHub Actions tác tử tùy chỉnh của riêng bạn. Bằng cách sửa đổi các chính sách an toàn, công cụ tùy chỉnh hoặc lời nhắc (prompts) trong run_agent.py, bạn có thể điều chỉnh hành vi đánh giá của tác tử cho phù hợp với cơ sở mã, nguyên tắc phong cách và quy tắc tuân thủ cụ thể của nhóm bạn.

Để có một mẫu quy trình làm việc đầy đủ hỗ trợ cả đánh giá PR tự động và đánh giá kích hoạt bằng bình luận, hãy tham khảo thư mục workflows trong repository.

Kết Luận: Tối Ưu Hóa Chất Lượng Mã với Antigravity SDK

Việc tự động hóa quy trình đánh giá mã là một điều cần thiết khi khối lượng mã do AI tạo ra ngày càng tăng. Bằng cách sử dụng run-agy-sdk, bạn có thể chạy Antigravity SDK để đánh giá PR tự động và chuyển bớt gánh nặng đảm bảo chất lượng mã khỏi các nhà đánh giá con người. Điều này không chỉ giúp tiết kiệm thời gian mà còn nâng cao độ chính xác và nhất quán trong quy trình phát triển.

  • Truy cập toàn bộ mã nguồn tại kho lưu trữ GitHub.
  • Đọc tài liệu để tùy chỉnh các lời nhắc và chế độ hoạt động.
  • Hãy thoải mái fork repository và xây dựng hệ thống tự động hóa của riêng bạn.

Lời Cảm Ơn

Dự án này được lấy cảm hứng từ action run-gemini-cli, trong khi chuyển đổi sang Antigravity SDK mới được phát hành. Đây là một triển khai mẫu cá nhân về cách chạy Antigravity SDK trong một GitHub Action và không phải là một sản phẩm được Google chính thức hỗ trợ.

Hãy Cùng Kết Nối!

Tôi rất mong được nghe về cách bạn đang sử dụng Antigravity cho các quy trình làm việc tác tử của mình. Bạn đang xây dựng các vòng lặp đánh giá mã tự động hay đang giữ cho các tác tử của mình hoạt động chặt chẽ hơn?

Chỉ mục