ai-developer-skill-os 2.1.1 → 3.1.0

package/skills.json

@@ -1,7 +1,7 @@
 {
-  "version": "1.0.1",
+  "version": "3.0.1",
   "name": "AI Developer Skill OS",
-  "description": "Multi-agent skill package for AI coding agents — Engineering + Frontend + Backend",
+  "description": "Enterprise-ready Agentic Framework for AI Coding Agents — Engineering + Frontend + Backend",
   "language": "en",
   "author": "Quang Khánh",
   "homepage": "https://github.com/phamquangkhanh2999/ai-developer-skill-os.git",
@@ -27,7 +27,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Tra cứu danh sách toàn bộ kỹ năng (skills) hiện có và đọc các mẹo kết hợp để code hiệu quả."
     },
     {
@@ -53,7 +53,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Phân tích yêu cầu, lên kế hoạch thực thi chi tiết và điều phối các tác vụ cho đúng skill. Không tự viết code."
     },
     {
@@ -78,7 +78,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Xác định các file cần thiết, tóm tắt kiến trúc và quản lý bộ nhớ ngữ cảnh để tránh tràn bộ nhớ."
     },
     {
@@ -108,13 +108,13 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Kiểm toán toàn bộ dự án để phát hiện bug ẩn, rủi ro bảo mật, vấn đề hiệu năng và nợ kỹ thuật trước khi sửa code."
     },
     {
-      "name": "qk-bug-fix",
-      "path": "skills/qk-bug-fix/SKILL.md",
-      "version": "2.0.0",
+      "name": "qk-bug-resolution",
+      "path": "skills/qk-bug-resolution/SKILL.md",
+      "version": "3.0.0",
       "category": "engineering",
       "priority": "P0",
       "trigger": [
@@ -136,7 +136,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "migrating",
+      "status": "ready",
       "description": "Chẩn đoán và sửa lỗi an toàn. Tái hiện lỗi, tìm nguyên nhân gốc rễ và áp dụng bản sửa lỗi tối thiểu, có kiểm chứng."
     },
     {
@@ -164,7 +164,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Tái cấu trúc và dọn dẹp mã nguồn để dễ bảo trì hơn mà không làm thay đổi logic hoạt động bên ngoài."
     },
     {
@@ -192,7 +192,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "migrating",
+      "status": "ready",
       "description": "Chuyển đổi tài liệu API (curl, swagger...) thành code tích hợp frontend chuẩn xác, có type an toàn và xử lý lỗi."
     },
     {
@@ -221,7 +221,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Nâng cấp dependency, chuyển đổi framework và thay thế thư viện một cách an toàn với chiến lược không downtime."
     },
     {
@@ -247,7 +247,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Viết commit message chuẩn Conventional Commits, mô tả Pull Request, Changelog và Release Notes chuyên nghiệp."
     },
     {
@@ -274,7 +274,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Phân tích cấu trúc thư mục frontend và quyết định vị trí đặt file chuẩn xác theo kiến trúc hiện tại."
     },
     {
@@ -302,7 +302,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Ép buộc sử dụng design system, component library và token hiện có, ngăn chặn việc viết HTML/CSS rác."
     },
     {
@@ -332,7 +332,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Xây dựng các màn hình và layout phức tạp từ yêu cầu, tái sử dụng component và đảm bảo responsive."
     },
     {
@@ -359,7 +359,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Tạo các UI Component độc lập, tái sử dụng được, có type an toàn và tuân thủ chuẩn design system."
     },
     {
@@ -388,7 +388,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Xác định và triển khai chiến lược quản lý state phù hợp (Zustand, Redux, React Query, Local State)."
     },
     {
@@ -418,7 +418,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Xây dựng Form chuẩn xác với quản lý trạng thái, validate dữ liệu (Zod, Yup) và xử lý hiển thị lỗi."
     },
     {
@@ -448,7 +448,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Tạo các bảng dữ liệu admin với đầy đủ tính năng phân trang, sắp xếp, lọc và thao tác thêm/sửa/xóa (CRUD)."
     },
     {
@@ -475,7 +475,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Chẩn đoán và sửa các lỗi đặc thù frontend như Hydration error, infinite re-render, stale closure và vỡ CSS."
     },
     {
@@ -504,7 +504,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Viết Unit, Component và E2E test bằng Jest, Vitest, RTL, Cypress. Tập trung vào hành vi người dùng."
     },
     {
@@ -532,7 +532,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Tối ưu hóa hiệu năng frontend: giảm kích thước bundle, chặn re-render thừa, lazy load và cải thiện Web Vitals."
     },
     {
@@ -560,7 +560,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Kiểm tra và sửa lỗi khả năng tiếp cận (a11y/WCAG). Đảm bảo hỗ trợ phím, screen reader và semantic HTML."
     },
     {
@@ -587,7 +587,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Kiểm soát cấu trúc backend, ép buộc tuân thủ mô hình Layer (Controller/Service/Repository) và vị trí file."
     },
     {
@@ -617,7 +617,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Thiết kế database schema, viết script migration và tối ưu truy vấn cho SQL/NoSQL bằng ORM (Prisma, Drizzle...)."
     },
     {
@@ -646,7 +646,7 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Triển khai tính năng đăng nhập (JWT, OAuth), phân quyền (RBAC) và bảo vệ app khỏi các lỗ hổng OWASP."
     },
     {
@@ -673,19 +673,15 @@
         "cursor",
         "windsurf"
       ],
-      "status": "planned",
+      "status": "ready",
       "description": "Cấu hình CI/CD pipelines, tạo Dockerfile và thiết lập môi trường để deploy lên Vercel, AWS hoặc VPS."
     }
   ],
-  "entries": [
-    {
-      "path": "skills/qk-"
-    },
-    {
-      "path": "skills/qk-"
-    },
-    {
-      "path": "skills/qk-"
-    }
-  ]
+  "categories": {
+    "orchestration": ["qk-orchestrator", "qk-context-loader", "qk-policy-engine", "qk-access-policy"],
+    "engineering": ["qk-feature-delivery", "qk-api-lifecycle", "qk-data-lifecycle", "qk-design-to-code", "qk-system-evolution", "qk-project-bootstrap"],
+    "validation": ["qk-validation-gate", "qk-engineering-standard", "qk-ui-audit", "qk-project-health", "qk-bug-resolution"],
+    "ops": ["qk-production-release", "qk-ai-builder", "qk-project-bootstrap", "qk-docs", "qk-documentation-system", "qk-project-memory"],
+    "knowledge": ["knowledge/frontend/react.md", "knowledge/backend/nodejs.md"]
+  }
 }

package/templates/bug-report.md

@@ -0,0 +1,21 @@
+### 🐛 Báo Cáo Xử Lý Lỗi (Bug Report)
+
+**1. Tóm tắt (Summary)**
+- [Tóm tắt ngắn gọn lỗi là gì và đã sửa như thế nào]
+
+**2. Chi tiết thay đổi (Changes)**
+- Cập nhật file: `[Tên file]`
+- Xóa/Thêm: [Logic cụ thể đã sửa]
+
+**3. Nguyên nhân gốc rễ (Reason / Root Cause)**
+- Tại sao lỗi này xảy ra? (Giải thích kỹ thuật ngắn gọn)
+- Tại sao cách sửa này lại hiệu quả?
+
+**4. Xác thực (Verification)**
+- Làm sao để biết lỗi đã được sửa? (Test script hoặc các bước tái hiện)
+
+**5. Rủi ro (Risks / Side Effects)**
+- Việc sửa lỗi này có ảnh hưởng đến component nào khác không? (Nếu không, ghi "An toàn").
+
+**6. Hành động tiếp theo (Next Action)**
+- [Đề xuất bước tiếp theo: chạy test, deploy, hoặc bàn giao]

package/templates/design-report.md

@@ -0,0 +1,21 @@
+### 🎨 Báo Cáo Triển Khai Giao Diện (Design / UI Report)
+
+**1. Tóm tắt (Summary)**
+- [Tên Component/Trang vừa được code từ Design]
+
+**2. Chi tiết thay đổi (Changes)**
+- [Các CSS/Tailwind classes đã sử dụng]
+- [Cấu trúc Semantic HTML]
+
+**3. Quyết định UI/UX (Reason / Design Tokens)**
+- [Map màu sắc/font với Design System]
+
+**4. Xác thực (Verification)**
+- Responsive: [Đã test trên Mobile/Tablet chưa]
+- Accessibility (a11y): [Đã kiểm tra alt text, aria-label chưa]
+
+**5. Rủi ro (Risks / Side Effects)**
+- [Có dùng magic numbers (px cứng) thay vì token không?]
+
+**6. Hành động tiếp theo (Next Action)**
+- [Đề xuất: Gửi cho Designer review]

package/templates/feature-report.md

@@ -0,0 +1,20 @@
+### 🚀 Báo Cáo Triển Khai Tính Năng (Feature Report)
+
+**1. Tóm tắt (Summary)**
+- [Mô tả ngắn gọn tính năng vừa được phát triển]
+
+**2. Chi tiết thay đổi (Changes)**
+- Frontend: [Các component/UI đã thêm]
+- Backend/API: [Các endpoint/schema đã cập nhật]
+
+**3. Kiến trúc thiết kế (Reason / Design Reasoning)**
+- [Giải thích lựa chọn state management, hooks, hoặc cấu trúc DB]
+
+**4. Xác thực (Verification)**
+- [Cách chạy thử hoặc test case đã pass]
+
+**5. Rủi ro (Risks / Side Effects)**
+- [Có ảnh hưởng đến hiệu năng không? Bundle size?]
+
+**6. Hành động tiếp theo (Next Action)**
+- [Đề xuất: Chạy E2E test, Handoff sang QA]

package/templates/review-report.md

@@ -0,0 +1,21 @@
+### 📐 Báo Cáo Rà Soát Mã Nguồn (Code Review Report)
+
+**1. Tóm tắt (Summary)**
+- [Scope code đã được review]
+
+**2. Vấn đề phát hiện (Changes / Smells Detected)**
+- Lỗi Naming: [Chi tiết]
+- Vấn đề Clean Code: [Chi tiết]
+- Vi phạm SOLID/DRY: [Chi tiết]
+
+**3. Đề xuất & Giải pháp (Reasoning / Fixes Applied)**
+- [Tại sao phải sửa và code đã được refactor như thế nào]
+
+**4. Xác thực (Verification)**
+- [Kết quả chạy linter và type-checker sau khi sửa]
+
+**5. Rủi ro (Risks / Side Effects)**
+- [Có thể gây break API cũ không?]
+
+**6. Hành động tiếp theo (Next Action)**
+- [Đề xuất: Merge nhánh, Handoff sang Validation Gate]

package/templates/skill-template.md

@@ -0,0 +1,38 @@
+---
+name: qk-[skill-name]
+version: 1.0.0
+updated: YYYY-MM-DD
+description: Brief, action-oriented description of what this skill does.
+category: engineering # general category
+behavior: static-analysis # static-analysis | development | validation | maintenance
+intent: review-code # review-code | fix-bug | implement-feature | validate | maintain
+priority: medium # low | medium | high | critical
+tags: [tag1, tag2]
+platforms: [claude-code, cursor, windsurf, gemini-cli]
+trigger: Natural language trigger phrase.
+inputs: [List of required inputs]
+outputs: [Expected output format]
+allowed_tools: [read_file, write_to_file]
+pipeline: [analyze, plan, implement, validate, complete]
+---
+
+# 🛠️ qk-[skill-name] - Standard Operating Procedure
+
+> **Goal:** [State the primary objective of this skill clearly]
+
+## 🔄 1. Chain of Thought (SOP)
+1. **Analyze:**
+   - Step 1...
+2. **Plan:**
+   - Step 2...
+3. **Implement:**
+   - Step 3...
+4. **Verify:**
+   - Step 4...
+
+## 🛡️ 2. Constraints & Rules
+- **Rule 1:** [Hard constraint 1]
+- **Rule 2:** [Hard constraint 2]
+
+## 🤝 3. Handoff Pipeline (Optional)
+- Pass to `qk-validation-gate` upon completion if necessary.