GitHub Copilot cho người mới bắt đầu: Cách dạy Copilot hiểu về codebase của bạn

GitHub Copilot cho người mới bắt đầu: Cách dạy Copilot hiểu về codebase của bạn

Ngữ cảnh đóng vai trò cực kỳ quan trọng khi làm việc với AI. Mỗi codebase đều có những "luật lệ" riêng: cách các component được tổ chức, script nào cần chạy, và quy ước nào áp dụng cho từng framework hay loại file khác nhau.

Copilot có thể giúp bạn thực hiện thay đổi xuyên suốt dự án, nhưng nó hoạt động tốt nhất khi hiểu được những quy tắc đó. Phần lớn kiến thức này có thể được lưu trữ ngay trong repository, để Copilot tự động nắm bắt thay vì bạn phải giải thích lại các tiêu chuẩn, script và quy trình làm việc mỗi khi bắt đầu một tác vụ mới.

Trong bài viết này, chúng ta sẽ cùng khám phá bốn cách tùy chỉnh Copilot để làm việc hiệu quả với dự án của bạn:

• Hướng dẫn tùy chỉnh (Custom instructions) truyền đạt các quy ước mà Copilot nên tuân theo.
• Kỹ năng agent (Agent skills) đóng gói các quy trình có thể lặp lại.
• Agent tùy chỉnh (Custom agents) mang đến hướng dẫn chuyên biệt cho các tác vụ lớn hơn.
• Máy chủ Model Context Protocol (MCP) kết nối Copilot với các công cụ và nguồn dữ liệu bên ngoài, mở rộng khả năng của nó.

Hãy cùng xem cách từng phương pháp hoạt động và cách chúng kết hợp với nhau.

Tùy chỉnh GitHub Copilot cho codebase của bạn

Bắt đầu với hướng dẫn tùy chỉnh

Giả sử bạn yêu cầu Copilot thêm một kích thước trang tùy chỉnh vào ứng dụng. Việc thực hiện thay đổi chỉ là một phần của công việc. Code mới cũng phải tuân theo các mẫu mà nhóm bạn đã sử dụng.

Hướng dẫn tùy chỉnh ở cấp repository cung cấp cho Copilot ngữ cảnh nền tảng đó. Bạn có thể thêm file .github/copilot-instructions.md để định nghĩa hướng dẫn áp dụng cho toàn bộ repository, chẳng hạn như kiến trúc ưa thích, quy ước đặt tên, hoặc kỳ vọng về kiểm thử và xác thực.

Bạn cũng có thể tạo file hướng dẫn theo đường dẫn cụ thể trong thư mục .github/instructions. Những file này sử dụng trường applyTo để cho Copilot biết khi nào hướng dẫn đó có liên quan.

Khi Copilot làm việc với một file khớp điều kiện, nó có thể sử dụng đồng thời cả hướng dẫn toàn repository lẫn hướng dẫn chuyên biệt hơn. Điều này cho phép bạn giữ các quy tắc chung ở một nơi mà không buộc mọi loại file phải tuân theo cùng một khuôn mẫu.

Đóng gói quy trình lặp lại thành kỹ năng agent

Hướng dẫn tùy chỉnh hữu ích cho các tiêu chuẩn cần định hình nhiều tác vụ. Nhưng một số hướng dẫn chỉ quan trọng khi Copilot thực hiện một quy trình cụ thể, chẳng hạn như chạy kiểm tra chất lượng, chuẩn bị phát hành, hoặc gỡ lỗi một workflow thất bại.

Đó là lúc kỹ năng agent (agent skills) phát huy tác dụng. Một kỹ năng là một thư mục chứa hướng dẫn và tùy chọn các script cùng tài nguyên khác mà Copilot có thể tải khi cần thiết. Kỹ năng cấp dự án có thể nằm trong .github/skills, với mỗi kỹ năng trong một thư mục con riêng.

Ví dụ, thư mục .github/skills/quality-checks có thể chứa file SKILL.md giải thích:

• Khi nào Copilot nên sử dụng kỹ năng này.
• Những script nào chạy kiểm thử và linting của dự án.
• Mỗi script kiểm tra điều gì.
• Cách xử lý các lỗi thường gặp.

Phần mô tả trong SKILL.md giúp Copilot xác định khi nào kỹ năng được áp dụng. Sau khi cập nhật giao diện, Copilot có thể tải kỹ năng quality-checks và tuân theo quy trình kiểm thử, linting đã được thiết lập của dự án thay vì đoán mò xem nên chạy lệnh nào.

Dùng agent tùy chỉnh cho công việc chuyên biệt, quy mô lớn hơn

Một số tác vụ lớn hơn cả một quy trình đơn lẻ. Ví dụ, việc đánh giá khả năng truy cập (accessibility review) có thể yêu cầu Copilot kiểm tra các component, template, style và tương tác trên nhiều file khác nhau.

Agent tùy chỉnh cho phép bạn tạo các phiên bản chuyên biệt của Copilot cho những công việc như vậy. Hồ sơ agent cấp repository nằm trong .github/agents và có thể định nghĩa mục đích, hướng dẫn, công cụ và ngữ cảnh dự án liên quan của agent.

Hãy dùng agent tùy chỉnh khi một loại công việc lặp đi lặp lại được hưởng lợi từ vai trò hoặc góc nhìn chuyên dụng, đặc biệt khi tác vụ có thể trải rộng trên nhiều file và cần đến nhiều công cụ hay nguồn ngữ cảnh.

Kết nối Copilot với công cụ bên ngoài bằng máy chủ MCP

Hướng dẫn, kỹ năng và agent giúp Copilot hiểu cách làm việc trong dự án của bạn. Máy chủ MCP mở rộng những gì nó có thể truy cập và thực hiện ngoài phạm vi repository.

Máy chủ MCP kết nối Copilot với các công cụ, nguồn dữ liệu và dịch vụ bên ngoài. Một máy chủ tài liệu có thể cho nó quyền truy cập hướng dẫn về framework, trong khi một máy chủ như Playwright có thể cho phép nó mở và tương tác với ứng dụng của bạn trên trình duyệt.

Bạn có thể duyệt các máy chủ MCP có sẵn trong ứng dụng Copilot hoặc thêm một máy chủ tùy chỉnh. Sau khi cấu hình Playwright, bạn có thể yêu cầu: "Dùng máy chủ Playwright MCP để kiểm thử chức năng thủ công."

Copilot sau đó có thể dùng Playwright để mở ứng dụng trên trình duyệt và tương tác với nó giống như bạn vẫn làm. Điều này cho nó một cách để xác minh không chỉ rằng code vượt qua các kiểm tra tự động, mà còn rằng giao diện đã cập nhật hoạt động đúng như mong đợi.

Kết nối Copilot với các công cụ thông qua MCP

Chọn đúng loại tùy chỉnh

Những tùy chỉnh này giải quyết các vấn đề khác nhau, nhưng chúng trở nên hữu ích hơn khi bạn kết hợp chúng lại:

• Hướng dẫn tùy chỉnh định nghĩa các quy ước Copilot nên tuân theo trên toàn repository hoặc cho các file cụ thể.
• Kỹ năng agent đóng gói các quy trình lặp lại mà Copilot có thể tải khi cần.
• Agent tùy chỉnh cung cấp chuyên môn và hướng dẫn tập trung cho các tác vụ lớn hơn.
• Máy chủ MCP kết nối Copilot với công cụ, dịch vụ và nguồn dữ liệu bên ngoài, mở rộng khả năng của nó.

Những điều cần ghi nhớ

Việc cung cấp ngữ cảnh dự án hữu ích cho Copilot bắt đầu từ bốn câu hỏi:

• Quy ước dự án nào tôi cứ phải giải thích mãi?
• Quy trình gồm nhiều bước nào tôi lặp lại thường xuyên?
• Tác vụ phức tạp nào có thể hưởng lợi từ một agent tùy chỉnh chuyên dụng?
• Copilot cần công cụ hay nguồn dữ liệu bên ngoài nào?

Chưa biết bắt đầu từ đâu? Cộng đồng đã chia sẻ sẵn các hướng dẫn, kỹ năng, agent và nhiều thứ khác thông qua Awesome Copilot. Hãy tìm một mục giải quyết workflow bạn đã lặp lại, xem xét nội dung của nó, và điều chỉnh cho phù hợp với công cụ và tiêu chuẩn của repository bạn.

Hãy bắt đầu từ những bước nhỏ: chọn một quy ước bạn cứ phải giải thích mãi, thêm nó vào .github/copilot-instructions.md, và xem Copilot áp dụng nó như thế nào trong tác vụ tiếp theo của bạn.

Đối với lập trình viên Việt Nam đang làm việc trong các nhóm phân tán hoặc dự án đa framework, việc chuẩn hóa các hướng dẫn này ngay từ đầu sẽ giúp giảm đáng kể thời gian giải thích và hạn chế lỗi phát sinh do Copilot không hiểu đúng quy ước nội bộ. Đây là một khoản đầu tư nhỏ nhưng mang lại hiệu quả lâu dài cho toàn bộ quy trình phát triển phần mềm.