513 lines
27 KiB
Markdown
513 lines
27 KiB
Markdown
# Hướng dẫn Nhanh bằng Hình ảnh (Visual Guide)
|
|
|
|
**Học qua hình ảnh!** Hướng dẫn này sử dụng các sơ đồ và ví dụ trực quan để giúp bạn hiểu về các kỹ năng (skills).
|
|
|
|
---
|
|
|
|
## Cái nhìn Tổng quan
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ BẠN (Lập trình viên) │
|
|
│ ↓ │
|
|
│ "Giúp tôi xây dựng hệ thống thanh toán" │
|
|
│ ↓ │
|
|
├─────────────────────────────────────────────────────────────┤
|
|
│ TRỢ LÝ AI (AI ASSISTANT) │
|
|
│ ↓ │
|
|
│ Tải kỹ năng @stripe-integration │
|
|
│ ↓ │
|
|
│ Trở thành chuyên gia về thanh toán Stripe │
|
|
│ ↓ │
|
|
│ Cung cấp hỗ trợ chuyên sâu kèm các ví dụ code │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## 📦 Cấu trúc Repository (Trực quan)
|
|
|
|
```
|
|
antigravity-awesome-skills/
|
|
│
|
|
├── 📄 README.md ← Tổng quan & danh sách skill
|
|
├── 📄 CONTRIBUTING.md ← Cách thức đóng góp
|
|
│
|
|
├── 📁 skills/ ← Nơi chứa tất cả hơn 250 skills
|
|
│ │
|
|
│ ├── 📁 brainstorming/
|
|
│ │ └── 📄 SKILL.md ← Định nghĩa skill
|
|
│ │
|
|
│ ├── 📁 stripe-integration/
|
|
│ │ ├── 📄 SKILL.md
|
|
│ │ └── 📁 examples/ ← Các phần bổ sung tùy chọn
|
|
│ │
|
|
│ └── ... (Hơn 250 skills khác)
|
|
│
|
|
├── 📁 scripts/ ← Quản lý & Xác thực
|
|
│ ├── validate_skills.py ← Công cụ kiểm soát chất lượng
|
|
│ └── generate_index.py ← Công cụ tạo danh mục (registry)
|
|
│
|
|
├── 📁 .github/
|
|
│ └── 📄 MAINTENANCE.md ← Hướng dẫn cho người duy trì
|
|
│
|
|
└── 📁 docs/ ← Tài liệu hướng dẫn
|
|
├── 📄 GETTING_STARTED.md ← Bắt đầu tại đây! (MỚI)
|
|
├── 📄 FAQ.md ← Giải đáp thắc mắc
|
|
├── 📄 BUNDLES.md ← Gói khởi đầu (MỚI)
|
|
├── 📄 QUALITY_BAR.md ← Tiêu chuẩn chất lượng
|
|
├── 📄 SKILL_ANATOMY.md ← Cách thức skill hoạt động
|
|
└── 📄 VISUAL_GUIDE.md ← Chính là file này!
|
|
```
|
|
|
|
---
|
|
|
|
## Cách Skills Hoạt động (Sơ đồ Luồng)
|
|
|
|
```
|
|
┌──────────────┐
|
|
│ 1. CÀI ĐẶT │ Sao chép skills vào .agent/skills/
|
|
1 └──────┬───────┘
|
|
│
|
|
↓
|
|
┌──────────────┐
|
|
│ 2. GỌI LỆNH │ Gõ: @ten-skill trong chat với AI
|
|
└──────┬───────┘
|
|
│
|
|
↓
|
|
┌──────────────┐
|
|
│ 3. TẢI DỮ LIỆU│ AI đọc file SKILL.md
|
|
└──────┬───────┘
|
|
│
|
|
↓
|
|
┌──────────────┐
|
|
│ 4. THỰC THI │ AI tuân theo hướng dẫn trong skill
|
|
└──────┬───────┘
|
|
│
|
|
↓
|
|
┌──────────────┐
|
|
│ 5. KẾT QUẢ │ Bạn nhận được hỗ trợ chuyên sâu!
|
|
└──────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 Phân loại Skills (Bản đồ Trực quan)
|
|
|
|
```
|
|
┌─────────────────────────┐
|
|
│ 250+ AWESOME SKILLS │
|
|
└────────────┬────────────┘
|
|
│
|
|
┌────────────────────────┼────────────────────────┐
|
|
│ │ │
|
|
┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
|
|
│ SÁNG TẠO│ │ PHÁT TRIỂN │ │ BẢO MẬT │
|
|
│ (10) │ │ (25) │ │ (50) │
|
|
└────┬────┘ └──────┬──────┘ └──────┬──────┘
|
|
│ │ │
|
|
• Thiết kế UI/UX • TDD • Hacking Đạo đức
|
|
• Nghệ thuật Canvas • Debugging • Metasploit
|
|
• Giao diện/Themes • Mẫu thiết kế React • Burp Suite
|
|
• SQLMap
|
|
│ │ │
|
|
└────────────────────────┼────────────────────────┘
|
|
│
|
|
┌────────────────────────┼────────────────────────┐
|
|
│ │ │
|
|
┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
|
|
│ AI │ │ TÀI LIỆU │ │ MARKETING │
|
|
│ (30) │ │ (4) │ │ (23) │
|
|
└────┬────┘ └──────┬──────┘ └──────┬──────┘
|
|
│ │ │
|
|
• Hệ thống RAG • DOCX • SEO
|
|
• LangGraph • PDF • Copywriting
|
|
• Prompt Eng. • PPTX • CRO
|
|
• Voice Agents • XLSX • Quảng cáo trả phí
|
|
```
|
|
|
|
---
|
|
|
|
## Cấu trúc File Skill (Trực quan)
|
|
|
|
````
|
|
┌─────────────────────────────────────────────────────────┐
|
|
│ SKILL.md │
|
|
├─────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ ┌───────────────────────────────────────────────┐ │
|
|
│ │ FRONTMATTER (Siêu dữ liệu) │ │
|
|
│ │ ───────────────────────────────────────────── │ │
|
|
│ │ --- │ │
|
|
│ │ name: my-skill │ │
|
|
│ │ description: "Công dụng của skill này" │ │
|
|
│ │ --- │ │
|
|
│ └───────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ ┌───────────────────────────────────────────────┐ │
|
|
│ │ NỘI DUNG (Hướng dẫn) │ │
|
|
│ │ ───────────────────────────────────────────── │ │
|
|
│ │ │ │
|
|
│ │ # Tiêu đề Skill │ │
|
|
│ │ │ │
|
|
│ │ ## Tổng quan │ │
|
|
│ │ Skill này làm gì... │ │
|
|
│ │ │ │
|
|
│ │ ## Khi nào nên dùng │ │
|
|
│ │ - Sử dụng khi... │ │
|
|
│ │ │ │
|
|
│ │ ## Hướng dẫn │ │
|
|
│ │ 1. Bước đầu tiên... │ │
|
|
│ │ 2. Bước thứ hai... │ │
|
|
│ │ │ │
|
|
│ │ ## Ví dụ │ │
|
|
│ │ ```javascript │ │
|
|
│ │ // Code ví dụ │ │
|
|
│ │ ``` │ │
|
|
│ │ │ │
|
|
│ └───────────────────────────────────────────────┘ │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────┘
|
|
````
|
|
|
|
---
|
|
|
|
## Cài đặt (Các bước Trực quan)
|
|
|
|
### Bước 1: Sao chép Repository
|
|
|
|
```
|
|
┌─────────────────────────────────────────┐
|
|
│ Terminal │
|
|
├─────────────────────────────────────────┤
|
|
│ $ git clone https://github.com/ │
|
|
│ sickn33/antigravity-awesome-skills │
|
|
│ .agent/skills │
|
|
│ │
|
|
│ ✓ Đang sao chép vào '.agent/skills'... │
|
|
│ ✓ Hoàn tất! │
|
|
└─────────────────────────────────────────┘
|
|
```
|
|
|
|
### Bước 2: Xác minh Cài đặt
|
|
|
|
```
|
|
┌─────────────────────────────────────────┐
|
|
│ File Explorer │
|
|
├─────────────────────────────────────────┤
|
|
│ 📁 .agent/ │
|
|
│ └── 📁 skills/ │
|
|
│ ├── 📁 brainstorming/ │
|
|
│ ├── 📁 stripe-integration/ │
|
|
│ ├── 📁 react-best-practices/ │
|
|
│ └── ... (Thêm 176 mục nữa) │
|
|
└─────────────────────────────────────────┘
|
|
```
|
|
|
|
### Bước 3: Sử dụng Skill
|
|
|
|
```
|
|
┌─────────────────────────────────────────┐
|
|
│ AI Assistant Chat │
|
|
├─────────────────────────────────────────┤
|
|
│ Bạn: @brainstorming giúp tôi thiết kế │
|
|
│ một ứng dụng todo │
|
|
│ │
|
|
│ AI: Tuyệt vời! Hãy để tôi giúp bạn suy │
|
|
│ nghĩ kỹ về việc này. Đầu tiên, hãy │
|
|
│ tìm hiểu các yêu cầu của bạn... │
|
|
│ │
|
|
│ Mục đích sử dụng chính là gì? │
|
|
│ a) Quản lý công việc cá nhân │
|
|
│ b) Hợp tác nhóm │
|
|
│ c) Lập kế hoạch dự án │
|
|
└─────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Ví dụ: Sử dụng Skill (Từng bước)
|
|
|
|
### Tình huống: Bạn muốn thêm thanh toán Stripe vào ứng dụng của mình
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ BƯỚC 1: Xác định Nhu cầu │
|
|
├─────────────────────────────────────────────────────────────┤
|
|
│ "Tôi cần thêm xử lý thanh toán vào ứng dụng của mình" │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
↓
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ BƯỚC 2: Tìm đúng Skill │
|
|
├─────────────────────────────────────────────────────────────┤
|
|
│ Tìm kiếm: "payment" hoặc "stripe" │
|
|
│ Tìm thấy: @stripe-integration │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
↓
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ BƯỚC 3: Gọi lệnh Skill │
|
|
├─────────────────────────────────────────────────────────────┤
|
|
│ Bạn: @stripe-integration giúp tôi thêm thanh toán định kỳ │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
↓
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ BƯỚC 4: AI Tải Kiến thức của Skill │
|
|
├─────────────────────────────────────────────────────────────┤
|
|
│ • Các mẫu Stripe API │
|
|
│ • Xử lý Webhook │
|
|
│ • Quản lý gói đăng ký (Subscription) │
|
|
│ • Thực hành tốt nhất │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
↓
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ BƯỚC 5: Nhận Hỗ trợ Chuyên gia │
|
|
├─────────────────────────────────────────────────────────────┤
|
|
│ AI cung cấp: │
|
|
│ • Các ví dụ code │
|
|
│ • Hướng dẫn thiết lập │
|
|
│ • Các lưu ý về bảo mật │
|
|
│ • Chiến lược kiểm thử │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Tìm kiếm Skills (Hướng dẫn Trực quan)
|
|
|
|
### Cách 1: Duyệt theo Danh mục
|
|
|
|
```
|
|
README.md → Cuộn xuống "Full Skill Registry" → Tìm danh mục → Chọn skill
|
|
```
|
|
|
|
### Cách 2: Tìm theo Từ khóa
|
|
|
|
```
|
|
Terminal → ls skills/ | grep "từ-khóa" → Xem các skill khớp
|
|
```
|
|
|
|
### Cách 3: Sử dụng Index
|
|
|
|
```
|
|
Mở file skills_index.json → Tìm từ khóa → Tìm đường dẫn đến skill
|
|
```
|
|
|
|
---
|
|
|
|
## Tạo Skill đầu tiên của bạn (Quy trình Trực quan)
|
|
|
|
```
|
|
┌──────────────┐
|
|
│ 1. Ý TƯỞNG │ "Tôi muốn chia sẻ kiến thức về Docker"
|
|
└──────┬───────┘
|
|
│
|
|
↓
|
|
┌──────────────┐
|
|
│ 2. KHỞI TẠO │ mkdir skills/docker-mastery
|
|
└──────┬───────┘ touch skills/docker-mastery/SKILL.md
|
|
│
|
|
↓
|
|
┌──────────────┐
|
|
│ 3. VIẾT │ Thêm frontmatter + nội dung
|
|
└──────┬───────┘ (Dùng template từ CONTRIBUTING.vi.md)
|
|
│
|
|
↓
|
|
┌──────────────┐
|
|
│ 4. KIỂM THỬ │ Sao chép vào .agent/skills/
|
|
└──────┬───────┘ Thử: @docker-mastery
|
|
│
|
|
↓
|
|
┌──────────────┐
|
|
│ 5. XÁC THỰC │ python3 scripts/validate_skills.py
|
|
└──────┬───────┘
|
|
│
|
|
↓
|
|
┌──────────────┐
|
|
│ 6. GỬI ĐI │ git commit + push + Pull Request
|
|
└──────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Các Cấp độ Phức tạp của Skill
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ ĐỘ PHỨC TẠP CỦA SKILL │
|
|
├─────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ ĐƠN GIẢN TIÊU CHUẨN PHỨC TẠP │
|
|
│ ──────── ────────── ──────── │
|
|
│ │
|
|
│ • 1 file • 1 file • Nhiều file│
|
|
│ • 100-200 từ • 300-800 từ • 800-2000 từ│
|
|
│ • Cấu trúc cơ bản • Cấu trúc đầy đủ • Có scripts │
|
|
│ • Không có phần phụ • Có ví dụ • Có ví dụ │
|
|
│ • Thực hành tốt nhất • Có template│
|
|
│ • Có tài liệu│
|
|
│ Ví dụ: Ví dụ: Ví dụ: │
|
|
│ git-pushing brainstorming loki-mode │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 Tác động của việc Đóng góp (Trực quan)
|
|
|
|
```
|
|
Sự đóng góp của bạn
|
|
│
|
|
├─→ Cải thiện tài liệu hướng dẫn
|
|
│ │
|
|
│ └─→ Giúp hàng ngàn dev dễ hiểu hơn
|
|
│
|
|
├─→ Tạo ra Skill mới
|
|
│ │
|
|
│ └─→ Mang lại khả năng mới cho mọi người
|
|
│
|
|
├─→ Sửa lỗi/Lỗi chính tả
|
|
│ │
|
|
│ └─→ Tránh hiểu lầm cho người dùng tương lai
|
|
│
|
|
└─→ Thêm ví dụ
|
|
│
|
|
└─→ Giúp người mới học dễ dàng hơn
|
|
```
|
|
|
|
---
|
|
|
|
## Lộ trình Học tập (Roadmap Trực quan)
|
|
|
|
```
|
|
BẮT ĐẦU TẠI ĐÂY
|
|
│
|
|
↓
|
|
┌─────────────────┐
|
|
│ Đọc │
|
|
│ GETTING_STARTED │
|
|
└────────┬────────┘
|
|
│
|
|
↓
|
|
┌─────────────────┐
|
|
│ Thử dùng 2-3 Skill│
|
|
│ với Trợ lý AI │
|
|
└────────┬────────┘
|
|
│
|
|
↓
|
|
┌─────────────────┐
|
|
│ Đọc │
|
|
│ SKILL_ANATOMY │
|
|
└────────┬────────┘
|
|
│
|
|
↓
|
|
┌─────────────────┐
|
|
│ Nghiên cứu │
|
|
│ Skills hiện có │
|
|
└────────┬────────┘
|
|
│
|
|
↓
|
|
┌─────────────────┐
|
|
│ Tạo Skill │
|
|
│ đơn giản │
|
|
└────────┬────────┘
|
|
│
|
|
↓
|
|
┌─────────────────┐
|
|
│ Đọc │
|
|
│ CONTRIBUTING │
|
|
└────────┬────────┘
|
|
│
|
|
↓
|
|
┌─────────────────┐
|
|
│ Gửi PR │
|
|
└────────┬────────┘
|
|
│
|
|
↓
|
|
TRỞ THÀNH CONTRIBUTOR! 🎉
|
|
```
|
|
|
|
---
|
|
|
|
## 💡 Mẹo Nhanh (Bản ghi chú Trực quan)
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ THAM KHẢO NHANH │
|
|
├─────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ 📥 CÀI ĐẶT │
|
|
│ git clone [repo] .agent/skills │
|
|
│ │
|
|
│ 🎯 SỬ DỤNG │
|
|
│ @ten-skill [yêu cầu của bạn] │
|
|
│ │
|
|
│ 🔍 TÌM KIẾM │
|
|
│ ls skills/ | grep "từ-khóa" │
|
|
│ │
|
|
│ ✅ XÁC THỰC │
|
|
│ python3 scripts/validate_skills.py │
|
|
│ │
|
|
│ 📝 TẠO SKILL │
|
|
│ 1. mkdir skills/ten-skill-cua-ban │
|
|
│ 2. Tạo SKILL.md với frontmatter │
|
|
│ 3. Thêm nội dung │
|
|
│ 4. Thử nghiệm & xác thực │
|
|
│ 5. Gửi Pull Request (PR) │
|
|
│ │
|
|
│ 🆘 TRỢ GIÚP │
|
|
│ • docs/GETTING_STARTED.md - Cơ bản │
|
|
│ • CONTRIBUTING.md - Cách đóng góp │
|
|
│ • SKILL_ANATOMY.md - Tìm hiểu sâu │
|
|
│ • GitHub Issues - Đặt câu hỏi │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Câu chuyện Thành công (Dòng thời gian Trực quan)
|
|
|
|
```
|
|
Ngày 1: Cài đặt skills
|
|
│
|
|
└─→ "Oa, @brainstorming đã giúp mình thiết kế ứng dụng!"
|
|
|
|
Ngày 3: Dùng 5 skills khác nhau
|
|
│
|
|
└─→ "Những kỹ năng này giúp mình tiết kiệm bao nhiêu thời gian!"
|
|
|
|
Tuần 1: Tạo skill đầu tiên
|
|
│
|
|
└─→ "Mình đã chia sẻ kiến thức của mình dưới dạng một skill!"
|
|
|
|
Tuần 2: Skill được gộp (merge) vào máy chủ
|
|
│
|
|
└─→ "Kỹ năng của mình đang giúp đỡ người khác! 🎉"
|
|
|
|
Tháng 1: Trở thành người đóng góp thường xuyên
|
|
│
|
|
└─→ "Mình đã đóng góp 5 skills và cải thiện rất nhiều tài liệu!"
|
|
```
|
|
|
|
---
|
|
|
|
## Các Bước Tiếp theo
|
|
|
|
1. ✅ **Hiểu** cấu trúc trực quan.
|
|
2. ✅ **Cài đặt** skills vào công cụ AI của bạn.
|
|
3. ✅ **Thử dùng** 2-3 skills từ các danh mục khác nhau.
|
|
4. ✅ **Đọc** file CONTRIBUTING.md.
|
|
5. ✅ **Tạo** skill đầu tiên của bạn.
|
|
6. ✅ **Chia sẻ** với cộng đồng.
|
|
|
|
---
|
|
|
|
**Bạn là người học qua hình ảnh?** Hy vọng hướng dẫn này sẽ giúp ích! Bạn vẫn còn thắc mắc? Hãy kiểm tra:
|
|
|
|
- [GETTING_STARTED.md](GETTING_STARTED.vi.md) - Giới thiệu bằng văn bản.
|
|
- [SKILL_ANATOMY.md](SKILL_ANATOMY.vi.md) - Phân tích chi tiết.
|
|
- [CONTRIBUTING.md](../CONTRIBUTING.vi.md) - Cách thức đóng góp.
|
|
|
|
**Sẵn sàng đóng góp?** Bạn làm được mà! 💪
|