ai-developer-skill-os 1.8.1 → 2.0.0

package/skills/qk-help/SKILL.md

@@ -1,67 +1,95 @@
----
-name: qk-help
-description: >-
-  Tra cứu danh sách toàn bộ kỹ năng (skills) hiện có và đọc các mẹo (pro-tips) kết hợp kỹ năng để tăng tốc độ code.
-version: 1.0.0
-category: engineering
-tags: [help, list, tips, guide, manual]
-platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
----
-
-# 📚 Cẩm nang AI Developer Skill OS
-
-> **Nhiệm vụ của bạn (AI):** Khi người dùng gọi lệnh `./qk-help`, hãy xuất ra màn hình (bằng tiếng Việt) danh sách các kỹ năng phân theo nhóm và các Mẹo sử dụng (Pro-tips) dưới đây một cách sinh động, dễ đọc (dùng markdown, in đậm, emoji). Không cần phân tích code, chỉ đóng vai trò là "Sách hướng dẫn sử dụng".
-
----
-
-## 🎯 1. Danh sách Kỹ năng (Skills Directory)
-
-Dưới đây là các kỹ năng chính bạn có thể gọi bằng cách gõ `./qk-[tên-kỹ-năng]`:
-
-### 🎨 Frontend (Giao diện)
-- **`qk-ui-builder`**: Xây dựng UI, Layout, Component, Modal phức tạp.
-- **`qk-table-crud-generator`**: Chuyên vẽ bảng danh sách (Table), phân trang, lọc và form Thêm/Sửa/Xóa.
-- **`qk-form-builder`**: Chuyên làm Form nhập liệu, validate (Zod/Yup).
-- **`qk-component-generator`**: Tạo Component độc lập, tái sử dụng (Button, Input, Card).
-- **`qk-state-management`**: Xử lý Redux, Zustand, React Query.
-- **`qk-frontend-debug`**: Bắt bệnh vỡ layout, infinite re-render, lỗi Hydration.
-- **`qk-frontend-performance`**: Tối ưu tốc độ, chống re-render thừa.
-- **`qk-frontend-architecture`**: Tư vấn kiến trúc thư mục Frontend.
-- **`qk-frontend-testing`**: Viết Unit Test / E2E Test cho Frontend.
-- **`qk-accessibility-audit`**: Sửa lỗi a11y, hỗ trợ Screen reader.
-
-### ⚙️ Engineering & Integration (Tích hợp)
-- **`qk-api-integration`**: [Cực mạnh] Bóc tách tài liệu API (Curl, Postman) -> Gen Type, Service, Hook -> (Tùy chọn) Ốp thẳng vào UI.
-- **`qk-refactor`**: Tối ưu, dọn dẹp mã nguồn sạch sẽ.
-- **`qk-bug-fix`**: Chẩn đoán lỗi sâu và sửa an toàn.
-- **`qk-project-audit`**: Quét toàn bộ dự án tìm nợ kỹ thuật.
-- **`qk-git-engineer`**: Viết Commit / PR chuẩn Conventional.
-- **`qk-migration`**: Nâng cấp version framework / thư viện.
-- **`qk-agent-orchestrator`**: Kiến trúc sư, lên plan phân rã task lớn.
-- **`qk-context-manager`**: Tóm tắt kiến trúc dự án.
-
-### 🗄️ Backend (Máy chủ)
-- **`qk-database-engineer`**: Thiết kế Schema, ORM (Prisma/Drizzle), Migration.
-- **`qk-backend-architecture`**: Setup kiến trúc Backend (Node/Nest/Python).
-- **`qk-auth-security`**: Phân quyền RBAC, JWT, OAuth.
-- **`qk-deployment`**: Viết Dockerfile, CI/CD Pipeline.
-
----
-
-## 💡 2. Mẹo sử dụng Nâng cao (Pro-Tips)
-
-### Mẹo 1: Kết hợp Kỹ năng (Skill Chaining) 🔗
-Đừng bắt AI làm từ A-Z bằng 1 câu prompt. Hãy gọi liên hoàn:
-> *"Hãy dùng `./qk-api-integration` để bóc tách API này thành hook React Query. Sau đó dùng `./qk-table-crud-generator` vẽ cái Bảng hiển thị danh sách tích hợp hook đó."*
-
-### Mẹo 2: Chế độ "Một phát ăn ngay" (End-to-End) 🚀
-Nếu bạn đã có sẵn 1 màn hình UI (chỉ thiếu data), hãy ép `qk-api-integration` làm End-to-End:
-> *"./qk-api-integration Dưới đây là API Get Profile. Hãy khai báo Type, viết Hook và TÍCH HỢP THẲNG LUÔN vào file \`Profile.tsx\` đang mở."*
-
-### Mẹo 3: Truyền tham số ép buộc (Arguments) 🎯
-Bạn có thể ép AI dùng công nghệ bạn muốn bằng cách thêm \`--tham_số\`:
-> *"./qk-ui-builder --fw=react --css=tailwind Hãy vẽ màn hình Đăng nhập."*
-
-### Mẹo 4: Nhờ "Kiến trúc sư" phân việc 🧠
-Nếu bạn có một tính năng quá lớn (ví dụ: Làm tính năng Giỏ Hàng), đừng tự chia việc, hãy gọi:
-> *"./qk-agent-orchestrator Tôi muốn làm tính năng Giỏ hàng. Hãy phân tích và lên kế hoạch gọi các skill \`qk-\` nào cho phù hợp."*
+---
+name: qk-help
+purpose: Tra cứu danh sách toàn bộ kỹ năng (skills) hiện có và đọc các mẹo (pro-tips) kết hợp kỹ năng.
+mode_supported: [quick, standard]
+input: [User query]
+output: [Skill list, guides]
+workflow: [1. Nhận câu hỏi -> 2. Tra cứu -> 3. Phản hồi]
+allowed_tools: [read_file, list_dir]
+handoff_to: [none]
+---
+
+# 🛠️ qk-help - Quy Trình Vận Hành Chuẩn (SOP)
+
+> **Mô tả:** Tra cứu danh sách toàn bộ kỹ năng (skills) hiện có và đọc các mẹo (pro-tips) kết hợp kỹ năng.
+
+## 🎯 1. Mục Tiêu (Goal)
+- Cung cấp danh sách các kỹ năng hệ thống (AI-OS) cho người dùng.
+- Hướng dẫn cách kết hợp các kỹ năng để tạo ra chuỗi giá trị (workflow).
+
+## 🔄 2. Chuỗi Hành Động (Chain of Thought / SOP)
+*(Bắt buộc AI phải suy nghĩ và làm theo đúng thứ tự)*
+1. **Phân tích (Analyze):** Phân tích câu hỏi của người dùng xem họ đang tìm kiếm gì.
+2. **Tra cứu (Plan):** Kiểm tra danh sách các kỹ năng hoặc mẹo sử dụng trong phần Deep Knowledge.
+3. **Thực thi (Execute):** Định dạng và trả lời câu hỏi một cách dễ hiểu nhất.
+4. **Xác thực (Verify):** Đảm bảo không giới thiệu các skill không tồn tại.
+
+## 🛡️ 3. Ràng Buộc & Quy Tắc (Constraints)
+- Chỉ được liệt kê các skill đang có thực trong dự án.
+- Mọi quyết định kỹ thuật phải dựa trên nội dung tại phần Deep Knowledge (nếu có).
+
+## 🤝 4. Giao Thức Bàn Giao (Handoff Protocol)
+- Đích đến: `none`
+- Nội dung bàn giao: Trả về kết quả hiển thị cho người dùng.
+
+## 📚 5. Kiến Thức Chuyên Sâu (Deep Knowledge)
+
+*(Nền tảng kiến thức và quy tắc chi tiết kế thừa từ kỹ sư)*
+
+# 📚 Cẩm nang AI Developer Skill OS
+
+> **Nhiệm vụ của bạn (AI):** Khi người dùng gọi lệnh `./qk-help`, hãy xuất ra màn hình (bằng tiếng Việt) danh sách các kỹ năng phân theo nhóm và các Mẹo sử dụng (Pro-tips) dưới đây một cách sinh động, dễ đọc (dùng markdown, in đậm, emoji). Không cần phân tích code, chỉ đóng vai trò là "Sách hướng dẫn sử dụng".
+
+---
+
+## 🎯 1. Danh sách Kỹ năng (Skills Directory)
+
+Dưới đây là các kỹ năng chính bạn có thể gọi bằng cách gõ `./qk-[tên-kỹ-năng]`:
+
+### 🎨 Frontend (Giao diện)
+- **`qk-ui-builder`**: Xây dựng UI, Layout, Component, Modal phức tạp.
+- **`qk-table-crud-generator`**: Chuyên vẽ bảng danh sách (Table), phân trang, lọc và form Thêm/Sửa/Xóa.
+- **`qk-form-builder`**: Chuyên làm Form nhập liệu, validate (Zod/Yup).
+- **`qk-component-generator`**: Tạo Component độc lập, tái sử dụng (Button, Input, Card).
+- **`qk-state-management`**: Xử lý Redux, Zustand, React Query.
+- **`qk-frontend-debug`**: Bắt bệnh vỡ layout, infinite re-render, lỗi Hydration.
+- **`qk-frontend-performance`**: Tối ưu tốc độ, chống re-render thừa.
+- **`qk-frontend-architecture`**: Tư vấn kiến trúc thư mục Frontend.
+- **`qk-frontend-testing`**: Viết Unit Test / E2E Test cho Frontend.
+- **`qk-accessibility-audit`**: Sửa lỗi a11y, hỗ trợ Screen reader.
+
+### ⚙️ Engineering & Integration (Tích hợp)
+- **`qk-api-integration`**: [Cực mạnh] Bóc tách tài liệu API (Curl, Postman) -> Gen Type, Service, Hook -> (Tùy chọn) Ốp thẳng vào UI.
+- **`qk-refactor`**: Tối ưu, dọn dẹp mã nguồn sạch sẽ.
+- **`qk-bug-fix`**: Chẩn đoán lỗi sâu và sửa an toàn.
+- **`qk-project-audit`**: Quét toàn bộ dự án tìm nợ kỹ thuật.
+- **`qk-git-engineer`**: Viết Commit / PR chuẩn Conventional.
+- **`qk-migration`**: Nâng cấp version framework / thư viện.
+- **`qk-agent-orchestrator`**: Kiến trúc sư, lên plan phân rã task lớn.
+- **`qk-context-manager`**: Tóm tắt kiến trúc dự án.
+
+### 🗄️ Backend (Máy chủ)
+- **`qk-database-engineer`**: Thiết kế Schema, ORM (Prisma/Drizzle), Migration.
+- **`qk-backend-architecture`**: Setup kiến trúc Backend (Node/Nest/Python).
+- **`qk-auth-security`**: Phân quyền RBAC, JWT, OAuth.
+- **`qk-deployment`**: Viết Dockerfile, CI/CD Pipeline.
+
+---
+
+## 💡 2. Mẹo sử dụng Nâng cao (Pro-Tips)
+
+### Mẹo 1: Kết hợp Kỹ năng (Skill Chaining) 🔗
+Đừng bắt AI làm từ A-Z bằng 1 câu prompt. Hãy gọi liên hoàn:
+> *"Hãy dùng `./qk-api-integration` để bóc tách API này thành hook React Query. Sau đó dùng `./qk-table-crud-generator` vẽ cái Bảng hiển thị danh sách tích hợp hook đó."*
+
+### Mẹo 2: Chế độ "Một phát ăn ngay" (End-to-End) 🚀
+Nếu bạn đã có sẵn 1 màn hình UI (chỉ thiếu data), hãy ép `qk-api-integration` làm End-to-End:
+> *"./qk-api-integration Dưới đây là API Get Profile. Hãy khai báo Type, viết Hook và TÍCH HỢP THẲNG LUÔN vào file \`Profile.tsx\` đang mở."*
+
+### Mẹo 3: Truyền tham số ép buộc (Arguments) 🎯
+Bạn có thể ép AI dùng công nghệ bạn muốn bằng cách thêm \`--tham_số\`:
+> *"./qk-ui-builder --fw=react --css=tailwind Hãy vẽ màn hình Đăng nhập."*
+
+### Mẹo 4: Nhờ "Kiến trúc sư" phân việc 🧠
+Nếu bạn có một tính năng quá lớn (ví dụ: Làm tính năng Giỏ Hàng), đừng tự chia việc, hãy gọi:
+> *"./qk-agent-orchestrator Tôi muốn làm tính năng Giỏ hàng. Hãy phân tích và lên kế hoạch gọi các skill \`qk-\` nào cho phù hợp."*

package/skills/qk-orchestrator/SKILL.md

@@ -0,0 +1,272 @@
+---
+name: qk-orchestrator
+purpose: Điều hướng request, phân tích ý đồ và chọn workflow phù hợp nhất.
+mode_supported: [standard]
+input: [User request]
+output: [Workflow được chọn và bàn giao cho skill tương ứng]
+workflow: [1. Nhận lệnh -> 2. Phân tích -> 3. Handoff]
+allowed_tools: [ask_question, run_command]
+handoff_to: [qk-context-loader]
+---
+
+# 🛠️ qk-orchestrator - Quy Trình Vận Hành Chuẩn (SOP)
+
+> **Mô tả:** Điều hướng request, phân tích ý đồ và chọn workflow phù hợp nhất.
+
+## 🎯 1. Mục Tiêu (Goal)
+- Hoàn thành thành công tác vụ được giao liên quan đến nhiệm vụ của skill.
+- Đảm bảo chất lượng mã nguồn và tính nhất quán của hệ thống.
+
+## 🔄 2. Chuỗi Hành Động (Chain of Thought / SOP)
+*(Bắt buộc AI phải suy nghĩ và làm theo đúng thứ tự)*
+1. **Phân tích (Analyze):** Thu thập ngữ cảnh và hiểu rõ yêu cầu đầu vào.
+2. **Lên kế hoạch (Plan):** Xác định các bước cần thay đổi/tạo mới dựa trên bộ luật (rules).
+3. **Thực thi (Execute):** Tiến hành sửa đổi mã nguồn hoặc tạo tài liệu.
+4. **Xác thực (Verify):** Đảm bảo đầu ra đáp ứng đúng yêu cầu và không vi phạm quy định.
+
+## 🛡️ 3. Ràng Buộc & Quy Tắc (Constraints)
+- CẤM bỏ qua việc kiểm tra `qk-engineering-standard` trước khi viết code.
+- Mọi quyết định kỹ thuật phải dựa trên nội dung tại phần Deep Knowledge (nếu có).
+
+## 🤝 4. Giao Thức Bàn Giao (Handoff Protocol)
+- Đích đến: `qk-context-loader`
+- Nội dung bàn giao: Chuyển toàn bộ ngữ cảnh và kết quả đã thực thi cho bước tiếp theo.
+
+## 📚 5. Kiến Thức Chuyên Sâu (Deep Knowledge)
+
+*(Nền tảng kiến thức và quy tắc chi tiết kế thừa từ kỹ sư)*
+
+---
+
+
+
+# Agent Orchestrator
+
+> **Language rule:**
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
+
+> ⚠️ **CRITICAL CONSTRAINT: This skill MUST NOT write any code.**
+> Its only job is to analyze, plan, and delegate.
+> If the orchestrator starts writing implementation code — it is violating its role.
+> Immediately stop and delegate to the appropriate skill instead.
+
+---
+
+## Trigger
+
+Activate this skill when:
+- User describes a task without knowing where to start
+- User request spans multiple concerns (UI + API + state + tests)
+- Request is ambiguous and needs decomposition before action
+- User says: "help me plan", "what should I do first", "how do I approach this"
+
+---
+
+## Scope
+
+- ✅ Analyze the user's request
+- ✅ Identify which skills are needed
+- ✅ Define the correct execution order
+- ✅ Create a step-by-step plan
+- ✅ Delegate each step to the correct skill
+- ✅ Track overall progress
+
+---
+
+## Non-goals
+
+- ❌ Do NOT write implementation code
+- ❌ Do NOT modify files
+- ❌ Do NOT fix bugs directly (delegate to `bug-fix`)
+- ❌ Do NOT build UI directly (delegate to `ui-builder`)
+- ❌ Do NOT make architectural decisions unilaterally (delegate to `frontend-architecture`)
+
+---
+
+## Workflow
+
+### Phase 1 — Request Analysis
+
+Parse the user's request:
+
+1. **What** is being asked? (feature, fix, refactor, review, deploy?)
+2. **Where** does it belong? (frontend, backend, shared, infrastructure?)
+3. **What is the scope?** (single component, full feature, entire codebase?)
+4. **What is unknown?** List any ambiguities that need clarification.
+
+If critical information is missing → ask before planning.
+
+---
+
+### Phase 2 — Skill Selection
+
+Map the request to skills from the registry:
+
+| Request type | Recommended skill(s) |
+|---|---|
+| "I don't know what's wrong" | `project-audit` → `bug-fix` |
+| "Build a new page" | `frontend-architecture` → `design-system` → `ui-builder` |
+| "Add API call" | `context-manager` → `api-integration` |
+| "App is slow" | `project-audit` → `frontend-performance` |
+| "Upgrade dependencies" | `migration` |
+| "Write tests" | `frontend-testing` |
+
+Always check dependencies from `skills.json` — load dependent skills first.
+
+---
+
+### Phase 3 — Execution Plan
+
+Produce a numbered, ordered plan. Each step maps to one skill.
+
+Format:
+```
+Step 1: [skill-name] — [what it will do]
+Step 2: [skill-name] — [what it will do]
+Step 3: [skill-name] — [what it will do]
+```
+
+Mark dependencies explicitly:
+```
+Step 2 requires Step 1 to complete first.
+```
+
+---
+
+### Phase 4 — Delegation
+
+For each step in the plan:
+1. Announce which skill is being activated
+2. Pass relevant context to that skill
+3. Wait for skill output
+4. Confirm completion before moving to next step
+
+---
+
+### Phase 5 — Progress Tracking
+
+After each skill completes:
+- Mark step as ✅ done
+- Note any output or blockers
+- Adjust remaining plan if needed
+- Report overall progress to user
+
+---
+
+## Decision Tree
+
+```
+Is the request clear enough to plan?
+  ├── No  → Ask 1-3 clarifying questions, then plan
+  └── Yes → Does it span multiple concerns?
+              ├── Yes → Create multi-step plan with skill sequence
+              └── No  → Route directly to single skill
+```
+
+```
+Does a skill dependency exist?
+  ├── Yes → Run dependency skill first
+  └── No  → Run skill directly
+```
+
+---
+
+## Output Format
+
+```
+📋 Plan: [Brief description of what we're doing]
+
+Step 1: `[skill-name]` — [Purpose]
+Step 2: `[skill-name]` — [Purpose]  ← requires Step 1
+Step 3: `[skill-name]` — [Purpose]
+
+⏳ Starting with Step 1...
+```
+
+After each step:
+```
+✅ Step 1 complete: [Brief outcome]
+▶️  Moving to Step 2: `[skill-name]`
+```
+
+---
+
+## Validation Checklist
+
+Before finishing orchestration:
+
+- [ ] All planned steps completed
+- [ ] Each step was handled by the correct skill
+- [ ] No code was written by the orchestrator itself
+- [ ] User has been informed of final outcome
+- [ ] Next recommended actions provided if relevant
+
+---
+
+## Examples
+
+See `examples/` folder.
+
+---
+
+
+
+# 📚 Cẩm nang AI Developer Skill OS
+
+> **Nhiệm vụ của bạn (AI):** Khi người dùng gọi lệnh `./qk-help`, hãy xuất ra màn hình (bằng tiếng Việt) danh sách các kỹ năng phân theo nhóm và các Mẹo sử dụng (Pro-tips) dưới đây một cách sinh động, dễ đọc (dùng markdown, in đậm, emoji). Không cần phân tích code, chỉ đóng vai trò là "Sách hướng dẫn sử dụng".
+
+---
+
+## 🎯 1. Danh sách Kỹ năng (Skills Directory)
+
+Dưới đây là các kỹ năng chính bạn có thể gọi bằng cách gõ `./qk-[tên-kỹ-năng]`:
+
+### 🎨 Frontend (Giao diện)
+- **`qk-ui-builder`**: Xây dựng UI, Layout, Component, Modal phức tạp.
+- **`qk-table-crud-generator`**: Chuyên vẽ bảng danh sách (Table), phân trang, lọc và form Thêm/Sửa/Xóa.
+- **`qk-form-builder`**: Chuyên làm Form nhập liệu, validate (Zod/Yup).
+- **`qk-component-generator`**: Tạo Component độc lập, tái sử dụng (Button, Input, Card).
+- **`qk-state-management`**: Xử lý Redux, Zustand, React Query.
+- **`qk-frontend-debug`**: Bắt bệnh vỡ layout, infinite re-render, lỗi Hydration.
+- **`qk-frontend-performance`**: Tối ưu tốc độ, chống re-render thừa.
+- **`qk-frontend-architecture`**: Tư vấn kiến trúc thư mục Frontend.
+- **`qk-frontend-testing`**: Viết Unit Test / E2E Test cho Frontend.
+- **`qk-accessibility-audit`**: Sửa lỗi a11y, hỗ trợ Screen reader.
+
+### ⚙️ Engineering & Integration (Tích hợp)
+- **`qk-api-integration`**: [Cực mạnh] Bóc tách tài liệu API (Curl, Postman) -> Gen Type, Service, Hook -> (Tùy chọn) Ốp thẳng vào UI.
+- **`qk-refactor`**: Tối ưu, dọn dẹp mã nguồn sạch sẽ.
+- **`qk-bug-fix`**: Chẩn đoán lỗi sâu và sửa an toàn.
+- **`qk-project-audit`**: Quét toàn bộ dự án tìm nợ kỹ thuật.
+- **`qk-git-engineer`**: Viết Commit / PR chuẩn Conventional.
+- **`qk-migration`**: Nâng cấp version framework / thư viện.
+- **`qk-agent-orchestrator`**: Kiến trúc sư, lên plan phân rã task lớn.
+- **`qk-context-manager`**: Tóm tắt kiến trúc dự án.
+
+### 🗄️ Backend (Máy chủ)
+- **`qk-database-engineer`**: Thiết kế Schema, ORM (Prisma/Drizzle), Migration.
+- **`qk-backend-architecture`**: Setup kiến trúc Backend (Node/Nest/Python).
+- **`qk-auth-security`**: Phân quyền RBAC, JWT, OAuth.
+- **`qk-deployment`**: Viết Dockerfile, CI/CD Pipeline.
+
+---
+
+## 💡 2. Mẹo sử dụng Nâng cao (Pro-Tips)
+
+### Mẹo 1: Kết hợp Kỹ năng (Skill Chaining) 🔗
+Đừng bắt AI làm từ A-Z bằng 1 câu prompt. Hãy gọi liên hoàn:
+> *"Hãy dùng `./qk-api-integration` để bóc tách API này thành hook React Query. Sau đó dùng `./qk-table-crud-generator` vẽ cái Bảng hiển thị danh sách tích hợp hook đó."*
+
+### Mẹo 2: Chế độ "Một phát ăn ngay" (End-to-End) 🚀
+Nếu bạn đã có sẵn 1 màn hình UI (chỉ thiếu data), hãy ép `qk-api-integration` làm End-to-End:
+> *"./qk-api-integration Dưới đây là API Get Profile. Hãy khai báo Type, viết Hook và TÍCH HỢP THẲNG LUÔN vào file \`Profile.tsx\` đang mở."*
+
+### Mẹo 3: Truyền tham số ép buộc (Arguments) 🎯
+Bạn có thể ép AI dùng công nghệ bạn muốn bằng cách thêm \`--tham_số\`:
+> *"./qk-ui-builder --fw=react --css=tailwind Hãy vẽ màn hình Đăng nhập."*
+
+### Mẹo 4: Nhờ "Kiến trúc sư" phân việc 🧠
+Nếu bạn có một tính năng quá lớn (ví dụ: Làm tính năng Giỏ Hàng), đừng tự chia việc, hãy gọi:
+> *"./qk-agent-orchestrator Tôi muốn làm tính năng Giỏ hàng. Hãy phân tích và lên kế hoạch gọi các skill \`qk-\` nào cho phù hợp."*

package/skills/qk-policy-engine/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: qk-policy-engine
+purpose: Động cơ xét duyệt chính sách, đảm bảo tác vụ hợp lệ trước khi thực thi.
+mode_supported: [enterprise]
+input: [Task request]
+output: [Policy validation result]
+workflow: [1. Đọc chính sách -> 2. Đối chiếu request -> 3. Phê duyệt/Từ chối]
+allowed_tools: [read_file]
+handoff_to: [qk-access-policy]
+---
+
+# 🛠️ qk-policy-engine - Quy Trình Vận Hành Chuẩn (SOP)
+
+> **Mô tả:** Động cơ xét duyệt chính sách, đảm bảo tác vụ hợp lệ trước khi thực thi.
+
+## 🎯 1. Mục Tiêu (Goal)
+- Hoàn thành thành công tác vụ được giao liên quan đến nhiệm vụ của skill.
+- Đảm bảo chất lượng mã nguồn và tính nhất quán của hệ thống.
+
+## 🔄 2. Chuỗi Hành Động (Chain of Thought / SOP)
+*(Bắt buộc AI phải suy nghĩ và làm theo đúng thứ tự)*
+1. **Phân tích (Analyze):** Thu thập ngữ cảnh và hiểu rõ yêu cầu đầu vào.
+2. **Lên kế hoạch (Plan):** Xác định các bước cần thay đổi/tạo mới dựa trên bộ luật (rules).
+3. **Thực thi (Execute):** Tiến hành sửa đổi mã nguồn hoặc tạo tài liệu.
+4. **Xác thực (Verify):** Đảm bảo đầu ra đáp ứng đúng yêu cầu và không vi phạm quy định.
+
+## 🛡️ 3. Ràng Buộc & Quy Tắc (Constraints)
+- CẤM bỏ qua việc kiểm tra `qk-engineering-standard` trước khi viết code.
+- Mọi quyết định kỹ thuật phải dựa trên nội dung tại phần Deep Knowledge (nếu có).
+
+## 🤝 4. Giao Thức Bàn Giao (Handoff Protocol)
+- Đích đến: `qk-access-policy`
+- Nội dung bàn giao: Chuyển toàn bộ ngữ cảnh và kết quả đã thực thi cho bước tiếp theo.

package/skills/qk-production-release/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: qk-production-release
+purpose: Build, CI/CD, Deploy, Observability, Security Release.
+mode_supported: [enterprise]
+input: [Release candidate]
+output: [Production deployment]
+workflow: [1. Build -> 2. CI -> 3. Deploy -> 4. Observe -> 5. Security Audit]
+allowed_tools: [run_command]
+handoff_to: [none]
+---
+
+# 🛠️ qk-production-release - Quy Trình Vận Hành Chuẩn (SOP)
+
+> **Mô tả:** Build, CI/CD, Deploy, Observability, Security Release.
+
+## 🎯 1. Mục Tiêu (Goal)
+- Hoàn thành thành công tác vụ được giao liên quan đến nhiệm vụ của skill.
+- Đảm bảo chất lượng mã nguồn và tính nhất quán của hệ thống.
+
+## 🔄 2. Chuỗi Hành Động (Chain of Thought / SOP)
+*(Bắt buộc AI phải suy nghĩ và làm theo đúng thứ tự)*
+1. **Phân tích (Analyze):** Thu thập ngữ cảnh và hiểu rõ yêu cầu đầu vào.
+2. **Lên kế hoạch (Plan):** Xác định các bước cần thay đổi/tạo mới dựa trên bộ luật (rules).
+3. **Thực thi (Execute):** Tiến hành sửa đổi mã nguồn hoặc tạo tài liệu.
+4. **Xác thực (Verify):** Đảm bảo đầu ra đáp ứng đúng yêu cầu và không vi phạm quy định.
+
+## 🛡️ 3. Ràng Buộc & Quy Tắc (Constraints)
+- CẤM bỏ qua việc kiểm tra `qk-engineering-standard` trước khi viết code.
+- Mọi quyết định kỹ thuật phải dựa trên nội dung tại phần Deep Knowledge (nếu có).
+
+## 🤝 4. Giao Thức Bàn Giao (Handoff Protocol)
+- Đích đến: `none`
+- Nội dung bàn giao: Chuyển toàn bộ ngữ cảnh và kết quả đã thực thi cho bước tiếp theo.
+
+## 📚 5. Kiến Thức Chuyên Sâu (Deep Knowledge)
+
+*(Nền tảng kiến thức và quy tắc chi tiết kế thừa từ kỹ sư)*
+
+---
+
+
+
+# Deployment & DevOps
+
+> **Language rule:**
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
+
+---
+
+## Trigger
+
+Activate this skill when:
+- User asks "how do I deploy this?", "create a Dockerfile", or "setup CI/CD"
+- Configuring GitHub Actions, GitLab CI, or Jenkins
+- Preparing a project for Vercel, Netlify, Render, or AWS
+- Setting up environment variables for production
+
+---
+
+## Scope
+
+- ✅ **Containerization:** Write `Dockerfile` and `docker-compose.yml`.
+- ✅ **CI/CD Pipelines:** Write GitHub Actions YAML for testing, building, and deploying.
+- ✅ **Environment Setup:** Create `.env.example` and document required production variables.
+- ✅ **Build Scripts:** Ensure `package.json` has correct build and start commands.
+
+---
+
+## Non-goals
+
+- ❌ Do NOT expose real production secrets. Always use placeholders or CI secrets.
+- ❌ Do NOT over-complicate (e.g., don't setup Kubernetes if a simple Docker container on a VPS is enough).
+
+---
+
+## Workflow
+
+### Phase 1 — Platform Selection
+
+Ask the user where they are deploying (if not specified):
+1. **PaaS (Vercel, Render, Heroku):** Very easy, mostly relies on `vercel.json` or standard build scripts. No Docker needed usually.
+2. **VPS/VM (DigitalOcean, AWS EC2):** Needs Docker and/or PM2 + Nginx reverse proxy.
+3. **Container Service (AWS ECS, Google Cloud Run):** Needs a highly optimized Dockerfile.
+
+### Phase 2 — Containerization (If required)
+
+Create a multi-stage Dockerfile for minimal image size:
+1. `deps` stage: Install dependencies.
+2. `builder` stage: Build the app.
+3. `runner` stage: Copy only the built assets and prod modules, start the app.
+
+### Phase 3 — CI/CD Pipeline
+
+Create `.github/workflows/deploy.yml`:
+- Trigger on `push` to `main`.
+- Job 1: Setup Node/Python/Go, install deps, run tests, run linter.
+- Job 2: Build image and push to registry, or deploy to PaaS.
+
+### Phase 4 — Environment Variables
+
+Audit the codebase for `process.env.XYZ` and create a `.env.example` file listing every required variable.
+
+---
+
+## Output Format
+
+```
+🚀 Deployment Plan
+─────────────────────────────────────────────────
+Target:     [Vercel / Docker VPS / AWS]
+Tooling:    [GitHub Actions, Docker]
+
+Files Created/Modified:
+  ✅ `Dockerfile` (Multi-stage build)
+  ✅ `.github/workflows/deploy.yml`
+  ✅ `.env.example`
+
+⚠️ Prerequisites:
+  Before deploying, you must set these secrets in GitHub Actions:
+  - `DOCKER_USERNAME`
+  - `DATABASE_URL`
+
+🔗 Next Steps:
+  Commit these files and push to `main` to trigger the pipeline.
+```

package/skills/qk-project-bootstrap/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: qk-project-bootstrap
+purpose: Khởi tạo hệ thống, setup dự án chuẩn từ con số 0.
+mode_supported: [enterprise]
+input: [Project specs]
+output: [Scaffolded project]
+workflow: [1. Setup Folder -> 2. Config Lint/Format -> 3. Setup UI/API/Test]
+allowed_tools: [run_command, write_to_file]
+handoff_to: [none]
+---
+
+# 🛠️ qk-project-bootstrap - Quy Trình Vận Hành Chuẩn (SOP)
+
+> **Mô tả:** Khởi tạo hệ thống, setup dự án chuẩn từ con số 0.
+
+## 🎯 1. Mục Tiêu (Goal)
+- Hoàn thành thành công tác vụ được giao liên quan đến nhiệm vụ của skill.
+- Đảm bảo chất lượng mã nguồn và tính nhất quán của hệ thống.
+
+## 🔄 2. Chuỗi Hành Động (Chain of Thought / SOP)
+*(Bắt buộc AI phải suy nghĩ và làm theo đúng thứ tự)*
+1. **Phân tích (Analyze):** Thu thập ngữ cảnh và hiểu rõ yêu cầu đầu vào.
+2. **Lên kế hoạch (Plan):** Xác định các bước cần thay đổi/tạo mới dựa trên bộ luật (rules).
+3. **Thực thi (Execute):** Tiến hành sửa đổi mã nguồn hoặc tạo tài liệu.
+4. **Xác thực (Verify):** Đảm bảo đầu ra đáp ứng đúng yêu cầu và không vi phạm quy định.
+
+## 🛡️ 3. Ràng Buộc & Quy Tắc (Constraints)
+- CẤM bỏ qua việc kiểm tra `qk-engineering-standard` trước khi viết code.
+- Mọi quyết định kỹ thuật phải dựa trên nội dung tại phần Deep Knowledge (nếu có).
+
+## 🤝 4. Giao Thức Bàn Giao (Handoff Protocol)
+- Đích đến: `none`
+- Nội dung bàn giao: Chuyển toàn bộ ngữ cảnh và kết quả đã thực thi cho bước tiếp theo.