ai-developer-skill-os 1.0.2 → 1.0.4

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.
Files changed (9) hide show
  1. package/README.md +21 -8
  2. package/docs/HUONG_DAN_SU_DUNG.md +18 -8
  3. package/package.json +1 -1
  4. package/skills/engineering/agent-orchestrator/SKILL.md +3 -2
  5. package/skills/engineering/api-integration/SKILL.md +3 -2
  6. package/skills/engineering/git-engineer/SKILL.md +3 -2
  7. package/skills/engineering/migration/SKILL.md +3 -2
  8. package/skills/engineering/project-audit/SKILL.md +3 -2
  9. package/skills/engineering/refactor/SKILL.md +3 -2
package/README.md CHANGED
@@ -42,7 +42,10 @@ git submodule add https://github.com/phamquangkhanh2999/ai-developer-skill-os.gi
42
42
 
43
43
  ## 🛠️ Cấu hình cho IDE / AI Agent
44
44
 
45
- Sau khi thư mục `rules-skill/` đã xuất hiện trong dự án của bạn, hãy cấu hình để AI biết cách sử dụng nó.
45
+ Sau khi thư mục kỹ năng đã xuất hiện trong dự án của bạn, hãy cấu hình để AI biết cách sử dụng nó.
46
+
47
+ ### Cho Antigravity / Gemini IDE
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!
46
49
 
47
50
  ### Cho Cursor / Windsurf (AI Code Editors)
48
51
  Tạo file `.cursorrules` (nếu dùng Cursor) hoặc `.windsurfrules` (nếu dùng Windsurf) ở gốc dự án và dán đoạn sau vào:
@@ -54,17 +57,27 @@ Always read the relevant `SKILL.md` from `./rules-skill/skills/` before providin
54
57
  Speak to me in Vietnamese, but write all code in English.
55
58
  ```
56
59
 
57
- ### Cho Claude Code / Kilo Code (CLI Agents)
58
- Tạo file `CLAUDE.md` (hoặc `KILO.md`) ở gốc dự án và dán đoạn sau vào:
60
+ ### Cho Cline / Roo Code / Kilo Code (VS Code Extensions)
61
+ Tạo file `.clinerules`, `.roorules` hoặc `KILO.md` ở gốc dự án và dán nội dung:
59
62
  ```md
60
- # System Instructions
61
63
  Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
62
-
63
- Vui lòng tìm đọc danh sách kỹ năng tại file `./rules-skill/skills.json`.
64
- Trước khi thực hiện bất kỳ yêu cầu nào, hãy gọi file `SKILL.md` tương ứng trong thư mục `./rules-skill/skills/` để biết quy trình làm việc chuẩn.
65
- 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.
64
+ Vui lòng tìm đọc danh sách kỹ năng tại file `./rules-skill/skills.json`. Trước khi thực hiện bất kỳ yêu cầu nào, hãy gọi file `SKILL.md` tương ứng trong thư mục `./rules-skill/skills/`.
65
+ Luôn giao tiếp bằng tiếng Việt nhưng viết code bằng tiếng Anh.
66
66
  ```
67
67
 
68
+ ### Cho GitHub Copilot
69
+ Tạo file `.github/copilot-instructions.md` và dán đoạn prompt tương tự như trên vào file này để Copilot học được các kỹ năng.
70
+
71
+ ---
72
+
73
+ ## 🎯 Cách kiểm tra cài đặt thành công
74
+
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õ chính xác câu sau:
76
+ > *"Hãy kích hoạt skill project-audit và cho tôi biết bạn sẽ làm những gì."*
77
+
78
+ ✅ **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
+ ❌ **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
+
68
81
  ---
69
82
 
70
83
  ## 🚀 Cách sử dụng (Usage)
package/docs/HUONG_DAN_SU_DUNG.md CHANGED
@@ -59,20 +59,30 @@ Always read the relevant `SKILL.md` from `./rules-skill/skills/` before providin
59
59
  Speak to me in Vietnamese, but write all code in English.
60
60
  ```
61
61
 
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:
62
+ ### Cho Cline / Roo Code / Kilo Code (VS Code Extensions)
63
+ Tạo file `.clinerules`, `.roorules` hoặc `KILO.md` ở gốc dự án và dán nội dung:
64
64
  ```md
65
- # System Instructions
66
65
  Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
67
-
68
- Vui lòng tìm đọc danh sách kỹ năng tại file `./rules-skill/skills.json`.
69
- Trước khi thực hiện bất kỳ yêu cầu nào, hãy gọi file `SKILL.md` tương ứng trong thư mục `./rules-skill/skills/` để biết quy trình làm việc chuẩn.
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.
66
+ Vui lòng tìm đọc danh sách kỹ năng tại file `./rules-skill/skills.json`. Trước khi thực hiện bất kỳ yêu cầu nào, hãy gọi file `SKILL.md` tương ứng trong thư mục `./rules-skill/skills/`.
67
+ Luôn giao tiếp bằng tiếng Việt nhưng viết code bằng tiếng Anh.
71
68
  ```
72
69
 
70
+ ### Cho GitHub Copilot
71
+ Tạo file `.github/copilot-instructions.md` và dán đoạn prompt tương tự như trên vào file này để Copilot học được các kỹ năng.
72
+
73
+ ---
74
+
75
+ ## 4. Cách kiểm tra cài đặt thành công
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õ chính xác câu sau:
78
+ > *"Hãy kích hoạt skill project-audit và cho tôi biết bạn sẽ làm những gì."*
79
+
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`.
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.
82
+
73
83
  ---
74
84
 
75
- ## 4. Cách tương tác với AI
85
+ ## 5. Cách tương tác với AI
76
86
 
77
87
  Giờ đây bạn chỉ cần chat với AI như giao việc cho một kỹ sư thật sự. Không cần viết prompt dài dòng!
78
88
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ai-developer-skill-os",
3
- "version": "1.0.2",
3
+ "version": "1.0.4",
4
4
  "description": "Multi-agent skill package cho AI coding agents (Claude, Cursor, Windsurf, Antigravity) với 23 skills chuyên nghiệp.",
5
5
  "main": "bin/install.js",
6
6
  "bin": {
package/skills/engineering/agent-orchestrator/SKILL.md CHANGED
@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
11
11
  # Agent Orchestrator
12
12
 
13
13
  > **Language rule:**
14
- > Use **English** for: skill names, phase labels, technical decisions, file paths.
15
- > Use **the user's language** for: explanations, questions, plan summaries, and feedback.
14
+ > Use English for: code, identifiers, file names, architecture terms, technical decisions.
15
+ > Use the user's language for: explanations, questions, summaries, and feedback.
16
+ > The user may write in any language — detect and match it automatically.
16
17
 
17
18
  > ⚠️ **CRITICAL CONSTRAINT: This skill MUST NOT write any code.**
18
19
  > Its only job is to analyze, plan, and delegate.
package/skills/engineering/api-integration/SKILL.md CHANGED
@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
11
11
  # API Integration Engineer
12
12
 
13
13
  > **Language rule:**
14
- > Use **English** for: type names, function names, file paths, API terms, HTTP concepts.
15
- > Use **the user's language** for: explanations, questions, and summaries.
14
+ > Use English for: code, identifiers, file names, architecture terms, technical decisions.
15
+ > Use the user's language for: explanations, questions, summaries, and feedback.
16
+ > The user may write in any language — detect and match it automatically.
16
17
 
17
18
  ---
18
19
 
package/skills/engineering/git-engineer/SKILL.md CHANGED
@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
11
11
  # Git Engineer
12
12
 
13
13
  > **Language rule:**
14
- > Use **English** for: commit messages, PR titles, changelog entries, branch names, git commands.
15
- > Use **the user's language** for: explanations, questions, and summaries.
14
+ > Use English for: code, identifiers, file names, architecture terms, technical decisions.
15
+ > Use the user's language for: explanations, questions, summaries, and feedback.
16
+ > The user may write in any language — detect and match it automatically.
16
17
 
17
18
  > 📌 **Standard followed:** [Conventional Commits v1.0.0](https://www.conventionalcommits.org/)
18
19
 
package/skills/engineering/migration/SKILL.md CHANGED
@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
11
11
  # Migration & Dependency Upgrade
12
12
 
13
13
  > **Language rule:**
14
- > Use **English** for: package names, version numbers, commands, config keys, technical terms.
15
- > Use **the user's language** for: explanations, risk summaries, and step-by-step instructions.
14
+ > Use English for: code, identifiers, file names, architecture terms, technical decisions.
15
+ > Use the user's language for: explanations, questions, summaries, and feedback.
16
+ > The user may write in any language — detect and match it automatically.
16
17
 
17
18
  > ⚠️ **Always create a rollback plan before starting any migration.**
18
19
  > Never apply breaking upgrades to production without a verified fallback.
package/skills/engineering/project-audit/SKILL.md CHANGED
@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
11
11
  # Project Audit
12
12
 
13
13
  > **Language rule:**
14
- > Use **English** for: code references, file paths, severity labels, technical terms.
15
- > Use **the user's language** for: explanations, questions, and report summaries.
14
+ > Use English for: code, identifiers, file names, architecture terms, technical decisions.
15
+ > Use the user's language for: explanations, questions, summaries, and feedback.
16
+ > The user may write in any language — detect and match it automatically.
16
17
 
17
18
  > ⚠️ **CRITICAL: Do NOT modify any code during audit.**
18
19
  > The audit produces a report. Changes happen only after the user reviews and approves.
package/skills/engineering/refactor/SKILL.md CHANGED
@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
11
11
  # Refactor — Safe Restructuring
12
12
 
13
13
  > **Language rule:**
14
- > Use **English** for: code, identifiers, pattern names, file paths, technical terms.
15
- > Use **the user's language** for: explanations, questions, and summaries.
14
+ > Use English for: code, identifiers, file names, architecture terms, technical decisions.
15
+ > Use the user's language for: explanations, questions, summaries, and feedback.
16
+ > The user may write in any language — detect and match it automatically.
16
17
 
17
18
  > ⚠️ **Core constraint: Refactoring must NOT change observable behavior.**
18
19
  > If behavior changes are needed → that is a feature, not a refactor.