Trợ lý lập trình AI rất mạnh mẽ nhưng vẫn có những hạn chế – dữ liệu huấn luyện bị cắt ở một ngày cụ thể, thiếu các tính năng và thay đổi mới của API. Nếu không có quyền truy cập vào tài liệu dành riêng cho Gemini, các đặc vụ có thể đề xuất các mẫu chung thay vì các phương pháp được tối ưu hoá.
Các kỹ năng của Gemini API giải quyết những thiếu sót này bằng cách cho phép tác nhân lập trình của bạn truy cập trực tiếp vào tài liệu, các mẫu tích hợp và các phương pháp hay nhất mới nhất của Gemini API. Điều này giúp đảm bảo rằng tác nhân của bạn có thể đưa ra các ví dụ và hướng dẫn về mã chính xác và cụ thể hơn. Bằng cách cài đặt những kỹ năng này, trợ lý lập trình của bạn sẽ luôn cập nhật Gemini API đang phát triển và cách sử dụng được đề xuất.
Các kỹ năng hiện có
Bạn có thể sử dụng các kỹ năng sau. Cài đặt những thành phần có liên quan đến trường hợp sử dụng của bạn.
- skills.sh: Nên dùng. Tiêu chuẩn mở cho các hành vi của tác nhân di động.
- Context7: Được hỗ trợ cho những người dùng đã sử dụng hệ sinh thái Context7.
gemini-api-dev
Kỹ năng phát triển Gemini API cốt lõi:
- Chỉ cho tác nhân lập trình của bạn biết tài liệu chính thức về Gemini API
- Cung cấp các phương pháp hay nhất để xây dựng các ứng dụng dựa trên Gemini
- Bao gồm các mẫu được đề xuất cho các hoạt động tích hợp phổ biến
Cài đặt bằng skills.sh
npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global
Cài đặt bằng Context7
npx ctx7 skills install /google-gemini/gemini-skills gemini-api-dev
gemini-live-api-dev
Kỹ năng xây dựng các ứng dụng AI đàm thoại theo thời gian thực bằng Gemini Live API. Kỹ năng này cung cấp tài liệu và các phương pháp hay nhất cho:
- Kết nối WebSocket để truyền phát trực tiếp có độ trễ thấp
- Truyền trực tuyến âm thanh, video và văn bản
- Hỗ trợ tính năng phát hiện hoạt động bằng giọng nói và tính năng ngắt lời
Cài đặt bằng skills.sh
npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global
Cài đặt bằng Context7
npx ctx7 skills install /google-gemini/gemini-skills gemini-live-api-dev
gemini-interactions-api
Kỹ năng xây dựng ứng dụng bằng Interactions API. Interactions API là một giao diện hợp nhất để tương tác với các mô hình và tác nhân Gemini, được thiết kế cho các ứng dụng dựa trên tác nhân. Kỹ năng này bao gồm:
- Tạo văn bản, trò chuyện nhiều lượt và phát trực tuyến
- Gọi hàm, đầu ra có cấu trúc và tạo hình ảnh
- Chạy ở chế độ nền và các tác nhân Deep Research
- Quản lý trạng thái cuộc trò chuyện phía máy chủ
- Các mẫu SDK Python và TypeScript
Cài đặt bằng skills.sh
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global
Cài đặt bằng Context7
npx ctx7 skills install /google-gemini/gemini-skills gemini-interactions-api
Xác minh cài đặt
Sau khi cài đặt, hãy xác nhận rằng tác nhân lập trình của bạn đã lập chỉ mục kỹ năng và có thể truy cập vào tài liệu Gemini API trực tiếp.
1. Xác minh hành vi của nhân viên hỗ trợ
Cách đáng tin cậy nhất để xác minh là đặt cho nhân viên hỗ trợ một câu hỏi kỹ thuật về Gemini API.
Câu lệnh: "Làm cách nào để sử dụng tính năng lưu vào bộ nhớ đệm theo bối cảnh bằng Gemini API?"
Một lượt cài đặt thành công sẽ:
- Tham chiếu các phương thức cụ thể của Gemini như
cacheContenthoặccachedContents.create. - Hiện một chỉ báo cho biết "Đang sử dụng kỹ năng: gemini-api-dev".
2. Xác minh tệp kê khai
Nếu tác nhân đưa ra câu trả lời chung chung, hãy dùng lệnh "discovery" (khám phá) cụ thể cho môi trường của bạn để xác minh rằng kỹ năng đã được tải.
| Môi trường | Phương thức xác minh |
|---|---|
| Claude Code | Nhập /skills vào thiết bị đầu cuối để liệt kê tất cả các tệp kê khai đang hoạt động. |
| Con trỏ | Mở phần Cài đặt > Quy tắc. Xác minh kỹ năng xuất hiện trong phần "Agent Decides" (Nhân viên quyết định). |
| Antigravity | Nhập /skills list hoặc kiểm tra thanh bên Tuỳ chỉnh > Quy tắc. |
| Gemini CLI | Chạy lệnh gemini skills list hoặc sử dụng lệnh dấu gạch chéo /skills trong phiên. |
| Copilot | Nhập @gemini /skills (hoặc chỉ nhập /skills) để xem các tiện ích đang hoạt động. |
Khắc phục sự cố
Nếu chỉ cung cấp thông tin chung hoặc không nhận ra các phương thức dành riêng cho Gemini, hãy kiểm tra những điều sau:
Tác nhân không phát hiện thấy kỹ năng
Hầu hết các tác nhân chỉ lập chỉ mục các kỹ năng khi khởi động.
Khắc phục: Khởi động lại hoàn toàn IDE (Cursor/VS Code) hoặc thoát rồi mở lại tác nhân dựa trên thiết bị đầu cuối (Claude Code).
Xung đột toàn cầu so với xung đột cục bộ
Nếu bạn cài đặt bằng cờ --global, thì tác nhân có thể bỏ qua cờ này để ưu tiên các quy tắc dành riêng cho dự án.
Khắc phục: Thử cài đặt kỹ năng trực tiếp vào thư mục gốc của dự án mà không cần cờ chung:
npx skills add google-gemini/gemini-skills --skill gemini-api-dev