# ❓ Câu hỏi thường gặp (FAQ)

**Bạn có thắc mắc?** Bạn không hề cô đơn! Dưới đây là câu trả lời cho những câu hỏi thường gặp nhất về Antigravity Awesome Skills.

---

## 🎯 Câu hỏi Chung

### "Skills" (kỹ năng) chính xác là gì?

Skills là các tệp hướng dẫn chuyên biệt dạy cho các trợ lý AI cách xử lý những tác vụ cụ thể. Hãy coi chúng như những mô-đun kiến thức chuyên gia mà AI của bạn có thể tải khi cần.  
**Một so sánh đơn giản:** Giống như việc bạn tham khảo ý kiến của các chuyên gia khác nhau (luật sư, bác sĩ, thợ máy), những kỹ năng này giúp AI của bạn trở thành chuyên gia trong các lĩnh vực khác nhau khi bạn cần.

### Tôi có cần phải cài đặt tất cả hơn 560 skills không?

**Không!** Khi bạn clone (tải bản sao) repository này, tất cả các kỹ năng đều có sẵn, nhưng AI của bạn chỉ tải chúng khi bạn yêu cầu rõ ràng bằng lệnh `@ten-skill`.  
Nó giống như việc sở hữu một thư viện - tất cả sách đều ở đó, nhưng bạn chỉ đọc những cuốn bạn cần thôi.  
**Mẹo:** Sử dụng [Bản mẫu Khởi đầu (Starter Packs)](BUNDLES.vi.md) để chỉ cài đặt những gì phù hợp với vai trò của bạn.

### Những công cụ AI nào hoạt động với các kỹ năng này?

- ✅ **Claude Code** (Dòng lệnh CLI của Anthropic)
- ✅ **Gemini CLI** (Google)
- ✅ **Codex CLI** (OpenAI)
- ✅ **Cursor** (IDE tích hợp AI)
- ✅ **Antigravity IDE**
- ✅ **OpenCode**
- ⚠️ **GitHub Copilot** (Hỗ trợ một phần qua việc copy-paste)

### Những kỹ năng này có được sử dụng miễn phí không?

**Có!** Repository này được cấp phép theo giấy phép MIT License.

- ✅ Miễn phí cho sử dụng cá nhân.
- ✅ Miễn phí cho sử dụng thương mại.
- ✅ Bạn có thể sửa đổi chúng.

### Các kỹ năng có hoạt động ngoại tuyến (offline) không?

Bản thân các file skill được lưu trữ cục bộ trên máy tính của bạn, nhưng trợ lý AI của bạn vẫn cần kết nối internet để hoạt động.

---

## 🔒 Bảo mật & Tin cậy (Cập nhật V4)

### Các Nhãn rủi ro (Risk Labels) có ý nghĩa gì?

Chúng tôi phân loại các kỹ năng để bạn biết mình đang chạy cái gì:

- ⚪ **Safe (Trắng/Xanh)**: Các kỹ năng chỉ đọc, lập kế hoạch hoặc vô hại.
- 🔴 **Risk (Đỏ)**: Các kỹ năng sửa đổi file (xóa), sử dụng công cụ quét mạng, hoặc thực hiện các hành động có tính phá hủy. **Hãy sử dụng thận trọng.**
- 🟣 **Official (Tím)**: Được duy trì bởi các nhà cung cấp tin cậy (Anthropic, DeepMind, v.v.).

### Những kỹ năng này có thể hack máy tính của tôi không?

**Không.** Kỹ năng là các file văn bản. Tuy nhiên, chúng *hướng dẫn* AI chạy các dòng lệnh. Nếu một skill nói "xóa toàn bộ file", một AI tuân thủ có thể sẽ thử làm việc đó.  
_Luôn kiểm tra nhãn rủi ro và xem xét mã nguồn trước khi dùng._

---

## 📦 Cài đặt & Thiết lập

### Tôi nên cài đặt các kỹ năng này ở đâu?

Đường dẫn phổ biến nhất hoạt động với mạng lưới các công cụ AI là `.agent/skills/`:

```bash
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
```

**Các đường dẫn cụ thể cho từng công cụ:**

- Claude Code: `.claude/skills/`
- Gemini CLI: `.gemini/skills/`
- Cursor: `.cursor/skills/` hoặc gốc của dự án.

### Repo này có hoạt động trên Windows không?

**Có**, nhưng một số kỹ năng "Official" (chính thức) sử dụng **symlinks** (liên kết tượng trưng) mà Windows xử lý không tốt theo mặc định.  
Hãy chạy git clone với lệnh sau:

```bash
git clone -c core.symlinks=true https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
```

Hoặc bật "Chế độ Nhà phát triển" (Developer Mode) trong phần Cài đặt của Windows.

### Làm thế nào để cập nhật các kỹ năng?

Chuyển hướng đến thư mục chứa kỹ năng của bạn và kéo (pull) những thay đổi mới nhất:

```bash
cd .agent/skills
git pull origin main
```

---

## 🛠️ Cách sử dụng Skills

### Làm thế nào để gọi một kỹ năng?

Sử dụng biểu tượng `@` theo sau là tên skill:

```bash
@brainstorming giúp tôi thiết kế một ứng dụng todo
```

### Tôi có thể dùng nhiều kỹ năng cùng một lúc không?

**Có!** Bạn có thể gọi nhiều kỹ năng:

```bash
@brainstorming giúp tôi thiết kế phần này, sau đó dùng @writing-plans để tạo danh sách nhiệm vụ.
```

### Làm thế nào để tôi biết nên dùng kỹ năng nào?

1. **Duyệt qua danh mục**: Xem [Danh mục Skill (Skill Catalog)](../CATALOG.vi.md).
2. **Tìm kiếm**: `ls skills/ | grep "từ-khóa"`
3. **Hỏi AI của bạn**: "Bạn có kỹ năng nào để kiểm thử (testing) không?"

---

## 🏗️ Xử lý sự cố

### Trợ lý AI của tôi không nhận diện được kỹ năng

**Các nguyên nhân có thể xảy ra:**

1. **Sai đường dẫn cài đặt**: Kiểm tra tài liệu hướng dẫn của công cụ bạn dùng. Hãy thử `.agent/skills/`.
2. **Cần khởi động lại**: Khởi động lại AI/IDE sau khi cài đặt.
3. **Lỗi đánh máy**: Bạn có gõ lầm `@brain-storming` thay vì `@brainstorming` không?

### Một kỹ năng đưa ra lời khuyên sai hoặc lỗi thời

Hãy [Mở một issue](https://github.com/sickn33/antigravity-awesome-skills/issues)!  
Vui lòng gửi kèm:

- Skill nào?
- Điều gì đã xảy ra?
- Đáng lẽ điều gì nên xảy ra?

---

## 🤝 Đóng góp

### Tôi là người mới đối với mã nguồn mở. Tôi có thể đóng góp không?

**Chắc chắn là có!** Chúng tôi chào đón những người mới bắt đầu.

- Sửa lỗi đánh máy.
- Thêm ví dụ.
- Cải thiện tài liệu hướng dẫn.  
Hãy xem [CONTRIBUTING.md](../CONTRIBUTING.vi.md) để biết hướng dẫn chi tiết.

### Pull Request (PR) của tôi thất bại khi kiểm tra "Quality Bar". Tại sao?

Phiên bản V3 áp dụng kiểm soát chất lượng tự động. Skill của bạn có thể đang thiếu:

1. Một `description` (mô tả) hợp lệ.
2. Các ví dụ sử dụng.  
Hãy chạy `python3 scripts/validate_skills.py` cục bộ để kiểm tra trước khi đẩy code lên.

### Tôi có thể cập nhật các kỹ năng "Official" không?

**Không.** Các kỹ năng chính thức (trong thư mục `skills/official/`) được đồng bộ từ các nhà cung cấp. Thay vào đó, hãy mở một issue để báo lỗi.

---

## 💡 Mẹo Chuyên nghiệp

- Bắt đầu với `@brainstorming` trước khi xây dựng bất kỳ thứ gì mới.
- Sử dụng `@systematic-debugging` khi gặp lỗi khó nhằn.
- Thử `@test-driven-development` để code có chất lượng tốt hơn.
- Khám phá `@skill-creator` để tự tạo kỹ năng của riêng bạn.

**Vẫn còn thắc mắc?** [Mở một cuộc thảo luận (Discussion)](https://github.com/sickn33/antigravity-awesome-skills/discussions) và chúng tôi sẽ giúp bạn! 🙌
