firefrost-gaming/antigravity-skills-reference
3
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

docs: add complete Vietnamese translation for core documentation (Phase 2)

Browse Source
This commit is contained in:
Đỗ Khắc Gia Khoa
2026-01-27 20:06:26 +07:00
parent 2917fd235d
commit a3acb446fb
9 changed files with 1718 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

148
docs/BUNDLES.vi.md Normal file
View File

@@ -0,0 +1,148 @@
# 📦 Các Gói Skill Của Antigravity (Bundles)
Không biết bắt đầu từ đâu? Đừng lo. Hãy chọn ngay một gói (Bundle) bên dưới để sở hữu bộ kỹ năng "trấn phái" phù hợp nhất với vai trò của bạn.
---
## 🚀 Gói "Cơ Bản" (The Essentials Starter Pack)
_Dành cho tất cả mọi người. Mới nhập môn thì cài bộ này trước._
- `concise-planning`: Luôn bắt đầu mọi việc bằng một kế hoạch ngắn gọn.
- `lint-and-validate`: Tự động giữ cho code sạch đẹp.
- `git-pushing`: Lưu trữ kết quả làm việc an toàn lên Git.
- `kaizen`: Tư duy cải tiến liên tục (nhỏ nhưng đều đặn).
---
## 🛡️ Gói "Kỹ Sư Bảo Mật" (The Security Engineer Pack)
_Dành cho pentester, chuyên gia audit và hacker mũ trắng._
- `ethical-hacking-methodology`: Cuốn "Kinh Thánh" về ethical hacking.
- `burp-suite-testing`: Quét lỗ hổng bảo mật Web.
- `owasp-top-10`: Kiểm tra nhanh các lỗi bảo mật phổ biến nhất.
- `linux-privilege-escalation`: Đánh giá bảo mật nâng cao cho Linux.
- `cloud-penetration-testing`: Bảo mật đám mây AWS/Azure/GCP.
---
## 🌐 Gói "Phù Thủy Web" (The Web Wizard Pack)
_Dành cho anh em Dev xây dựng các web app hiện đại, hiệu năng cao._
- `frontend-design`: Hướng dẫn về thẩm mỹ và nguyên tắc UI.
- `react-patterns`: Các bài thực hành tốt nhất (best practices) cho React.
- `tailwind-mastery`: Làm chủ CSS siêu tốc.
- `form-cro`: Tối ưu hóa các biểu mẫu (form) để tăng tỷ lệ chuyển đổi.
- `seo-audit`: Giúp web của bạn lên top Google.
---
## 🤖 Gói "Kiến Trúc Sư AI" (The Agent Architect Pack)
_Dành cho người xây dựng hệ thống AI._
- `agent-evaluation`: Kiểm thử và đánh giá Agent của bạn.
- `langgraph`: Xây dựng các luồng agent có trạng thái (stateful).
- `mcp-builder`: Tự chế tạo công cụ (tools) riêng cho AI.
- `prompt-engineering`: Làm chủ nghệ thuật ra lệnh cho LLM.
---
## 🎮 Gói "Làm Game Indie" (The Indie Game Dev Pack)
_Dành cho người làm game với sự trợ giúp của AI._
- `game-development/game-design`: Cơ chế và vòng lặp game (game loops).
- `game-development/2d-games`: Sprites và vật lý 2D.
- `game-development/3d-games`: Mô hình và đổ bóng (shaders) 3D.
- `game-development/unity-csharp`: Làm chủ C# scripting trong Unity.
- `algorithmic-art`: Tạo tài nguyên game bằng code nghệ thuật.
---
## 🐍 Gói "Trùm Python" (The Python Pro Pack)
_Dành cho đội Backend và khoa học dữ liệu._
- `python-patterns`: Viết code Python chuẩn chỉ (idiomatic).
- `poetry-manager`: Quản lý thư viện phụ thuộc (dependency) "không đau đầu".
- `pytest-mastery`: Làm chủ các framework kiểm thử.
- `fastapi-expert`: Xây dựng API hiệu năng cao.
- `django-guide`: Framework "pin trâu" cho mọi tính năng (batteries-included).
---
## 🦄 Gói "Khởi Nghiệp" (The Startup Founder Pack)
_Dành cho người xây sản phẩm, không chỉ mỗi code._
- `product-requirements-doc`: Định nghĩa rõ những gì cần làm.
- `competitor-analysis`: Biết người biết ta, trăm trận trăm thắng.
- `pitch-deck-creator`: Gọi vốn (hoặc đơn giản là trình bày ý tưởng).
- `landing-page-copy`: Viết nội dung bán hàng "đi vào lòng người".
- `stripe-integration`: Tích hợp thanh toán để lụm tiền.
---
## 🌧️ Gói "DevOps & Cloud" (The DevOps Pack)
_Dành cho người lo hạ tầng và mở rộng hệ thống._
- `docker-expert`: Bậc thầy về container.
- `aws-serverless`: Triển khai không máy chủ trên AWS (Lambda, DynamoDB).
- `environment-setup-guide`: Chuẩn hóa môi trường cho cả team.
- `deployment-procedures`: Chiến lược rollout an toàn.
- `bash-linux`: Phù thủy dòng lệnh Terminal.
---
## 📊 Gói "Dữ Liệu & Phân Tích" (The Data Pack)
_Dành cho người thích các con số._
- `analytics-tracking`: Cài đặt GA4/PostHog chuẩn ngay từ đầu.
- `d3-viz`: Vẽ biểu đồ tùy chỉnh tuyệt đẹp.
- `sql-mastery`: Viết câu truy vấn (query) tối ưu.
- `ab-test-setup`: Học hỏi dựa trên dữ liệu thực tế.
---
## 🎨 Gói "Giám Đốc Sáng Tạo" (The Creative Director Pack)
_Dành cho hình ảnh, nội dung và thương hiệu._
- `canvas-design`: Tạo poster và sơ đồ.
- `frontend-design`: Thẩm mỹ giao diện.
- `content-creator`: Viết blog chuẩn SEO.
- `copy-editing`: Chuốt lại câu từ cho mượt.
- `algorithmic-art`: Tạo kiệt tác bằng code.
---
## 🐞 Gói "Kiểm Thử & QA" (The QA & Testing Pack)
_Dành cho người "đập phá" trước khi người dùng kịp làm._
- `test-driven-development`: Quy trình Đỏ, Xanh, Refactor.
- `systematic-debugging`: Thám tử Sherlock Holmes trong làng code.
- `browser-automation`: Test toàn trình (E2E) với Playwright.
- `ab-test-setup`: Thử nghiệm có kiểm chứng.
- `code-review-checklist`: Bắt lỗi ngay trong Pull Request.
---
## 🖌️ Gói "Thiết Kế Web" (The Web Designer Pack)
_Dành cho trải nghiệm điểm ảnh hoàn hảo (pixel-perfect)._
- `ui-ux-pro-max`: Hệ thống thiết kế (Design systems) cao cấp.
- `frontend-design`: Nền tảng của cái đẹp.
- `3d-web-experience`: Ma thuật với Three.js & R3F.
- `canvas-design`: Hình ảnh tĩnh/poster.
- `responsive-layout`: Nguyên tắc "Mobile-first" (Di động trước tiên).
---
_Để sử dụng một gói, bạn chỉ cần copy tên các skill vào thư mục `.agent/skills` hoặc gọi chúng trực tiếp với agent của bạn nhé._

56
docs/EXAMPLES.vi.md Normal file
View File

@@ -0,0 +1,56 @@
# 🧪 Ví Dụ Thực Tế ("Sách dạy nấu ăn Antigravity")
Skill đứng một mình đã mạnh, nhưng khi kết hợp lại thì "vô đối".
Dưới đây là 3 kịch bản phổ biến và cách giải quyết chúng bằng kho tàng này.
## 🥘 Công thức 1: "Kiểm toán Code cũ" (The Legacy Code Audit)
_Tình huống: Bạn vừa phải nhận lại một dự án Node.js 5 năm tuổi siêu lộn xộn. Bạn cần dọn dẹp nó một cách an toàn._
**Các Skill cần dùng:**
1. `concise-planning` (Để vẽ bản đồ cho đống hỗn độn)
2. `lint-and-validate` (Để tìm lỗi)
3. `security-review` (Để tìm lỗ hổng)
**Quy trình (Workflow):**
1. **Lập kế hoạch**: "Này Agent, dùng `concise-planning` để tạo checklist refactor lại thư mục `src/legacy-api.js` cho tôi."
2. **Kiểm toán**: "Chạy `security-review` trên file `package.json` để xem có thư viện nào dính lỗi bảo mật không."
3. **Sửa lỗi**: "Dùng các quy tắc của `lint-and-validate` để tự sửa lỗi định dạng trong thư mục `src/`."
---
## 🥘 Công thức 2: "Web App Hiện Đại" (The Modern Web App)
_Tình huống: Bạn cần dựng một trang Landing Page có hiệu năng cao trong vòng 2 tiếng._
**Các Skill cần dùng:**
1. `frontend-design` (Để lo phần thẩm mỹ)
2. `react-patterns` (Để lo phần cấu trúc code)
3. `tailwind-mastery` (Để code giao diện siêu tốc)
**Quy trình (Workflow):**
1. **Thiết kế**: "Dùng `frontend-design` tạo cho tôi một bảng màu và font chữ theo phong cách 'Quán Cà phê Cyberpunk'."
2. **Dựng khung**: "Khởi tạo dự án Vite. Sau đó áp dụng `react-patterns` để viết component 'Hero'."
3. **Tạo kiểu**: "Dùng `tailwind-mastery` làm cho mấy cái nút bấm có hiệu ứng kính (glassmorphism) và chuẩn mobile giúp tôi."
---
## 🥘 Công thức 3: "Kiến Trúc Sư Agent" (The Agent Architect)
_Tình huống: Bạn muốn xây một con AI agent riêng có khả năng tự kiểm tra code của chính nó._
**Các Skill cần dùng:**
1. `mcp-builder` (Để xây công cụ)
2. `agent-evaluation` (Để kiểm tra độ tin cậy)
3. `prompt-engineering` (Để tinh chỉnh câu lệnh)
**Quy trình (Workflow):**
1. **Xây dựng**: "Dùng `mcp-builder` để tạo một công cụ tên là `verify-file`."
2. **Ra lệnh**: "Áp dụng các mẫu `prompt-engineering` vào System Prompt để đảm bảo con agent luôn kiểm tra đường dẫn file trước khi làm gì đó."
3. **Kiểm thử**: "Chạy `agent-evaluation` để đo xem tần suất con agent này tìm sai file là bao nhiêu phần trăm."

21
docs/SOURCES.vi.md Normal file
View File

@@ -0,0 +1,21 @@
# 📜 Nguồn Tham Khảo & Ghi Nhận
Chúng tôi tin vào việc tôn trọng quyền tác giả và nguồn gốc tri thức.
Nếu bạn thấy tác phẩm của mình ở đây mà chưa được ghi nhận xứng đáng, vui lòng mở Issue để chúng tôi cập nhật.
| Skill / Danh mục | Nguồn Gốc | Giấy Phép | Ghi chú |
| :-------------------------- | :----------------------------------------------------- | :------------- | :---------------------------- |
| `cloud-penetration-testing` | [HackTricks](https://book.hacktricks.xyz/) | MIT / CC-BY-SA | Đã điều chỉnh cho Agent dùng. |
| `active-directory-attacks` | [HackTricks](https://book.hacktricks.xyz/) | MIT / CC-BY-SA | Đã điều chỉnh cho Agent dùng. |
| `owasp-top-10` | [OWASP](https://owasp.org/) | CC-BY-SA | Phương pháp luận đã điều chỉnh.|
| `burp-suite-testing` | [PortSwigger](https://portswigger.net/burp) | N/A | Chỉ hướng dẫn sử dụng (không kèm phần mềm). |
| `crewai` | [CrewAI](https://github.com/joaomdmoura/crewAI) | MIT | Hướng dẫn Framework. |
| `langgraph` | [LangGraph](https://github.com/langchain-ai/langgraph) | MIT | Hướng dẫn Framework. |
| `react-patterns` | [React Docs](https://react.dev/) | CC-BY | Các mẫu chính thức. |
| **Các Skill Official** | [Anthropic / Google / OpenAI] | Độc quyền | Được khuyến khích sử dụng bởi nhà cung cấp. |
## Chính sách Giấy phép
- **Mã nguồn (Code)**: Tất cả code gốc trong repo này là **MIT**.
- **Nội dung (Content)**: Tài liệu là **CC-BY-4.0**.
- **Bên thứ ba**: Chúng tôi tôn trọng giấy phép gốc. Nếu một skill được import là GPL, nó sẽ được ghi chú rõ ràng hoặc loại bỏ (chúng tôi ưu tiên tương thích MIT/Apache).

486
docs/VISUAL_GUIDE.vi.md Normal file
View File

@@ -0,0 +1,486 @@
# Hướng Dẫn Nhanh Bằng Hình Ảnh (Visual Quick Start)
**Trăm nghe không bằng một thấy!** Hướng dẫn này sử dụng sơ đồ và ví dụ trực quan để giúp bạn hiểu cách hoạt động của Skills.
---
## Bức Tranh Toàn Cảnh
```
┌─────────────────────────────────────────────────────────────┐
│ BẠN (Lập trình viên) │
│ ↓ │
│ "Giúp tôi xây dựng hệ thống thanh toán nhé" │
│ ↓ │
1├─────────────────────────────────────────────────────────────┤
│ TRỢ LÝ AI │
│ ↓ │
│ Nạp skill @stripe-integration │
│ ↓ │
│ Trở thành chuyên gia thanh toán Stripe │
│ ↓ │
│ Cung cấp hướng dẫn chuyên sâu kèm code mẫu │
│ ↓ │
└─────────────────────────────────────────────────────────────┘
```
---
## 📦 Cấu trúc Thư mục (Trực quan)
```
antigravity-awesome-skills/
│
├── 📄 README.vi.md ← Tổng quan & Danh sách (Bắt đầu ở đây)
├── 📄 GETTING_STARTED.vi.md ← Hướng dẫn nhập môn
├── 📄 CONTRIBUTING.vi.md ← Hướng dẫn đóng góp
├── 📄 FAQ.vi.md ← Câu hỏi thường gặp
│
├── 📁 skills/ ← Hơn 250 skill nằm ở đây
│ │
│ ├── 📁 brainstorming/
│ │ └── 📄 SKILL.md ← Định nghĩa Skill
│ │
│ ├── 📁 stripe-integration/
│ │ ├── 📄 SKILL.md
│ │ └── 📁 examples/ ← Các ví dụ đi kèm
│ │
│ └── ... (250+ skill khác)
│
├── 📁 scripts/ ← Các công cụ quản lý
│ ├── validate_skills.py ← Trình kiểm tra chất lượng
│ └── generate_index.py ← Trình tạo mục lục
│
├── 📁 .github/
│ └── 📄 MAINTENANCE.md ← Hướng dẫn bảo trì
│
└── 📁 docs/ ← Tài liệu
├── 📄 BUNDLES.vi.md ← Gói khởi điểm (Starter Packs)
├── 📄 QUALITY_BAR.md ← Tiêu chuẩn chất lượng
├── 📄 SKILL_ANATOMY.md ← Cấu tạo của một skill
└── 📄 VISUAL_GUIDE.vi.md ← Chính là file này!
```
---
## Cách Skill hoạt động (Sơ đồ luồng)
```
┌──────────────┐
│ 1. CÀI ĐẶT │ Copy skills vào thư mục .agent/skills/
└──────┬───────┘
│
↓
┌──────────────┐
│ 2. RA LỆNH │ Gõ: @ten-skill trong khung chat với AI
└──────┬───────┘
│
↓
┌──────────────┐
│ 3. NẠP │ AI đọc nội dung file SKILL.md
└──────┬───────┘
│
↓
┌──────────────┐
│ 4. THỰC THI │ AI làm theo hướng dẫn trong skill
└──────┬───────┘
│
↓
┌──────────────┐
│ 5. KẾT QUẢ │ Bạn nhận được sự hỗ trợ chuyên sâu!
└──────────────┘
```
---
## 🎯 Phân loại Skill (Bản đồ tư duy)
```
┌─────────────────────────┐
│ 250+ SKILL TUYỆT ĐỈNH │
└────────────┬────────────┘
│
┌────────────────────────┼────────────────────────┐
│ │ │
┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
│ SÁNG TẠO│ │ PHÁT TRIỂN │ │ BẢO MẬT │
│ (10) │ │ (25) │ │ (50) │
└────┬────┘ └──────┬──────┘ └──────┬──────┘
│ │ │
• Thiết kế UI/UX • TDD (Test) • Ethical Hacking
• Nghệ thuật Canvas • Debugging • Metasploit
• Tạo Theme • React Patterns • Burp Suite
• SQLMap
│ │ │
└────────────────────────┼────────────────────────┘
│
┌────────────────────────┼────────────────────────┐
│ │ │
┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
│ AI │ │ TÀI LIỆU │ │ MARKETING │
│ (30) │ │ (4) │ │ (23) │
└────┬────┘ └──────┬──────┘ └──────┬──────┘
│ │ │
• Hệ thống RAG • DOCX • SEO
• LangGraph • PDF • Viết quảng cáo
• Prompt Eng. • PPTX • CRO
• Voice Agents • XLSX • Chạy Ads
```
---
## Giải phẫu một Skill
````
┌─────────────────────────────────────────────────────────┐
│ SKILL.md │
├─────────────────────────────────────────────────────────┤
│ │
│ ┌───────────────────────────────────────────────┐ │
│ │ FRONTMATTER (Metadata - Dữ liệu mô tả) │ │
│ │ ───────────────────────────────────────────── │ │
│ │ --- │ │
│ │ name: my-skill │ │
│ │ description: "Skill này làm cái gì" │ │
│ │ --- │ │
│ └───────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────┐ │
│ │ CONTENT (Nội dung hướng dẫn) │ │
│ │ ───────────────────────────────────────────── │ │
│ │ │ │
│ │ # Tên Skill │ │
│ │ │ │
│ │ ## Tổng quan │ │
│ │ Skill này giúp bạn... │ │
│ │ │ │
│ │ ## Khi nào dùng │ │
│ │ - Dùng khi... │ │
│ │ │ │
│ │ ## Hướng dẫn │ │
│ │ 1. Bước một... │ │
│ │ 2. Bước hai... │ │
│ │ │ │
│ │ ## Ví dụ │ │
│ │ ```javascript │ │
│ │ // Code mẫu │ │
│ │ ``` │ │
│ │ │ │
│ └───────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
````
---
## Quy trình cài đặt (Các bước trực quan)
### Bước 1: Clone Repo về máy
```
┌─────────────────────────────────────────┐
│ Terminal (Dòng lệnh) │
├─────────────────────────────────────────┤
│ $ git clone https://github.com/ │
│ sickn33/antigravity-awesome-skills │
│ .agent/skills │
│ │
│ ✓ Cloning into '.agent/skills'... │
│ ✓ Done! │
1└─────────────────────────────────────────┘
```
### Bước 2: Kiểm tra cài đặt
```
┌─────────────────────────────────────────┐
│ File Explorer (Quản lý file) │
├─────────────────────────────────────────┤
│ 📁 .agent/ │
│ └── 📁 skills/ │
│ ├── 📁 brainstorming/ │
│ ├── 📁 stripe-integration/ │
│ ├── 📁 react-best-practices/ │
│ └── ... (250+ cái nữa) │
└─────────────────────────────────────────┘
```
### Bước 3: Sử dụng Skill
```
┌─────────────────────────────────────────┐
│ AI Assistant Chat │
├─────────────────────────────────────────┤
│ Bạn: @brainstorming giúp tôi thiết kế │
│ một cái app to-do list │
│ │
│ AI: Tuyệt! Để tôi giúp bạn suy nghĩ. │
│ Trước tiên, hãy xác định yêu cầu. │
│ │
│ Mục đích chính là gì? │
│ a) Quản lý việc cá nhân │
│ b) Cộng tác nhóm │
│ c) Lập kế hoạch dự án │
└─────────────────────────────────────────┘
```
---
## Ví dụ: Một phiên làm việc thực tế
### Tình huống: Bạn muốn tích hợp thanh toán Stripe
```
┌─────────────────────────────────────────────────────────────┐
│ BƯỚC 1: Xác định nhu cầu │
├─────────────────────────────────────────────────────────────┤
│ "Tôi cần thêm tính năng thanh toán vào app" │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ BƯỚC 2: Tìm Skill phù hợp │
├─────────────────────────────────────────────────────────────┤
│ Tìm kiếm: "payment" hoặc "stripe" │
│ Tìm thấy: @stripe-integration │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ BƯỚC 3: Gọi Skill │
├─────────────────────────────────────────────────────────────┤
│ Bạn: @stripe-integration giúp tôi thêm tính năng gói subs │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ BƯỚC 4: AI nạp kiến thức │
├─────────────────────────────────────────────────────────────┤
│ • Các pattern API của Stripe │
│ • Xử lý Webhook │
│ • Quản lý gói đăng ký (Subscription) │
│ • Các bài thực hành tốt nhất (Best practices) │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ BƯỚC 5: Nhận hỗ trợ chuyên gia │
├─────────────────────────────────────────────────────────────┤
│ AI cung cấp: │
│ • Code mẫu │
│ • Hướng dẫn cài đặt │
│ • Lưu ý bảo mật │
│ • Chiến lược kiểm thử (Testing) │
└─────────────────────────────────────────────────────────────┘
```
---
## Cách tìm kiếm Skill (Hướng dẫn hình ảnh)
### Cách 1: Duyệt theo Danh mục
```
README.vi.md → Cuộn xuống "Danh sách Skill đầy đủ" → Tìm nhóm → Chọn skill
```
### Cách 2: Tìm theo từ khóa
```
Terminal → ls skills/ | grep "từ-khóa" → Thấy các skill khớp
```
### Cách 3: Dùng file Index
```
Mở skills_index.json → Ctrl+F tìm từ khóa → Lấy đường dẫn skill
```
---
## Quy trình tạo Skill đầu tay của bạn
```
┌──────────────┐
│ 1. Ý TƯỞNG │ "Tôi muốn chia sẻ kiến thức Docker của mình"
└──────┬───────┘
│
↓
┌──────────────┐
│ 2. TẠO FOLDER│ mkdir skills/docker-mastery
└──────┬───────┘ touch skills/docker-mastery/SKILL.md
│
↓
┌──────────────┐
│ 3. VIẾT │ Thêm frontmatter + nội dung
└──────┬───────┘ (Dùng mẫu trong CONTRIBUTING.vi.md)
│
↓
┌──────────────┐
│ 4. THỬ │ Copy vào .agent/skills/
└──────┬───────┘ Thử gọi: @docker-mastery
│
↓
┌──────────────┐
│ 5. KIỂM TRA │ python3 scripts/validate_skills.py
└──────┬───────┘
│
↓
┌──────────────┐
│ 6. NỘP BÀ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 │
│ • Cấu trúc cơ bản • Cấu trúc đầy đủ • Scripts │
│ • Không phụ kiện • Có ví dụ • Có ví dụ │
│ • Best practices • Template │
│ • Docs │
│ Ví dụ: Ví dụ: Ví dụ: │
│ git-pushing brainstorming loki-mode │
│ │
└─────────────────────────────────────────────────────────────┘
```
---
## Tác động của việc Đóng góp (Quy trình nhân quả)
```
Đóng góp của BẠN
│
├─→ Cải thiện Tài liệu
│ │
│ └─→ Giúp hàng ngàn lập trình viên đỡ bỡ ngỡ
│
├─→ Tạo Skill mới
│ │
│ └─→ Mở ra khả năng mới cho mọi người
│
├─→ Sửa lỗi (Bug/Typo)
│ │
│ └─→ Tránh nhầm lẫn cho người sau
│
└─→ Thêm ví dụ
│
└─→ Giúp người mới học nhanh hơn
```
---
## Lộ trình học tập (Roadmap trực quan)
```
BẮT ĐẦU Ở ĐÂY
│
↓
┌─────────────────┐
│ Đọc │
│ GETTING_STARTED │
└────────┬────────┘
│
↓
┌─────────────────┐
│ Thử 2-3 Skill │
│ với AI Assistant│
└────────┬────────┘
│
↓
┌─────────────────┐
│ Đọc │
│ SKILL_ANATOMY │
└────────┬────────┘
│
↓
┌─────────────────┐
│ Nghiên cứu code │
│ của Skill có sẵn│
└────────┬────────┘
│
↓
┌─────────────────┐
│ Tạo một Skill │
│ đơn giản │
└────────┬────────┘
│
↓
┌─────────────────┐
│ Đọc │
│ CONTRIBUTING │
└────────┬────────┘
│
↓
┌─────────────────┐
│ Gửi PR (Nộp bài)│
└────────┬────────┘
│
↓
CONTRIBUTOR! 🎉
```
---
## Mẹo nhanh (Cheatsheet)
```
┌─────────────────────────────────────────────────────────────┐
│ TRA CỨU NHANH │
├─────────────────────────────────────────────────────────────┤
│ │
│ 📥 CÀI ĐẶT │
│ git clone [repo] .agent/skills │
│ │
│ 🎯 DÙNG │
│ @ten-skill [yêu cầu của bạn] │
│ │
│ 🔍 TÌM │
│ ls skills/ | grep "từ-khóa" │
│ │
│ ✅ KIỂM TRA │
│ python3 scripts/validate_skills.py │
│ │
│ 📝 TẠO │
│ 1. mkdir skills/ten-skill │
│ 2. Tạo SKILL.md có frontmatter │
│ 3. Viết nội dung │
│ 4. Test & validate │
│ 5. Gửi PR │
│ │
│ 🆘 TRỢ GIÚP │
│ • GETTING_STARTED.vi.md - Cơ bản │
│ • CONTRIBUTING.vi.md - Cách đóng góp │
│ • SKILL_ANATOMY.md - Chuyên sâu │
│ • GitHub Issues - Hỏi đáp │
│ │
└─────────────────────────────────────────────────────────────┘
```
---
## Bước tiếp theo
1. ✅ **Hiểu** cấu trúc qua hình ảnh
2. ✅ **Cài đặt** skills vào công cụ AI của bạn
3. ✅ **Thử** 2-3 skill thuộc các nhóm khác nhau
4. ✅ **Đọc** CONTRIBUTING.vi.md
5. ✅ **Tạo** skill đầu tay
6. ✅ **Chia sẻ** với cộng đồng
---
**Bạn học qua hình ảnh tốt hơn?** Hy vọng hướng dẫn này giúp ích! Nếu còn thắc mắc, hãy xem thêm:
- [GETTING_STARTED.vi.md](../GETTING_STARTED.vi.md) - Hướng dẫn dạng chữ
- [SKILL_ANATOMY.md](SKILL_ANATOMY.md) - Phân tích chi tiết (Tiếng Anh)
- [CONTRIBUTING.vi.md](../CONTRIBUTING.vi.md) - Cách đóng góp
**Sẵn sàng đóng góp chưa?** Triển khai thôi! 💪