// thỏa thuận
copilot-instructions.md
Copilot nên hành xử thế nào trên repo này.
Dành cho người dùng GitHub Copilot CLI
Copilot bắt đầu mỗi phiên làm việc một cách mù quáng.
Hướng dẫn tùy chỉnh cho Copilot biết cách hành xử. Chúng không cho biết những gì có trong kho mã của bạn. Maguyva lập chỉ mục codebase và cung cấp lại qua MCP, để GitHub Copilot CLI chỉnh sửa như thể đã đọc mã nguồn rồi.
Gói Free: 3 repository, Tối đa 50K dòng repo đã index, không cần thẻ tín dụng.
Dùng hướng dẫn cho hành vi. Dùng Maguyva cho các dữ kiện codebase hiện tại.Chồng lớp
Bốn ý tưởng. Mỗi ý tưởng làm một việc.
// kênh truyền tải
MCP
Cách Copilot vươn tới các công cụ và ngữ cảnh bên ngoài.
// codebase
Maguyva
MCP server trả về các dữ kiện repo có căn cứ.
// ai trả tiền
Theo workspace, không theo người dùng
Không tính phí riêng cho từng tác nhân. Xem bảng giá
Hướng dẫn tùy chỉnh là một thỏa thuận làm việc. Hãy sử dụng chúng.
# .github/copilot-instructions.md
- Ưu tiên các ranh giới module hiện có.
- Chạy lệnh kiểm thử của kho mã trước khi đề xuất merge.
- Không tự bịa đường dẫn tệp. Hỏi trước khi bạn tạo một gói mới.Các hướng dẫn lâu dài thuộc về .github/copilot-instructions.md. Đó là nơi phù hợp cho:
- Các lệnh build, test và lint mà Copilot nên chạy.
- Các quy tắc “luôn làm X / không bao giờ làm Y” giới hạn trong kho mã này.
- Quy ước đặt tên và sở thích khi review.
- Các liên kết đến nhật ký quyết định — không phải bãi rác chứa mọi ký hiệu.
Tệp đó chưa bao giờ là một chỉ mục có thể truy vấn của kho mã. Nó cho Copilot biết cách làm việc. Nó không cho biết những gì có ở đó.
Nơi hướng dẫn tùy chỉnh ngừng phát huy tác dụng ở quy mô lớn
Bốn chế độ lỗi mà Copilot không thể khắc phục từ một tệp markdown.
// hướng dẫn không phải là chỉ mục
Telling Copilot how to behave does not tell it which class owns parseConfig, or which package actually implements the public API. Bản chỉnh sửa đầu tiên trên một cây thư mục xa lạ chỉ là một phỏng đoán về cấu trúc tệp.
// tài liệu trở nên lỗi thời, mã nguồn thì không
Một khối hướng dẫn mô tả luồng xác thực của quý trước chắc chắn sai vào ngày ai đó tách kho lưu trữ phiên làm việc. Copilot will prefer the file you committed over the code that shipped.
// các phụ thuộc không nằm trong markdown
“Cái gì nhập cái này?” is a graph question. Hướng dẫn không thể liệt kê từng nơi gọi, và bạn cũng sẽ không muốn như vậy.
// cửa sổ ngữ cảnh có giới hạn
Nhồi nhét thêm kho mã vào hướng dẫn đổi lấy token suy luận bằng một bản chụp đã lỗi thời. Sau vài KB, bạn đang trả tiền cho một bản đồ tệ hơn.
Maguyva như lớp bổ sung
Copilot đã nghĩ theo hướng dẫn và công cụ.
copilot-instructions.md
thỏa thuận
cách Copilot hành xử
MCP
kênh
cách nó tiếp cận
Maguyva
dữ kiện codebase
những gì nó thấy
- Bản đồ kho mã có thể truy vấn được cung cấp qua MCP dưới dạng máy chủ streamable-HTTP từ xa.
- 11 công cụ hướng đến khách hàng trên các phương thức tìm kiếm ngữ nghĩa, cấu trúc (AST), đồ thị và văn bản, cùng ký hiệu, thành phần phụ thuộc và truy xuất tệp.
- Kết quả xếp hạng kèm đường dẫn tệp và số dòng trên hơn 284 ngôn ngữ và công nghệ dựa trên văn bản.
- Một cấu hình duy nhất Cùng một workspace trả lời trong Copilot, Claude Code, Cursor, Codex và bất kỳ client tương thích MCP nào khác.
Hướng dẫn tùy chỉnh cho Copilot biết cách hành xử.
Maguyva cung cấp cho Copilot một bản đồ mã nguồn có thể truy vấn.
Ba quy trình làm việc
Hỏi bản đồ trước khi bạn chấp nhận diff.
// workflow 01
Tìm phần triển khai thực, không phải stub kiểm thử
copilot> normalizePhoneNumber xử lý định dạng E.164 như thế nào? semantic::query("normalize phone E.164") src/util/phone.ts:88 normalizePhoneNumber() ← triển khai thực test/util/phone.spec.ts:14 jest.mock(...) ← stub → Copilot mở phần triển khai, không phải mock. [exit 0]
Tên gọi có thể đánh lừa. Mock che giấu mã nguồn thực. Maguyva xếp phần triển khai thực lên trên mock kiểm thử.
// workflow 02
Kiểm tra phạm vi ảnh hưởng trước khi tái cấu trúc
copilot> cái gì gọi QueueDispatcher.publish? graph::callers(QueueDispatcher.publish) 3 trong src/billing/* 1 trong src/audit/* 1 trong src/notifications/* → Diff được xây dựng dựa trên các importer thực. [exit 0]
Các điểm gọi liên gói hiển thị ngay tại chỗ. Diff được xây dựng dựa trên các importer thực, không phải lệnh grep của Copilot.
// workflow 03
Đổi tên một lớp dùng chung, tìm mọi thành phần phụ thuộc trước
copilot> rename PaymentClient → BillingClient graph::callers(PaymentClient) 12 tham chiếu trong 7 gói graph::importers(src/payments/client.ts) 9 importer graph::extends(PaymentClient) 2 lớp con (RetryClient, MockClient) → Copilot đề xuất một quá trình di trú kèm danh sách tệp ngay trong phản hồi. [exit 0]
Copilot hỏi Maguyva về các thành phần phụ thuộc trước khi bắt đầu chỉnh sửa. Danh sách di trú trả về dựa trên đồ thị thực, không phải trí nhớ của Copilot.
Thiết lập trong GitHub Copilot CLI
Ba bước. Gói Free: 3 repository, Tối đa 50K dòng repo đã index, không cần thẻ tín dụng.
// step 01
Lập chỉ mục một kho mã tại maguyva.ai
Chọn một kho mã bạn đã biết, để bạn có thể đánh giá các câu trả lời. Đăng ký miễn phí, kết nối GitHub, chờ lập chỉ mục.
// step 02
Thêm Maguyva làm máy chủ MCP từ xa trong Copilot
copilot mcp add --transport http --header "Authorization: Bearer mgv_xxxx" maguyva https://maguyva.tools/mcp~/.copilot/mcp-config.json{ "mcpServers": { "maguyva": { "type": "http", "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer mgv_xxxx" } } } }// step 03
Đặt một câu hỏi mà bạn đã biết câu trả lời
Đừng bắt đầu với toàn bộ công ty. Đặt một câu hỏi mà bạn đã biết câu trả lời, sau đó mở tệp được trích dẫn.