Claude Code subagents workflow: tự động review PR bằng các AI reviewer tùy chỉnh (hướng dẫn 2026)
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.mdhoặ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?
- 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).
- 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,descriptionvà phần thân prompt dạng Markdown. - 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.
- 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.
- 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.