Claude Code subagents workflow: tự động review PR bằng các AI reviewer tùy chỉnh (hướng dẫn 2026)

https://tramcongngheai.com/

🇬🇧 Read in English

Claude Code subagents workflow: tự động review PR bằng các AI reviewer tùy chỉnh

Tự động hóa review code không còn là thứ xa xỉ của tương lai, mà là nhu cầu thiết thực của các đội làm việc tốc độ cao. Claude Code subagents cho phép chạy song song nhiều AI reviewer chuyên biệt, áp dụng chuẩn của đội và rút ngắn vòng đời pull request (PR). Bài này hướng dẫn bạn xây dựng, triển khai và tối ưu một Claude Code subagents workflow để review PR trong năm 2026, dựa trên các triển khai thực tế và thử nghiệm trực tiếp.

Claude Code subagents là gì?

Claude Code subagents là các AI worker độc lập, mỗi worker chạy trong context window riêng. Chúng có thể được điều chỉnh cho từng tác vụ review cụ thể như bảo mật, hiệu năng, khả năng truy cập và nhiều hơn nữa. Subagents có thể chạy tuần tự hoặc song song, rồi trả kết quả đã tóm tắt về phiên chính hoặc orchestrator. Cách tiếp cận dạng module này cho phép review PR chi tiết, mở rộng được và tùy chỉnh được.

Vì sao nên dùng subagents để review PR?

  • Phân tích song song: Chạy nhiều reviewer chuyên biệt cùng lúc (ví dụ bảo mật, hiệu năng, phong cách code), bắt được nhiều vấn đề hơn so với quét bằng một agent.
  • Chuẩn riêng của đội: Áp dụng quy tắc riêng của đội qua CLAUDE.md hoặc prompt của subagent.
  • Tích hợp CI/CD: Tự động hóa review như một phần của pipeline GitHub Actions hoặc GitLab.
  • Độ chi tiết: Giao subagent theo từng file hoặc từng hạng mục review để có phản hồi đúng trọng tâm.

Làm sao xây dựng cấu trúc cho Claude Code subagents workflow?

  1. Xác định vai trò của subagent: Chọn các hạng mục review bạn cần (ví dụ Security Reviewer, Performance Profiler, Accessibility Reviewer, API Contract Reviewer).
  2. Tạo file subagent: Lưu subagent trong .claude/agents/ (theo dự án) hoặc ~/.claude/agents/ (cá nhân). Mỗi file cần có name, description và phần thân prompt dạng Markdown.
  3. Cấu hình orchestrator chính: Agent chính giao các tác vụ review cho subagents và tổng hợp phản hồi của chúng.
  4. Tích hợp với CI/CD: Dùng GitHub Actions hoặc GitLab CI để kích hoạt review khi có sự kiện PR.
  5. Hiển thị kết quả: Tóm tắt và đăng phát hiện của subagents dưới dạng comment trên PR, nhóm theo file hoặc hạng mục.

Ví dụ: workflow review PR song song

Trong workflow song song, agent chính giao các subagent chuyên biệt cho từng khía cạnh review. Đây là một cách thiết lập điển hình:

  • Agent chính nhận diff của PR
  • Giao việc cho:
    • Security Reviewer
    • Performance Profiler
    • Accessibility Reviewer
    • API Contract Reviewer
  • Tổng hợp và đăng phản hồi gộp

Mẫu prompt cho Claude Code subagents

Hãy dùng các mẫu prompt thực tế này để cấu trúc việc review của subagents và điều phối của agent chính:

Kích hoạt review có cấu trúc cho diff hiện tại


/review

Hướng dẫn review tùy chỉnh qua CLAUDE.md


# CLAUDE.md
Review for:
- Security vulnerabilities
- Performance bottlenecks
- Code style and maintainability
- API contract adherence
Apply our team’s standards as described in CONTRIBUTING.md.

Ví dụ workflow giao việc tuần tự


Repository Explorer → Feature Planner → Implementation Agent → Test Generator → Pull Request Reviewer

Lệnh review song song bằng subagent


Main Agent:
- Dispatch Security Reviewer
- Dispatch Performance Profiler
- Dispatch Accessibility Reviewer
- Dispatch API Contract Reviewer
Aggregate all findings and summarize for the PR.

Subagent xử lý comment PR theo từng file


For each changed file:
- Run pr-comment-resolver subagent
- Group automatic fixes and suggestions by file
- Present options: reply, skip, or convert to code changes

Thực hành tốt nhất và giới hạn thực tế

  • Review tự động bắt được đáng tin cậy khoảng 80% vấn đề thường gặp. Reviewer là người vẫn không thể thiếu cho kiến trúc và ý đồ thiết kế.
  • Mỗi subagent chạy trong context window riêng, nên hãy lưu ý giới hạn token với các diff lớn.
  • Hãy cân nhắc kỹ khi hiển thị các câu hỏi do AI tạo ra để giữ niềm tin của lập trình viên. Cho phép con người trả lời, bỏ qua hoặc chấp nhận gợi ý.
  • Các lớp xác minh (ví dụ /ultrareview) giảm kết quả dương tính giả nhưng có thể làm tăng thời gian xử lý.
  • Các tính năng nâng cao (ví dụ Ship Fast Skill Pack) có thể yêu cầu phí một lần hoặc phí đăng ký.

Tích hợp với GitHub Actions (workflow mẫu)


name: Claude Code PR Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run Claude Code Review
        run: |
          claude review --agents .claude/agents/ --diff ${{ github.event.pull_request.diff_url }}

Kết luận

Claude Code subagents workflow mang lại việc review PR mở rộng được, tùy chỉnh được và hiệu quả cho đội của bạn. Bằng cách kết hợp chiến lược subagent song song và tuần tự, áp dụng chuẩn riêng và tích hợp với CI/CD, bạn bắt được nhiều vấn đề sớm hơn và đẩy nhanh pipeline phát triển. Hãy luôn kết hợp review tự động với sự giám sát của con người để có kết quả tốt nhất.

Trạm Công Nghệ AI
Logo
Compare items
  • Total (0)
Compare
0