AI Orchestration

Dùng Claude Code với GitHub MCP cho AI-assisted development workflows

Mình dùng Claude Code kết nối với GitHub MCP (Model Context Protocol) để quản lý workflow phát triển -- PRs, issues, code reviews -- với sự hỗ trợ của AI. Mục tiêu là AI xử lý phần cơ học, mình tập trung phần sáng tạo và chiến lược.

Ý tưởng lõi: AI xử lý phần lặp đi lặp lại của development workflows, để mình tập trung vào phần cần suy nghĩ.

AI Orchestration Là Gì?

Dùng AI tools để tự động hoá và hỗ trợ development workflows:

Developer Intent → Claude Code → GitHub MCP → GitHub Actions
      ↓                ↓              ↓
   "Fix this bug"   Hiểu context    Tạo PR
                                    Update issues
                                    Quản lý workflow

MCP Là Gì?

Model Context Protocol (MCP) là chuẩn kết nối AI assistants với external tools. GitHub MCP server cho Claude Code truy cập:

  • Thông tin repository
  • Issues và pull requests
  • Nội dung files
  • Lịch sử commit
  • GitHub Actions

Cài Đặt

Yêu Cầu

  1. Claude Code đã cài
  2. GitHub CLI đã xác thực (gh auth login)
  3. MCP server đã configure

Configuration

Thêm GitHub MCP server vào Claude Code:

{
  "mcpServers": {
    "github": {
      "command": "bunx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<token-của-bạn>"
      }
    }
  }
}

Workflow Thường Dùng

Tạo PR có context

Thay vì tự viết PR description:

"Create a PR for my current changes. Include what changed and why."

Claude Code sẽ đọc thay đổi, hiểu context, tạo PR mô tả chi tiết, và link related issues. Mình review rồi submit.

Phân loại issues

"Look at the open issues and categorize them by priority and type."

Claude Code đọc tất cả open issues, phân tích nội dung, đề xuất phân loại, tuỳ chọn gắn labels. Đỡ phải đọc từng issue một.

Hỗ trợ code review

"Review PR #123 and summarize the changes."

Claude Code lấy PR diff, phân tích thay đổi, phát hiện vấn đề tiềm ẩn, tóm tắt cho mình review. Mình đọc summary rồi quyết định approve hay request changes.

Khi Nào Dùng, Khi Nào Không

Tình huốngDùng AI?Lý do
Tạo PR routineTiết kiệm thời gian, format nhất quán
Code review phức tạpMột phầnAI tóm tắt, mình quyết định
Phân loại issuesPattern recognition ở quy mô lớn
Thay đổi nhạy cảmKhôngCần human judgment

Làm thủ công khi: thay đổi liên quan security, breaking changes cần giao tiếp cẩn thận, cần toàn quyền kiểm soát nội dung, hoặc đang học (làm tay giúp hiểu sâu hơn).

Lưu Ý Thực Tế

Luôn review trước khi submit. PR descriptions AI tạo có thể thiếu context mà chỉ mình biết. Issue labels có thể không đúng quy ước team. Comments nên phản ánh giọng văn của mình.

Bắt đầu nhỏ. Draft PR descriptions (sửa trước khi submit), tóm tắt changes để mình hiểu, generate commit messages. Quen rồi mới mở rộng scope.

Đưa context. Tham chiếu related issues, giải thích "vì sao" chứ không chỉ "cái gì", nhắc đến quy ước team. Context càng tốt thì output càng chính xác.

Hạn Chế

Hạn chếCách xử lý
Không biết quy ước teamCung cấp context qua CLAUDE.md
Không truy cập private repos nếu chưa authSetup token đúng
Có thể tạo PRs dài dòngSửa và cắt gọn trước khi submit
Không hiểu political contextReview thủ công giao tiếp nhạy cảm

Tham Khảo Nhanh

Mình muốn...Cách làm
Tạo PR nhanhClaude draft → review → submit
Hiểu PRClaude tóm tắt thay đổi
Phân loại issuesClaude phân loại và ưu tiên
Viết commit messagesClaude generate từ diff

Tài Liệu Tham Khảo