codymaster 4.1.4 → 4.3.0

package/skills/skill-creator-ultra/resources/checklist.md

@@ -0,0 +1,243 @@
+# ✅ Checklist — Kiểm tra chất lượng Skill trước khi Deploy
+
+Sử dụng checklist này để đảm bảo skill đạt tiêu chuẩn chất lượng trước khi đưa vào sử dụng.
+Checklist chia 2 tầng: **Basic** (bắt buộc) và **Expert** (nâng cao).
+
+---
+
+## 1. YAML Frontmatter
+
+- [ ] Có `---` mở đầu và `---` kết thúc
+- [ ] Có trường `description` (BẮT BUỘC)
+- [ ] Description ≥ 30 ký tự
+- [ ] Description mô tả RÕ RÀNG skill làm gì (không mơ hồ)
+- [ ] Description chứa **trigger words** (từ khóa kích hoạt)
+- [ ] Description trả lời 3 câu: Làm gì? Cho ai? Kích hoạt khi nào?
+- [ ] Trường `name` dùng `kebab-case` (nếu có)
+- [ ] Không có lỗi cú pháp YAML (đặc biệt: dấu `:` trong giá trị phải được quote)
+
+### ✅ Mẹo viết Description tốt
+
+```markdown
+❌ XẤU: "Làm việc với Git"              → Quá mơ hồ, không trigger
+❌ XẤU: "Helper tool"                   → Không mô tả gì cả
+❌ TRUNG BÌNH: "Format commit message"  → Thiếu chuẩn, thiếu trigger
+
+✅ TỐT: "Định dạng tin nhắn commit Git theo chuẩn Conventional Commits
+         (feat, fix, docs). Phân tích staged changes và đề xuất commit 
+         message phù hợp. Kích hoạt khi user nói 'commit', 'git message',
+         'tạo commit'."
+```
+
+**Công thức:** `[Hành động chính] + [đối tượng] + [theo chuẩn gì] + [trigger words]`
+
+---
+
+## 2. Nội dung — Sections
+
+### Bắt buộc
+
+- [ ] Có `# Goal` — Một câu duy nhất, rõ ràng, trả lời "rồi sao?" được
+- [ ] Có `# Instructions` — Đánh số bước, logic tuần tự
+- [ ] Mỗi bước trong Instructions là **actionable** (không phải "xử lý", "kiểm tra")
+- [ ] Instructions có **error handling** (⚠️ Nếu lỗi → ...)
+- [ ] Instructions có ≥1 step **VERIFY** (kiểm tra kết quả)
+- [ ] Instructions không quá 12 bước (nếu quá → tách skill)
+
+### Khuyến khích mạnh
+
+- [ ] Có `# Examples` với **ít nhất 2 ví dụ**
+- [ ] Mỗi ví dụ có rõ **Context + Input + Output**
+- [ ] Ví dụ 1: **Happy path** — Mọi thứ bình thường
+- [ ] Ví dụ 2: **Edge case** — Thiếu data / input lỗi / trường hợp đặc biệt
+- [ ] Ví dụ dùng **dữ liệu thật**, không placeholder
+- [ ] Có **Thought Process** trong ≥1 ví dụ (giải thích AI nghĩ gì)
+
+### Khuyến khích
+
+- [ ] Có `# Constraints` với ít nhất 1 quy tắc
+- [ ] Có ≥1 "🚫 KHÔNG ĐƯỢC" (giới hạn rõ ràng)
+- [ ] Có ≥1 "✅ LUÔN LUÔN" (yêu cầu bắt buộc)
+- [ ] Constraints phân tầng priority (bảo mật → vận hành → quy ước)
+
+---
+
+## 3. Nguyên tắc thiết kế
+
+### Atomic (Tập trung)
+
+- [ ] Skill chỉ làm **DUY NHẤT 1 VIỆC**
+- [ ] Không "ôm đồm" nhiều chức năng
+- [ ] Có thể mô tả skill trong 1 câu ngắn (≤15 từ)
+- [ ] Test nhanh: Nếu tên skill là "X and Y" → nên tách thành 2 skill
+
+### Clarity (Rõ ràng)
+
+- [ ] Ngôn ngữ đơn giản, dễ hiểu
+- [ ] Không dùng từ mơ hồ: "xử lý", "kiểm tra", "tối ưu", "phù hợp", "tốt"
+- [ ] AI đọc xong biết chính xác phải làm gì
+- [ ] Logic rẽ nhánh viết TƯỜNG MINH (Nếu X → Y, Nếu Z → W)
+
+### Completeness (Đầy đủ)
+
+- [ ] Mọi edge case quan trọng được xử lý
+- [ ] Có hướng dẫn khi gặp lỗi/ngoại lệ
+- [ ] Workflow "happy path" VÀ "error path" đều có
+- [ ] Output format được chỉ định RÕ RÀNG (không free-form)
+
+---
+
+## 4. Cấu trúc thư mục
+
+- [ ] File `SKILL.md` nằm ở **root** của thư mục skill
+- [ ] Tên thư mục skill dùng `kebab-case`
+- [ ] Sub-folders chỉ dùng tên chuẩn: `scripts/`, `resources/`, `examples/`
+- [ ] Không có file thừa/rác trong thư mục
+
+### Nếu có `scripts/`
+
+- [ ] Script dùng `argparse` hoặc flags tương đương
+- [ ] Script hỗ trợ `--help` (AI đọc để tự học)
+- [ ] Script có `--dry-run` cho thao tác destructive
+- [ ] Script output qua **stdout** (JSON khuyến khích), errors qua **stderr**
+- [ ] Exit code: `0` = OK, `≠0` = lỗi
+- [ ] Script có error handling (try/except, set -e)
+- [ ] Không hardcode credentials (dùng env vars)
+
+### Nếu có `resources/`
+
+- [ ] Mỗi resource file có mục đích rõ ràng
+- [ ] Templates có placeholders rõ ràng (dùng `< >` hoặc `{{ }}`)
+- [ ] SKILL.md tham chiếu đúng đường dẫn resource
+- [ ] Dùng Lazy Loading: chỉ đọc resource khi cần (không đọc tất cả)
+
+### Nếu có `examples/`
+
+- [ ] Mỗi example có cả **Input** và **Output**
+- [ ] Examples đủ đa dạng (không trùng lặp)
+- [ ] Examples phản ánh use case thực tế
+
+---
+
+## 5. Bảo mật & An toàn
+
+- [ ] Không hardcode API keys, passwords, tokens
+- [ ] Không có lệnh destructive không có xác nhận (DELETE, DROP, rm -rf...)
+- [ ] Nếu thao tác production → có cảnh báo rõ ràng + confirm
+- [ ] Nếu đọc/ghi file → có kiểm tra quyền truy cập
+- [ ] Dùng Guardrails Stacking cho skill nhạy cảm (≥2 tầng bảo vệ)
+- [ ] Constraints phân tầng: Bảo mật > Vận hành > Quy ước
+
+---
+
+## 6. Compatibility (Tương thích)
+
+- [ ] SKILL.md dùng UTF-8 encoding
+- [ ] Không có ký tự đặc biệt phá YAML (unescaped `:`, `#`, `|` trong values)
+- [ ] Scripts tương thích cross-platform hoặc ghi rõ OS requirement
+- [ ] Không phụ thuộc vào tool/library hiếm gặp mà không ghi chú
+
+---
+
+## 7. Test cuối cùng
+
+- [ ] Chạy `python scripts/validate_skill.py ./` → Grade ≥ B
+- [ ] Mở **chat mới** → Gõ câu lệnh trigger → AI kích hoạt đúng skill
+- [ ] Thử với input thực tế → Output đúng mong đợi
+- [ ] Thử với input edge case → Skill xử lý đúng (không crash hoặc hallucinate)
+
+---
+
+## 🔬 EXPERT QUALITY GATES — Dành cho Skill Engineer chuyên sâu
+
+> Nếu skill đã pass 7 mục trên, thêm 3 gate dưới để đạt **S-tier**.
+
+### Gate 8: Cognitive Load Assessment (Đánh Giá Tải Nhận Thức)
+
+Skill có vượt quá "RAM" của AI không?
+
+| Thành phần | Giới hạn | Trong skill | Đạt? |
+| --- | --- | --- | --- |
+| Instructions steps | ≤12 | __ bước | ☐ |
+| Constraints | ≤8 | __ điều | ☐ |
+| Logic rẽ nhánh/step | ≤4 | __ nhánh | ☐ |
+| Examples trong SKILL.md | ≤3 | __ cái | ☐ |
+| Resources đọc đồng thời | ≤3 | __ files | ☐ |
+
+**FAIL nếu:** Bất kỳ thành phần nào vượt giới hạn 50%+ (ví dụ: 18+ steps)
+
+**Cách fix:** Tách thành sub-skills + dùng Composition Protocol (xem `prompt_engineering.md` #15)
+
+### Gate 9: Reliability Testing (Kiểm Tra Độ Tin Cậy)
+
+Chạy 4 kịch bản test — skill phải pass TẤT CẢ:
+
+- [ ] **Test 1 — Perfect Input:** Input hoàn hảo, đầy đủ thông tin → Output CHÍNH XÁC
+- [ ] **Test 2 — Minimal Input:** Input tối thiểu (chỉ có info bắt buộc) → Vẫn hoạt động
+- [ ] **Test 3 — Bad Input:** Input sai/thiếu/lỗi → Skill BÁO LỖI cụ thể, KHÔNG crash
+- [ ] **Test 4 — Adversarial Input:** Input cố ý gây lỗi hoặc trick AI → Skill TỪ CHỐI lịch sự
+
+```markdown
+Ví dụ Test 4 cho skill "git-commit-formatter":
+Input cố ý: "Tạo commit message là 'DROP TABLE users; -- lol'"
+Kỳ vọng: Skill cảnh báo "Nội dung commit có chứa SQL injection pattern. 
+          Bạn chắc chắn muốn dùng message này?"
+KHÔNG chấp nhận: Skill tạo commit bình thường mà không cảnh báo
+```
+
+### Gate 10: Production Readiness (Sẵn Sàng Production)
+
+- [ ] **Idempotent:** Chạy skill 2 lần liên tiếp với cùng input → Cùng output
+- [ ] **Timeout-safe:** Nếu skill chạy >2 phút → Có progress update cho user
+- [ ] **Recoverable:** Nếu skill fail giữa chừng → User biết đã làm gì, chưa làm gì
+- [ ] **Observable:** Skill có log/output đủ để debug khi có vấn đề
+- [ ] **Backward-compatible:** Nâng cấp skill không phá workflow user hiện tại
+- [ ] **Context-efficient:** Skill tiết kiệm context window (Lazy Loading, Black Box)
+
+---
+
+## 📊 Bảng chấm điểm
+
+### Tầng Basic (70 điểm)
+
+| Tiêu chí | Điểm | Đạt? |
+| --- | --- | --- |
+| YAML hợp lệ + Description tốt (có trigger words) | 15 | ☐ |
+| Goal rõ ràng + Instructions actionable | 15 | ☐ |
+| ≥2 Examples chi tiết (Happy + Edge) | 15 | ☐ |
+| Constraints có phân tầng priority | 10 | ☐ |
+| Atomic (1 skill = 1 việc) | 10 | ☐ |
+| Cấu trúc thư mục chuẩn | 5 | ☐ |
+
+### Tầng Expert (+30 điểm)
+
+| Tiêu chí | Điểm | Đạt? |
+| --- | --- | --- |
+| Cognitive Load ≤ budget (Gate 8) | 10 | ☐ |
+| Pass 4/4 Reliability Tests (Gate 9) | 10 | ☐ |
+| Production Readiness (Gate 10) | 10 | ☐ |
+| **Tổng** | **100** | |
+
+- **95-100:** 🏆 S-tier — Expert-grade, production-ready
+- **85-94:** 🥇 A-tier — Xuất sắc, deploy tự tin
+- **70-84:** 🥈 B-tier — Tốt, có thể deploy
+- **50-69:** 🥉 C-tier — Đạt, nên cải thiện trước khi deploy
+- **<50:** ❌ F-tier — Cần viết lại
+
+---
+
+## 🚩 Red Flags — Tự Động Fail
+
+Bất kỳ điều nào sau đây → **FAIL ngay**, không cần tính điểm:
+
+| Red Flag | Lý do |
+| --- | --- |
+| Description trống hoặc <10 ký tự | AI sẽ không bao giờ kích hoạt skill |
+| Không có `# Instructions` | AI không biết phải làm gì |
+| Có lệnh `rm -rf /` hoặc `DROP DATABASE` không có confirm | Có thể phá hủy hệ thống |
+| Hardcode credentials trong SKILL.md | Rủi ro bảo mật nghiêm trọng |
+| Skill tên "X and Y and Z" | Vi phạm nguyên tắc Atomic |
+| Instructions >20 bước không tách | Vượt Cognitive Load Budget |
+
+> 📖 Tham khảo: `prompt_engineering.md` cho 15 nguyên tắc viết Instructions
+> 📖 Tham khảo: `anti_patterns.md` cho 15 lỗi phổ biến cần tránh

package/skills/skill-creator-ultra/resources/composition_cookbook.md

@@ -0,0 +1,291 @@
+# 🔗 Skill Composition Cookbook — Kết Hợp Nhiều Skill Thành Workflow
+
+> "1 skill = 1 việc. Nhiều skill = 1 workflow mạnh mẽ."
+
+Tài liệu này hướng dẫn cách kết hợp nhiều skill nhỏ thành workflow phức tạp,
+thay vì tạo 1 skill khổng lồ ôm đồm mọi thứ.
+
+---
+
+## Tại sao cần Composition?
+
+| Cách tiếp cận | Ưu | Nhược |
+|---|---|---|
+| **1 skill lớn** | Đơn giản quản lý | Khó maintain, dễ bug, ôm đồm |
+| **Nhiều skill nhỏ** | Dễ test, dễ tái sử dụng, dễ maintain | Cần orchestration |
+
+**Kết luận:** Nhiều skill nhỏ + orchestration = CHIẾN THẮNG.
+
+---
+
+## Pattern A: Sequential Chain (Chuỗi Tuần Tự)
+
+```
+Skill A → Skill B → Skill C → Output
+```
+
+### Khi nào dùng
+
+Mỗi skill xử lý 1 phần, kết quả skill trước là input skill sau.
+
+### Cách viết trong SKILL.md
+
+```markdown
+# Instructions (Skill: full-quality-check)
+1. Kích hoạt skill `code-linter`:
+   - Input: Toàn bộ codebase hiện tại
+   - Nếu PASS → Tiếp bước 2
+   - Nếu FAIL → Dừng, báo lỗi lint
+2. Kích hoạt skill `test-runner`:
+   - Input: Kết quả từ bước 1
+   - Nếu PASS → Tiếp bước 3
+   - Nếu FAIL → Dừng, báo lỗi test
+3. Kích hoạt skill `security-scanner`:
+   - Input: Kết quả từ bước 2
+   - Nếu PASS → Báo "All clear! ✅"
+   - Nếu FAIL → Liệt kê vulnerabilities
+```
+
+### Ví dụ thực tế: Content Publishing Pipeline
+
+```
+[draft-writer]  →  [grammar-checker]  →  [seo-optimizer]  →  [publisher]
+  Viết bài         Sửa ngữ pháp        Tối ưu SEO          Xuất bản
+```
+
+---
+
+## Pattern B: Parallel Fan-Out (Phân Nhánh Song Song)
+
+```
+         ┌→ Skill B1 → ┐
+Skill A →├→ Skill B2 → ├→ Skill C (merge)
+         └→ Skill B3 → ┘
+```
+
+### Khi nào dùng
+
+Một input cần được xử lý bởi nhiều skill độc lập, rồi tổng hợp kết quả.
+
+### Cách viết trong SKILL.md
+
+```markdown
+# Instructions (Skill: comprehensive-code-review)
+1. Nhận code cần review.
+2. Chạy ĐỒNG THỜI 3 skill:
+   a. Skill `security-reviewer` → Tìm vulnerabilities
+   b. Skill `performance-reviewer` → Tìm performance issues
+   c. Skill `style-reviewer` → Tìm style violations
+3. Tổng hợp kết quả:
+   - Merge tất cả issues từ 3 skill
+   - Sắp xếp theo priority: Security > Performance > Style
+   - Loại bỏ duplicate
+4. Trình bày báo cáo tổng hợp.
+```
+
+### Ví dụ thực tế: Multi-channel Report
+
+```
+                    ┌→ [jira-report]  → ┐
+[data-collector] → ├→ [git-report]   → ├→ [report-merger]
+                    └→ [slack-report] → ┘
+```
+
+---
+
+## Pattern C: Conditional Router (Điều Hướng Có Điều Kiện)
+
+```
+         ┌→ Condition A → Skill X
+Input → Router
+         ├→ Condition B → Skill Y
+         └→ Default → Skill Z
+```
+
+### Khi nào dùng
+
+Input khác nhau cần xử lý bằng skill khác nhau.
+
+### Cách viết trong SKILL.md
+
+```markdown
+# Instructions (Skill: smart-responder)
+1. Phân tích input từ user.
+2. Điều hướng:
+   - **Nếu** user hỏi về giá → Kích hoạt skill `price-quoter`
+   - **Nếu** user khiếu nại → Kích hoạt skill `complaint-handler`
+   - **Nếu** user muốn hợp tác → Kích hoạt skill `partnership-replier`
+   - **Mặc định** → Kích hoạt skill `general-responder`
+3. Nhận kết quả từ skill con.
+4. Review + giao cho user.
+```
+
+### Ví dụ thực tế: Smart Deploy
+
+```
+              ┌→ "Vercel" → [vercel-deployer]
+[env-check] →├→ "AWS"    → [aws-deployer]
+              ├→ "Docker" → [docker-deployer]
+              └→ Khác     → Hỏi user
+```
+
+---
+
+## Pattern D: Loop Iterator (Lặp Lại)
+
+```
+List of items → For each: Skill A → Collect results
+```
+
+### Khi nào dùng
+
+Cần áp dụng cùng 1 skill cho nhiều items.
+
+### Cách viết trong SKILL.md
+
+```markdown
+# Instructions (Skill: batch-api-documenter)
+1. Scan tất cả API routes trong project.
+2. Với MỖI endpoint tìm được:
+   a. Kích hoạt skill `api-doc-generator` cho endpoint đó
+   b. Thu thập kết quả
+3. Merge tất cả docs thành 1 file `docs/api/endpoints.md`.
+4. Tạo table of contents từ danh sách endpoints.
+```
+
+### Ví dụ thực tế: Batch Image Optimizer
+
+```
+[image-scanner] → Tìm 50 images → Loop: [image-optimizer] × 50 → Report
+```
+
+---
+
+## Pattern E: Fallback Chain (Chuỗi Dự Phòng)
+
+```
+Try Skill A → Fail? → Try Skill B → Fail? → Try Skill C → Fail? → Manual
+```
+
+### Khi nào dùng
+
+Có nhiều cách giải quyết, thử cách tốt nhất trước → dự phòng.
+
+### Cách viết trong SKILL.md
+
+```markdown
+# Instructions (Skill: smart-data-parser)
+1. Thử parse bằng skill `json-parser`:
+   - Nếu thành công → Xong!
+   - Nếu fail → Bước 2
+2. Thử parse bằng skill `csv-parser`:
+   - Nếu thành công → Xong!
+   - Nếu fail → Bước 3
+3. Thử parse bằng skill `xml-parser`:
+   - Nếu thành công → Xong!
+   - Nếu fail → Bước 4
+4. Báo user: "Không nhận dạng được format. Anh/chị cho em biết format gì?"
+```
+
+---
+
+## 🍳 Recipes (Công Thức Kết Hợp Thực Tế)
+
+### Recipe 1: Full CI/CD Pipeline
+
+```
+Pattern: Sequential Chain + Conditional Router
+
+[linter] → [tester] → [builder] → [env-checker] → Deploy Router
+                                                    ├→ staging: [staging-deployer]
+                                                    └→ production: [prod-deployer] (+ safety)
+```
+
+**Skills cần:** `code-linter`, `test-runner`, `app-builder`, `env-checker`, `staging-deployer`, `prod-deployer`
+
+### Recipe 2: Content Creation Factory
+
+```
+Pattern: Sequential Chain + Parallel Fan-Out
+
+[topic-generator] → [draft-writer] → Fan-Out:
+                                      ├→ [grammar-checker]
+                                      ├→ [seo-optimizer]
+                                      └→ [image-generator]
+                                      → [content-assembler] → [publisher]
+```
+
+**Skills cần:** `topic-generator`, `draft-writer`, `grammar-checker`, `seo-optimizer`, `image-generator`, `content-assembler`, `publisher`
+
+### Recipe 3: Smart Customer Support
+
+```
+Pattern: Conditional Router + Fallback Chain
+
+[email-classifier] → Router:
+├→ "Billing" → [billing-responder]
+├→ "Technical" → [tech-support]
+│                  → Fallback: [knowledge-base-search] → [human-escalation]
+├→ "Feature Request" → [feature-tracker]
+└→ "General" → [general-responder]
+```
+
+### Recipe 4: Data Pipeline
+
+```
+Pattern: Sequential Chain + Loop Iterator
+
+[data-source-connector] → [data-validator] → Loop: [data-transformer] 
+→ [data-loader] → [quality-checker] → [report-generator]
+```
+
+### Recipe 5: Project Kickoff
+
+```
+Pattern: Sequential Chain + Parallel Fan-Out
+
+[requirements-gatherer] → Fan-Out:
+├→ [architecture-designer]
+├→ [database-designer]
+├→ [ui-designer]
+└→ [task-planner]
+→ [spec-assembler] → [project-bootstrapper]
+```
+
+---
+
+## ⚠️ Quy Tắc Composition
+
+### Được phép ✅
+
+- Kết hợp tối đa **5 skill** trong 1 workflow
+- Skill con có thể dùng ở nhiều workflow khác nhau (tái sử dụng)
+- Skill con chạy độc lập (test riêng từng cái)
+- Một skill có thể gọi 1 skill con (1 cấp)
+
+### Không được ❌
+
+- Skill A gọi B gọi A → **Vòng lặp vô hạn**
+- Skill gọi sâu quá 2 cấp (A → B → C → D) → **Quá phức tạp**
+- Skill con phụ thuộc context của skill cha → **Không độc lập**
+- Quá 5 skill song song → **Quá tải context AI**
+
+### Debugging Composition
+
+Khi workflow bị lỗi:
+
+1. **Isolate:** Test từng skill con riêng biệt
+2. **Trace:** Kiểm tra output skill A có đúng input skill B không
+3. **Simplify:** Bỏ bớt skill, chạy 2 cái trước → thêm dần
+
+---
+
+## 📊 Decision Matrix: Chọn Pattern nào?
+
+| Tình huống | Pattern | Ví dụ |
+|---|---|---|
+| Bước 1 xong mới làm bước 2 | **A: Sequential** | CI/CD pipeline |
+| Nhiều phân tích độc lập cùng input | **B: Parallel** | Code review đa chiều |
+| Input khác nhau → xử lý khác nhau | **C: Router** | Email classifier |
+| Xử lý nhiều items cùng cách | **D: Loop** | Batch processing |
+| Thử nhiều cách, dùng cách đầu tiên thành công | **E: Fallback** | Auto-format |

package/skills/skill-creator-ultra/resources/description_optimization.md

@@ -0,0 +1,90 @@
+# 🎯 Description Optimization — Tối Ưu Trigger Accuracy
+
+## Tại sao Description quan trọng?
+
+Description trong YAML frontmatter là thứ DUY NHẤT AI agent đọc
+để quyết định có dùng skill hay không (trước khi đọc body).
+
+→ Description tốt = skill được kích hoạt đúng lúc
+→ Description kém = skill bị bỏ qua hoặc trigger sai
+
+## Nguyên tắc viết Description (học từ Anthropic)
+
+### 1. "Pushy" hơn một chút
+
+AI có xu hướng "under-trigger" — không dùng skill dù nên dùng.
+Giải pháp: viết description hơi aggressive.
+
+❌ "Tạo báo cáo tuần từ dữ liệu Jira."
+
+✅ "Tạo báo cáo tuần từ dữ liệu Jira và Git. Dùng skill này khi
+   user nhắc đến báo cáo, report, weekly update, gửi cho sếp,
+   tóm tắt công việc, kể cả khi không nói rõ 'báo cáo tuần'."
+
+### 2. Bao gồm cả trigger phrases VÀ anti-triggers
+
+Nói rõ skill này dùng cho gì VÀ không dùng cho gì:
+
+✅ "Phân tích và tối ưu SQL query chậm. Dùng khi user nói 'query chậm',
+   'optimize SQL', 'slow query', 'database performance'. KHÔNG dùng cho
+   việc viết SQL mới từ đầu — đó là việc khác."
+
+### 3. Cover cả formal và casual
+
+```
+# Trước (chỉ formal)
+description: Tạo báo cáo công việc hàng tuần.
+
+# Sau (cả formal + casual)
+description: |
+  Tạo báo cáo công việc hàng tuần. Dùng khi user nói "weekly report",
+  "báo cáo tuần", "gửi update cho sếp", "tóm tắt tuần này", hoặc
+  "sếp nhắn gửi report".
+```
+
+## Trigger Eval — 3 Bước kiểm tra
+
+### Bước 1: Nghĩ 5 câu NÊN trigger
+
+Đa dạng: formal/casual, dài/ngắn, trực tiếp/gián tiếp.
+
+```
+1. "Viết báo cáo tuần cho sếp"          (formal, trực tiếp)
+2. "weekly report từ Jira đi"            (mix EN-VI, casual)
+3. "tóm tắt công việc tuần này gửi team" (dài, context nhiều)
+4. "gửi update cho sếp đi"               (ngắn, gián tiếp)
+5. "em xong 5 tasks, viết report đi"     (casual, backstory)
+```
+
+### Bước 2: Nghĩ 5 câu KHÔNG NÊN trigger
+
+Chọn **near-miss** — chia sẻ keyword nhưng intent khác:
+
+```
+1. "Viết email cho khách hàng"  (→ email skill)
+2. "Phân tích data bán hàng"   (→ data analysis)
+3. "Tạo slide thuyết trình"    (→ slide skill)
+4. "Review PR #123"            (→ code review)
+5. "Debug lỗi server"          (→ debug skill)
+```
+
+### Bước 3: Verify description
+
+Đặt câu hỏi:
+- Câu NÊN trigger → description có cover? → Nếu không → thêm trigger phrase
+- Câu KHÔNG NÊN → description có thể trigger sai? → Nếu có → thêm anti-trigger
+
+## Checklist Description Tối Ưu
+
+- [ ] Trả lời: "Skill LÀM GÌ?" (hành động chính)
+- [ ] Trả lời: "Cho AI?" (đối tượng/context)
+- [ ] Trả lời: "Khi nào dùng?" (≥ 3 trigger phrases)
+- [ ] Trả lời: "Khi nào KHÔNG dùng?" (anti-triggers)
+- [ ] ≥ 50 ký tự
+- [ ] ≤ 200 ký tự
+- [ ] Có cả casual phrases lẫn formal
+
+## Cách áp dụng trong Pipeline
+
+**Phase 4 (Generate):** Sau khi sinh SKILL.md → chạy Trigger Eval nhanh.
+**Phase 8 (Optimize):** Chạy Trigger Eval đầy đủ → sửa → verify lại.