ai-developer-skill-os 1.0.5 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -19
- package/bin/install.js +3 -3
- package/docs/HUONG_DAN_SU_DUNG.md +28 -16
- package/package.json +1 -1
- package/skills/backend/{auth-security → qk-auth-security}/SKILL.md +1 -1
- package/skills/backend/{backend-architecture → qk-backend-architecture}/SKILL.md +1 -1
- package/skills/backend/{deployment → qk-deployment}/SKILL.md +1 -1
- package/skills/engineering/{context-manager → qk-context-manager}/SKILL.md +1 -1
- package/skills/engineering/{migration → qk-migration}/SKILL.md +1 -1
- package/skills/engineering/{project-audit → qk-project-audit}/SKILL.md +1 -1
- package/skills/engineering/{refactor → qk-refactor}/SKILL.md +1 -1
- package/skills/frontend/{frontend-testing → qk-frontend-testing}/SKILL.md +1 -1
- package/skills/frontend/{ui-builder → qk-ui-builder}/SKILL.md +1 -1
- package/skills.json +666 -666
package/README.md
CHANGED
|
@@ -30,12 +30,12 @@ Mở terminal tại thư mục gốc dự án của bạn và chạy:
|
|
|
30
30
|
```bash
|
|
31
31
|
npx ai-developer-skill-os init
|
|
32
32
|
```
|
|
33
|
-
*Lệnh này sẽ tự động tải và khởi tạo thư mục
|
|
33
|
+
*Lệnh này sẽ tự động tải và khởi tạo thư mục ẩn `.qk-ai-skill-os/` chứa toàn bộ kỹ năng vào dự án của bạn.*
|
|
34
34
|
|
|
35
35
|
### Cách 2: Sử dụng Git Submodule
|
|
36
36
|
Nếu bạn không dùng Node.js, bạn có thể nhúng trực tiếp qua Git:
|
|
37
37
|
```bash
|
|
38
|
-
git submodule add https://github.com/phamquangkhanh2999/ai-developer-skill-os.git
|
|
38
|
+
git submodule add https://github.com/phamquangkhanh2999/ai-developer-skill-os.git .qk-ai-skill-os
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
---
|
|
@@ -47,21 +47,23 @@ Sau khi thư mục kỹ năng đã xuất hiện trong dự án của bạn, hã
|
|
|
47
47
|
### Cho Antigravity / Gemini IDE
|
|
48
48
|
**Không cần cấu hình gì thêm!** Nếu bạn đã cài đặt bằng cờ `--gemini` (thư mục `.agents/skills/`), hệ thống sẽ tự động quét và load toàn bộ 23 kỹ năng này. Bạn có thể sử dụng ngay lập tức!
|
|
49
49
|
|
|
50
|
-
### Cho
|
|
51
|
-
Tạo file
|
|
50
|
+
### Cho Claude Code / Kilo Code (CLI Agents)
|
|
51
|
+
Tạo file `CLAUDE.md` (hoặc `KILO.md`) ở gốc dự án và dán đoạn sau vào:
|
|
52
52
|
```md
|
|
53
|
-
#
|
|
53
|
+
# System Instructions
|
|
54
|
+
Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
|
|
54
55
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
56
|
+
Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`.
|
|
57
|
+
ĐẶC BIỆT LƯU Ý: Bất cứ khi nào người dùng gõ lệnh bắt đầu bằng `./qk [tên-skill]`, bạn BẮT BUỘC phải gọi và đọc nội dung file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/skills/` trước khi phân tích hoặc viết code.
|
|
58
|
+
Luôn giao tiếp bằng tiếng Việt nhưng viết code, đặt tên biến, comment trong code bằng tiếng Anh.
|
|
58
59
|
```
|
|
59
60
|
|
|
60
|
-
### Cho Cline / Roo Code
|
|
61
|
-
Tạo file `.clinerules
|
|
61
|
+
### Cho Cline / Roo Code (VS Code Extensions)
|
|
62
|
+
Tạo file `.clinerules` hoặc `.roorules` ở gốc dự án và dán nội dung:
|
|
62
63
|
```md
|
|
63
64
|
Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
|
|
64
|
-
Vui lòng tìm đọc danh sách kỹ năng tại file
|
|
65
|
+
Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`.
|
|
66
|
+
Bất cứ khi nào người dùng gõ lệnh `./qk [tên-skill]`, bạn BẮT BUỘC phải đọc file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/skills/`.
|
|
65
67
|
Luôn giao tiếp bằng tiếng Việt nhưng viết code bằng tiếng Anh.
|
|
66
68
|
```
|
|
67
69
|
|
|
@@ -72,31 +74,31 @@ Tạo file `.github/copilot-instructions.md` và dán đoạn prompt tương t
|
|
|
72
74
|
|
|
73
75
|
## 🎯 Cách kiểm tra cài đặt thành công
|
|
74
76
|
|
|
75
|
-
Để biết AI của bạn đã thực sự "nhập môn" bộ Skill OS này chưa, hãy mở khung chat AI trong dự án và gõ
|
|
76
|
-
>
|
|
77
|
+
Để biết AI của bạn đã thực sự "nhập môn" bộ Skill OS này chưa, hãy mở khung chat AI trong dự án và gõ cú pháp lệnh chuyên nghiệp sau:
|
|
78
|
+
> **`./qk project-audit`** Hãy cho tôi biết bạn sẽ làm những gì.
|
|
77
79
|
|
|
78
80
|
✅ **Thành công:** Nếu AI trả lời bằng tiếng Việt, liệt kê đúng các bước khám bệnh (Phase 1, Phase 2, Phase 3...) theo đúng như trong file `SKILL.md` của `project-audit`.
|
|
79
81
|
❌ **Thất bại:** Nếu AI trả lời chung chung hoặc bảo không biết skill này là gì, bạn cần kiểm tra lại đường dẫn file cấu hình ở bước trên.
|
|
80
82
|
|
|
81
83
|
---
|
|
82
84
|
|
|
83
|
-
## 🚀 Cách
|
|
85
|
+
## 🚀 Cách gọi lệnh Skill chuyên nghiệp (Usage)
|
|
84
86
|
|
|
85
|
-
AI sẽ tự động nhận diện skill qua ngữ cảnh, nhưng để chắc chắn 100
|
|
87
|
+
AI sẽ tự động nhận diện skill qua ngữ cảnh, nhưng để chắc chắn 100% và tiết kiệm thời gian gõ prompt, bạn hãy dùng cú pháp lệnh độc quyền: **`./qk [tên-skill]`**
|
|
86
88
|
|
|
87
89
|
Dưới đây là các ví dụ cụ thể để bạn copy - paste và trải nghiệm ngay:
|
|
88
90
|
|
|
89
91
|
### 1. Khi bắt đầu dự án / Nhờ AI lên kế hoạch (Planning)
|
|
90
|
-
>
|
|
92
|
+
> **`./qk agent-orchestrator`** Hãy lên kế hoạch làm tính năng Giỏ Hàng cho tôi. Nhớ gọi thêm **`./qk context-manager`** để kiểm tra thư mục hiện tại có những file gì trước nhé.
|
|
91
93
|
|
|
92
94
|
### 2. Khi muốn tạo Giao diện (UI)
|
|
93
|
-
>
|
|
95
|
+
> **`./qk ui-builder`** & **`./qk design-system`** Hãy tạo cho tôi một màn hình Đăng Nhập (Login) sử dụng Tailwind CSS.
|
|
94
96
|
|
|
95
97
|
### 3. Khi muốn làm việc với Database (Backend)
|
|
96
|
-
>
|
|
98
|
+
> **`./qk database-engineer`** Hãy viết cho tôi schema Prisma cho bảng Product và User có quan hệ 1-N.
|
|
97
99
|
|
|
98
100
|
### 4. Khi gặp Bug cứng đầu
|
|
99
|
-
>
|
|
101
|
+
> **`./qk frontend-debug`** & **`./qk bug-fix`** Code đang bị crash với lỗi `Hydration error`. Hãy tìm hiểu nguyên nhân gốc rễ và sửa nó giúp tôi.
|
|
100
102
|
|
|
101
103
|
👉 [Đọc Hướng Dẫn Sử Dụng chi tiết tại đây](docs/HUONG_DAN_SU_DUNG.md)
|
|
102
104
|
|
package/bin/install.js
CHANGED
|
@@ -4,7 +4,7 @@ const fs = require('fs');
|
|
|
4
4
|
const path = require('path');
|
|
5
5
|
|
|
6
6
|
const sourceDir = path.join(__dirname, '..');
|
|
7
|
-
let targetDir = path.join(process.cwd(), '
|
|
7
|
+
let targetDir = path.join(process.cwd(), '.qk-ai-skill-os');
|
|
8
8
|
|
|
9
9
|
// Check arguments for IDE-specific paths
|
|
10
10
|
const args = process.argv.slice(2);
|
|
@@ -35,7 +35,7 @@ console.log('🚀 Đang cài đặt AI Developer Skill OS...');
|
|
|
35
35
|
if (isGemini) {
|
|
36
36
|
console.log('⚙️ Chế độ: Gemini / Antigravity IDE (Cài vào thư mục .agents/skills/)');
|
|
37
37
|
} else {
|
|
38
|
-
console.log('⚙️ Chế độ: Mặc định (Cài vào thư mục
|
|
38
|
+
console.log('⚙️ Chế độ: Mặc định (Cài vào thư mục .qk-ai-skill-os/)');
|
|
39
39
|
}
|
|
40
40
|
|
|
41
41
|
const filesAndFolders = [
|
|
@@ -64,7 +64,7 @@ try {
|
|
|
64
64
|
});
|
|
65
65
|
|
|
66
66
|
console.log(`✅ Đã cài đặt thành công vào thư mục: ${targetDir.replace(process.cwd(), '.')}`);
|
|
67
|
-
console.log('\n💡 Tiếp theo, hãy tham khảo tài liệu trong mục docs/HUONG_DAN_SU_DUNG.md để biết cách tương tác với AI nhé!');
|
|
67
|
+
console.log('\n💡 Tiếp theo, hãy tham khảo tài liệu trong mục .qk-ai-skill-os/docs/HUONG_DAN_SU_DUNG.md để biết cách tương tác với AI nhé!');
|
|
68
68
|
} catch (error) {
|
|
69
69
|
console.error('❌ Có lỗi xảy ra trong quá trình cài đặt:', error.message);
|
|
70
70
|
process.exit(1);
|
|
@@ -38,7 +38,7 @@ Các công cụ này linh hoạt hơn, bạn cài đặt mặc định:
|
|
|
38
38
|
```bash
|
|
39
39
|
npx ai-developer-skill-os init
|
|
40
40
|
```
|
|
41
|
-
*Lệnh này sẽ tạo thư mục
|
|
41
|
+
*Lệnh này sẽ tạo thư mục `.qk-ai-skill-os/` ở gốc dự án.*
|
|
42
42
|
|
|
43
43
|
---
|
|
44
44
|
|
|
@@ -54,16 +54,28 @@ Tạo file `.cursorrules` (nếu dùng Cursor) hoặc `.windsurfrules` (nếu d
|
|
|
54
54
|
```md
|
|
55
55
|
# AI Developer Skill OS by Quang Khánh
|
|
56
56
|
|
|
57
|
-
When answering or generating code, you MUST act as an expert engineer using the skills defined in
|
|
58
|
-
|
|
57
|
+
When answering or generating code, you MUST act as an expert engineer using the skills defined in `./.qk-ai-skill-os/skills.json`.
|
|
58
|
+
Bất cứ khi nào người dùng gõ lệnh `./qk [tên-skill]`, bạn BẮT BUỘC phải đọc file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/skills/` trước khi thực hiện.
|
|
59
59
|
Speak to me in Vietnamese, but write all code in English.
|
|
60
60
|
```
|
|
61
61
|
|
|
62
|
-
### Cho
|
|
63
|
-
Tạo file
|
|
62
|
+
### Cho Claude Code / Kilo Code (CLI Agents)
|
|
63
|
+
Tạo file `CLAUDE.md` (hoặc `KILO.md`) ở gốc dự án và dán đoạn sau vào:
|
|
64
64
|
```md
|
|
65
|
+
# System Instructions
|
|
65
66
|
Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
|
|
66
|
-
|
|
67
|
+
|
|
68
|
+
Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`.
|
|
69
|
+
ĐẶC BIỆT LƯU Ý: Bất cứ khi nào người dùng gõ lệnh bắt đầu bằng `./qk [tên-skill]`, bạn BẮT BUỘC phải gọi và đọc nội dung file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/skills/` trước khi phân tích hoặc viết code.
|
|
70
|
+
Luôn giao tiếp bằng tiếng Việt nhưng viết code, đặt tên biến, comment trong code bằng tiếng Anh.
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### Cho Cline / Roo Code (VS Code Extensions)
|
|
74
|
+
Tạo file `.clinerules` hoặc `.roorules` ở gốc dự án và dán nội dung:
|
|
75
|
+
```md
|
|
76
|
+
Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
|
|
77
|
+
Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`.
|
|
78
|
+
Bất cứ khi nào người dùng gõ lệnh `./qk [tên-skill]`, bạn BẮT BUỘC phải đọc file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/skills/`.
|
|
67
79
|
Luôn giao tiếp bằng tiếng Việt nhưng viết code bằng tiếng Anh.
|
|
68
80
|
```
|
|
69
81
|
|
|
@@ -74,34 +86,34 @@ Tạo file `.github/copilot-instructions.md` và dán đoạn prompt tương t
|
|
|
74
86
|
|
|
75
87
|
## 4. Cách kiểm tra cài đặt thành công
|
|
76
88
|
|
|
77
|
-
Để biết AI của bạn đã thực sự "nhập môn" bộ Skill OS này chưa, hãy mở khung chat AI trong dự án và gõ
|
|
78
|
-
>
|
|
89
|
+
Để biết AI của bạn đã thực sự "nhập môn" bộ Skill OS này chưa, hãy mở khung chat AI trong dự án và gõ cú pháp lệnh chuyên nghiệp sau:
|
|
90
|
+
> **`./qk project-audit`** Hãy cho tôi biết bạn sẽ làm những gì.
|
|
79
91
|
|
|
80
92
|
✅ **Thành công:** Nếu AI trả lời bằng tiếng Việt, liệt kê đúng các bước khám bệnh (Phase 1, Phase 2, Phase 3...) theo đúng như trong file `SKILL.md` của `project-audit`.
|
|
81
93
|
❌ **Thất bại:** Nếu AI trả lời chung chung hoặc bảo không biết skill này là gì, bạn cần kiểm tra lại đường dẫn file cấu hình ở bước trên.
|
|
82
94
|
|
|
83
95
|
---
|
|
84
96
|
|
|
85
|
-
## 5. Cách
|
|
97
|
+
## 5. Cách gọi lệnh Skill chuyên nghiệp (Usage)
|
|
86
98
|
|
|
87
|
-
|
|
99
|
+
AI sẽ tự động nhận diện skill qua ngữ cảnh, nhưng cách chuyên nghiệp và tiết kiệm thời gian gõ prompt nhất là bạn sử dụng cú pháp lệnh độc quyền: **`./qk [tên-skill]`**
|
|
88
100
|
|
|
89
101
|
Dưới đây là các câu lệnh (prompt) mẫu cực kỳ hiệu quả mà bạn nên dùng:
|
|
90
102
|
|
|
91
103
|
### 🎯 Ví dụ 1: Nhờ AI lên kế hoạch (Planning)
|
|
92
|
-
>
|
|
104
|
+
> **`./qk agent-orchestrator`** Hãy lên kế hoạch làm tính năng Đăng nhập này cho tôi. Nhớ gọi thêm **`./qk context-manager`** để kiểm tra thư mục hiện tại có những file gì trước nhé.
|
|
93
105
|
|
|
94
106
|
### 🎯 Ví dụ 2: Fix lỗi cứng đầu (Bug Fix)
|
|
95
|
-
>
|
|
107
|
+
> **`./qk frontend-debug`** & **`./qk bug-fix`** Code đang bị crash với lỗi `Hydration error`. Hãy tìm hiểu nguyên nhân gốc rễ và sửa nó giúp tôi.
|
|
96
108
|
|
|
97
109
|
### 🎯 Ví dụ 3: Review Codebase (Audit)
|
|
98
|
-
>
|
|
110
|
+
> **`./qk project-audit`** Hãy kiểm tra nhanh cho tôi thư mục `src/components/` xem có bị vấn đề về hiệu năng hay code smell không.
|
|
99
111
|
|
|
100
112
|
### 🎯 Ví dụ 4: Xây dựng Giao diện Frontend (UI)
|
|
101
|
-
>
|
|
113
|
+
> **`./qk ui-builder`** & **`./qk design-system`** Hãy tạo cho tôi một màn hình Danh sách User. Chú ý dùng chuẩn components của thư mục `src/components/ui/` nhé.
|
|
102
114
|
|
|
103
115
|
### 🎯 Ví dụ 5: Làm việc với API (Backend & Integration)
|
|
104
|
-
>
|
|
116
|
+
> **`./qk api-integration`** Tích hợp cái swagger login này vào frontend giúp. Nhớ dùng React Query như chuẩn của project.
|
|
105
117
|
|
|
106
118
|
### 🎯 Ví dụ 6: Database & Backend
|
|
107
|
-
>
|
|
119
|
+
> **`./qk database-engineer`** Hãy viết cho tôi schema Prisma cho bảng Product và User có quan hệ 1-N. Làm theo đúng chuẩn kiến trúc trong skill.
|
package/package.json
CHANGED