Copilot custom instructions và 3 cách khác để dạy GitHub Copilot hiểu codebase của bạn
Copilot custom instructions cho phép bạn viết quy tắc của dự án một lần, để GitHub Copilot tự làm theo mà bạn không phải giải thích lại các tiêu chuẩn ở đầu mỗi tác vụ. Trong bài hướng dẫn cho người mới đăng ngày 12/10/2026, GitHub mô tả bốn cách tùy chỉnh Copilot theo dự án: custom instructions, agent skills, custom agents và MCP server. Mỗi cách nằm ở một vị trí riêng, và chúng phát huy tốt nhất khi dùng cùng nhau.

Điểm chính
- Đăng: ngày 12/10/2026 trên GitHub Blog, trong loạt bài “GitHub Copilot app for Beginners”.
- Custom instructions:
.github/copilot-instructions.mdcho quy tắc áp dụng toàn repo, cộng với.github/instructionscho quy tắc theo từng đường dẫn. - Agent skills: các thư mục trong
.github/skills, mỗi thư mục có một fileSKILL.md, chỉ được nạp khi liên quan. - Custom agents: các profile trong
.github/agentscho công việc chuyên biệt, lặp đi lặp lại. - MCP server: kết nối Copilot với công cụ bên ngoài. Có Playwright, Copilot có thể mở ứng dụng của bạn trong trình duyệt và tự kiểm thử.
- Bắt đầu từ đâu: một quy ước bạn hay phải giải thích, thêm vào
copilot-instructions.md.
Xem nhanh: video 30 giây của chúng mình về Copilot custom instructions (tiếng Việt).
Vì sao cần dạy Copilot hiểu codebase của bạn?
Codebase nào cũng có “luật nhà”: cách tổ chức component, script nào cần chạy, và quy ước nào áp dụng cho từng framework hay loại file. Copilot có thể sửa đổi trên khắp dự án, nhưng GitHub nói nó “làm việc tốt nhất khi cũng biết những quy tắc đó”.
Ví dụ của GitHub: bạn nhờ Copilot thêm kích thước trang tùy chỉnh cho một ứng dụng. Sửa được thôi chưa đủ. Code mới còn phải theo các mẫu mà nhóm bạn đang dùng. Phần lớn kiến thức đó có thể nằm ngay trong repo, để Copilot tự nhận được.
| Cách làm | Nằm ở đâu | Phù hợp nhất với |
|---|---|---|
| Custom instructions | .github/copilot-instructions.md và .github/instructions | Tiêu chuẩn ảnh hưởng đến nhiều tác vụ |
| Agent skills | .github/skills/<skill-name>/SKILL.md | Một quy trình cụ thể, như kiểm tra chất lượng |
| Custom agents | .github/agents | Công việc lặp lại, nhiều file, cần một vai trò riêng |
| MCP server | Thêm trong ứng dụng Copilot | Truy cập công cụ, dữ liệu và dịch vụ bên ngoài repo |
1. Copilot custom instructions là gì?
Custom instructions cung cấp cho Copilot bối cảnh nền cho cả repo.
File áp dụng toàn repo: thêm .github/copilot-instructions.md. Dùng cho những hướng dẫn áp dụng ở mọi nơi, chẳng hạn:
- Kiến trúc bạn ưa dùng
- Quy ước đặt tên
- Yêu cầu về kiểm thử và xác thực
File theo đường dẫn: tạo các file hướng dẫn trong .github/instructions. Mỗi file dùng một trường applyTo để cho Copilot biết hướng dẫn áp dụng cho những file nào. Khi Copilot làm việc với file khớp, nó dùng cả hướng dẫn toàn repo lẫn hướng dẫn riêng.
Nhờ vậy bạn giữ các quy tắc chung ở một chỗ mà không ép mọi loại file vào cùng một khuôn.
2. Agent skills dùng cho quy trình lặp lại thế nào?
Có những hướng dẫn chỉ cần trong một quy trình nhất định, như chạy kiểm tra chất lượng, chuẩn bị bản phát hành hay gỡ lỗi một workflow bị hỏng. Đó là việc của agent skills.
Một skill là một thư mục chứa hướng dẫn và, tùy chọn, các script và tài nguyên khác. Copilot chỉ nạp nó khi liên quan.
- Skill của dự án nằm trong
.github/skills, mỗi skill một thư mục con. - Ví dụ:
.github/skills/quality-checks/SKILL.mdgiải thích quy trình kiểm thử và lint của bạn. - Phần description trong
SKILL.mdgiúp Copilot quyết định khi nào áp dụng skill.
Trong ví dụ của GitHub, sau khi cập nhật một giao diện, Copilot nạp skill quality-checks và làm theo quy trình kiểm thử và lint của dự án “thay vì đoán xem nên chạy lệnh nào”.
3. Custom agents dùng cho việc lớn hơn thế nào?
Có những tác vụ lớn hơn một quy trình đơn lẻ. Ví dụ, rà soát khả năng truy cập có thể phải kiểm tra component, template, style và tương tác trên nhiều file.
Custom agents là các phiên bản Copilot chuyên biệt cho kiểu việc này. Một profile agent cấp repo nằm trong .github/agents và có thể định nghĩa:
- Mục đích của agent
- Hướng dẫn của nó
- Các công cụ nó được dùng
- Bối cảnh dự án liên quan
GitHub gợi ý dùng custom agent khi một loại việc lặp lại cần một vai trò riêng, nhất là khi nó trải qua nhiều file và nhiều công cụ hay nguồn bối cảnh.
4. MCP server giúp Copilot dùng công cụ bên ngoài ra sao?
Instructions, skills và agents giúp Copilot hiểu cách làm việc bên trong dự án của bạn. MCP server (Model Context Protocol server) mở rộng những gì nó truy cập và làm được ra ngoài repo, bằng cách kết nối nó với công cụ, nguồn dữ liệu và dịch vụ bên ngoài.
- Một documentation server có thể cho Copilot truy cập hướng dẫn của framework.
- Một server Playwright cho phép Copilot mở và tương tác với ứng dụng của bạn trong trình duyệt.
Bạn có thể duyệt các MCP server có sẵn trong ứng dụng Copilot hoặc thêm server tùy chỉnh. Khi đã cấu hình Playwright, GitHub gợi ý một prompt như:
Use the Playwright MCP server to test the functionality manually.
Copilot sẽ mở ứng dụng trong trình duyệt và tương tác với nó “giống như bạn”. Đây là phần thú vị nhất: Copilot có thể kiểm tra không chỉ việc code qua được các bước kiểm tra tự động, mà cả việc giao diện đã cập nhật có thực sự hoạt động đúng như mong đợi.
Bắt đầu với Copilot custom instructions thế nào?
Lời khuyên của GitHub là bắt đầu nhỏ:
- Chọn một quy ước mà bạn hay phải giải thích cho Copilot.
- Thêm nó vào
.github/copilot-instructions.md. - Xem Copilot áp dụng nó vào tác vụ tiếp theo của bạn ra sao.
Khi muốn làm nhiều hơn, hãy xem Awesome Copilot, nơi cộng đồng chia sẻ sẵn các instructions, skills, agents và nhiều thứ khác. Tìm một mục khớp với workflow bạn đã lặp lại, xem kỹ nó chứa gì, rồi chỉnh cho hợp với công cụ và tiêu chuẩn của repo bạn.
Những tùy chỉnh này có đáng công sức không?
Ưu điểm
- Bạn không còn phải lặp lại cùng một quy tắc trong mỗi prompt.
- Quy tắc nằm trong repo nên cả nhóm cùng dùng chung.
- Skills và hướng dẫn theo đường dẫn chỉ được nạp khi liên quan.
- MCP server như Playwright cho phép Copilot kiểm thử giao diện thật.
Nhược điểm
- Bạn phải viết và bảo trì các file khi dự án thay đổi.
- Tài nguyên từ cộng đồng cần được xem xét và chỉnh sửa trước khi dùng.
- MCP server cần được thiết lập trước khi Copilot dùng được.
Kết luận: hãy bắt đầu với một custom instruction duy nhất. Đây là cách rẻ nhất để đầu ra của Copilot khớp phong cách của nhóm, và bạn có thể thêm skills, agents và MCP server sau, khi có nhu cầu thật.
Góc nhìn của Trạm: hãy bắt đầu nhỏ. Một quy tắc rõ ràng trong copilot-instructions.md tiết kiệm thời gian hơn cả chục agent làm dở. Copilot custom instructions là thứ lợi nhất mà rẻ nhất, nên chỉ thêm skills, agents và MCP server khi có một tác vụ cứ lặp đi lặp lại.
Nhớ giữ an toàn cho các quy tắc nữa: xem hướng dẫn của chúng mình về bảo mật Copilot custom instructions. Muốn thực hành MCP, hãy đọc hướng dẫn Playwright MCP, và so sánh với Claude Skills.
Câu hỏi thường gặp về Copilot custom instructions
Copilot custom instructions đặt ở đâu?
Đặt quy tắc toàn repo trong .github/copilot-instructions.md, và quy tắc theo đường dẫn trong các file thuộc .github/instructions có dùng trường applyTo.
Custom instructions khác agent skills thế nào?
Custom instructions định hình nhiều tác vụ. Agent skills phụ trách một quy trình cụ thể, như kiểm tra chất lượng, và Copilot chỉ nạp chúng khi liên quan.
Custom agents nằm ở đâu?
Trong .github/agents. Mỗi profile có thể định nghĩa mục đích, hướng dẫn, công cụ và bối cảnh dự án của agent.
Copilot có thể kiểm thử ứng dụng của tôi trong trình duyệt không?
Có. Khi đã cấu hình Playwright MCP server, Copilot có thể mở ứng dụng của bạn trong trình duyệt và tương tác với nó.
Tìm instructions và skills dựng sẵn cho Copilot ở đâu?
Cộng đồng chia sẻ chúng trong Awesome Copilot. Hãy xem xét và chỉnh sửa trước khi dùng.
Nguồn tham khảo
- GitHub Blog, “GitHub Copilot app for Beginners: How to teach Copilot about your codebase” Cập nhật lần cuối: 30/10/2026