ai-developer-skill-os 9.0.0 → 9.1.1

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 (104) hide show
  1. package/.agents/AGENTS.md +7 -7
  2. package/.agents/registry/graph.json +33 -33
  3. package/.agents/registry/index.yaml +33 -33
  4. package/.agents/rules/global.md +1 -1
  5. package/.agents/skills/_template/SKILL.md +129 -1
  6. package/.agents/skills/_template/capability.yaml +1 -1
  7. package/.agents/skills/qk-access-policy/SKILL.md +134 -1
  8. package/.agents/skills/qk-access-policy/capability.yaml +1 -1
  9. package/.agents/skills/qk-access-policy/evals/scorecard.yaml +1 -1
  10. package/.agents/skills/qk-agent-observability/SKILL.md +134 -1
  11. package/.agents/skills/qk-agent-observability/capability.yaml +1 -1
  12. package/.agents/skills/qk-agent-observability/evals/scorecard.yaml +1 -1
  13. package/.agents/skills/qk-ai-builder/SKILL.md +134 -1
  14. package/.agents/skills/qk-ai-builder/capability.yaml +1 -1
  15. package/.agents/skills/qk-ai-builder/evals/scorecard.yaml +1 -1
  16. package/.agents/skills/qk-api-lifecycle/SKILL.md +134 -1
  17. package/.agents/skills/qk-api-lifecycle/capability.yaml +1 -1
  18. package/.agents/skills/qk-api-lifecycle/evals/scorecard.yaml +1 -1
  19. package/.agents/skills/qk-bug-resolution/SKILL.md +134 -1
  20. package/.agents/skills/qk-bug-resolution/capability.yaml +1 -1
  21. package/.agents/skills/qk-bug-resolution/evals/scorecard.yaml +1 -1
  22. package/.agents/skills/qk-code-review/SKILL.md +134 -1
  23. package/.agents/skills/qk-code-review/capability.yaml +1 -1
  24. package/.agents/skills/qk-code-review/evals/scorecard.yaml +1 -1
  25. package/.agents/skills/qk-context-loader/SKILL.md +134 -1
  26. package/.agents/skills/qk-context-loader/capability.yaml +1 -1
  27. package/.agents/skills/qk-context-loader/evals/scorecard.yaml +1 -1
  28. package/.agents/skills/qk-data-lifecycle/SKILL.md +134 -1
  29. package/.agents/skills/qk-data-lifecycle/capability.yaml +1 -1
  30. package/.agents/skills/qk-data-lifecycle/evals/scorecard.yaml +1 -1
  31. package/.agents/skills/qk-db-optimizer/SKILL.md +134 -1
  32. package/.agents/skills/qk-db-optimizer/capability.yaml +1 -1
  33. package/.agents/skills/qk-db-optimizer/evals/scorecard.yaml +1 -1
  34. package/.agents/skills/qk-design-system-engineering/SKILL.md +134 -1
  35. package/.agents/skills/qk-design-system-engineering/capability.yaml +1 -1
  36. package/.agents/skills/qk-design-system-engineering/evals/scorecard.yaml +1 -1
  37. package/.agents/skills/qk-devops-platform/SKILL.md +134 -1
  38. package/.agents/skills/qk-devops-platform/capability.yaml +1 -1
  39. package/.agents/skills/qk-devops-platform/evals/scorecard.yaml +1 -1
  40. package/.agents/skills/qk-docs/SKILL.md +134 -1
  41. package/.agents/skills/qk-docs/capability.yaml +1 -1
  42. package/.agents/skills/qk-docs/evals/scorecard.yaml +1 -1
  43. package/.agents/skills/qk-engineering-standard/SKILL.md +134 -1
  44. package/.agents/skills/qk-engineering-standard/capability.yaml +1 -1
  45. package/.agents/skills/qk-engineering-standard/evals/scorecard.yaml +1 -1
  46. package/.agents/skills/qk-fe-api-integration/SKILL.md +134 -1
  47. package/.agents/skills/qk-fe-api-integration/capability.yaml +1 -1
  48. package/.agents/skills/qk-fe-api-integration/evals/scorecard.yaml +1 -1
  49. package/.agents/skills/qk-feature-delivery/SKILL.md +134 -1
  50. package/.agents/skills/qk-feature-delivery/capability.yaml +1 -1
  51. package/.agents/skills/qk-feature-delivery/evals/scorecard.yaml +1 -1
  52. package/.agents/skills/qk-frontend-architecture/SKILL.md +134 -1
  53. package/.agents/skills/qk-frontend-architecture/capability.yaml +1 -1
  54. package/.agents/skills/qk-frontend-architecture/evals/scorecard.yaml +1 -1
  55. package/.agents/skills/qk-help/SKILL.md +1 -1
  56. package/.agents/skills/qk-help/capability.yaml +1 -1
  57. package/.agents/skills/qk-help/evals/scorecard.yaml +1 -1
  58. package/.agents/skills/qk-orchestrator/SKILL.md +134 -1
  59. package/.agents/skills/qk-orchestrator/capability.yaml +1 -1
  60. package/.agents/skills/qk-orchestrator/evals/scorecard.yaml +1 -1
  61. package/.agents/skills/qk-product-specification/SKILL.md +134 -1
  62. package/.agents/skills/qk-product-specification/capability.yaml +1 -1
  63. package/.agents/skills/qk-product-specification/evals/scorecard.yaml +1 -1
  64. package/.agents/skills/qk-production-release/SKILL.md +134 -1
  65. package/.agents/skills/qk-production-release/capability.yaml +1 -1
  66. package/.agents/skills/qk-production-release/evals/scorecard.yaml +1 -1
  67. package/.agents/skills/qk-project-bootstrap/SKILL.md +393 -366
  68. package/.agents/skills/qk-project-bootstrap/capability.yaml +1 -1
  69. package/.agents/skills/qk-project-bootstrap/evals/scorecard.yaml +1 -1
  70. package/.agents/skills/qk-project-health/SKILL.md +134 -1
  71. package/.agents/skills/qk-project-health/capability.yaml +1 -1
  72. package/.agents/skills/qk-project-health/evals/scorecard.yaml +1 -1
  73. package/.agents/skills/qk-project-memory/SKILL.md +14 -18
  74. package/.agents/skills/qk-project-memory/capability.yaml +1 -1
  75. package/.agents/skills/qk-project-memory/evals/scorecard.yaml +1 -1
  76. package/.agents/skills/qk-refactor/SKILL.md +134 -1
  77. package/.agents/skills/qk-refactor/capability.yaml +1 -1
  78. package/.agents/skills/qk-refactor/evals/scorecard.yaml +1 -1
  79. package/.agents/skills/qk-security-audit/SKILL.md +134 -1
  80. package/.agents/skills/qk-security-audit/capability.yaml +1 -1
  81. package/.agents/skills/qk-security-audit/evals/scorecard.yaml +1 -1
  82. package/.agents/skills/qk-system-evolution/SKILL.md +134 -1
  83. package/.agents/skills/qk-system-evolution/capability.yaml +1 -1
  84. package/.agents/skills/qk-system-evolution/evals/scorecard.yaml +1 -1
  85. package/.agents/skills/qk-test-engineering/SKILL.md +134 -1
  86. package/.agents/skills/qk-test-engineering/capability.yaml +1 -1
  87. package/.agents/skills/qk-test-engineering/evals/scorecard.yaml +1 -1
  88. package/.agents/skills/qk-ui-audit/SKILL.md +134 -1
  89. package/.agents/skills/qk-ui-audit/capability.yaml +1 -1
  90. package/.agents/skills/qk-ui-audit/evals/scorecard.yaml +1 -1
  91. package/.agents/skills/qk-ui-builder/capability.yaml +1 -1
  92. package/.agents/skills/qk-ui-builder/evals/scorecard.yaml +1 -1
  93. package/.agents/skills/qk-ui-system-builder/SKILL.md +134 -1
  94. package/.agents/skills/qk-ui-system-builder/capability.yaml +1 -1
  95. package/.agents/skills/qk-ui-system-builder/evals/scorecard.yaml +1 -1
  96. package/.agents/skills/qk-validation-gate/SKILL.md +134 -1
  97. package/.agents/skills/qk-validation-gate/capability.yaml +1 -1
  98. package/.agents/skills/qk-validation-gate/evals/scorecard.yaml +1 -1
  99. package/.agents/skills/qk-web-quality-gate/SKILL.md +134 -1
  100. package/.agents/skills/qk-web-quality-gate/capability.yaml +1 -1
  101. package/.agents/skills/qk-web-quality-gate/evals/scorecard.yaml +1 -1
  102. package/README.md +7 -7
  103. package/package.json +2 -2
  104. package/tooling/sync-versions.js +11 -7
@@ -1,7 +1,7 @@
1
1
  # Auto-generated from SKILL.md frontmatter
2
2
  schema_version: 1
3
3
  id: "qk-context-loader"
4
- version: "9.0.0"
4
+ version: "9.1.0"
5
5
  description: "Tải context và vẽ dependency graph chính xác trước khi code — ngăn hallucination kiến trúc."
6
6
  tools:
7
7
  - "filesystem"
@@ -1,6 +1,6 @@
1
1
  name: qk-context-loader-eval
2
2
  description: Đánh giá khả năng phân tích kiến trúc và tải context
3
- version: 9.0.0
3
+ version: 9.1.0
4
4
  threshold: 85 # Tính chính xác của context là cốt lõi để tránh hallucination
5
5
 
6
6
  metrics:
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  # ── Identity ───────────────────────────────────────────────
3
3
  name: qk-data-lifecycle
4
- version: 9.0.0
4
+ version: 9.1.0
5
5
  status: stable
6
6
  description: "Quản lý Schema, Migrations an toàn — schema freeze → backward-compat migration → cleanup."
7
7
  platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
@@ -88,6 +88,86 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
88
88
 
89
89
  ## Memory Workflow
90
90
 
91
+ ### 0. Self-Init Protocol (Khởi Tạo Bộ Nhớ Local & Gitignore)
92
+ - Trước khi tra cứu hoặc lưu trữ tri thức, BẮT BUỘC kiểm tra sự tồn tại của thư mục `.ai-local/` tại gốc dự án:
93
+ - **Tự động tạo mới:** Nếu `.ai-local/` chưa tồn tại, AI phải tự động tạo cấu trúc thư mục `.ai-local/knowledge/` (và file `index.yaml` nếu cần thiết) cùng `.ai-local/candidates/`. Tuyệt đối không ngưng chạy hay hỏi ý kiến người dùng về thao tác khởi tạo tiêu chuẩn này.
94
+ - **Bảo mật Gitignore:** BẮT BUỘC kiểm tra file `.gitignore` của dự án, nếu chưa có dòng `.ai-local/` thì phải tự động thêm vào để tuyệt đối bảo mật tri thức cá nhân và tránh lộ lọt lên Git.
95
+
96
+ ---
97
+
98
+ ### Pre-flight Retrieve (Trước khi thực thi)
99
+ - Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
100
+ bắt buộc tra cứu:
101
+ - `.ai-local/knowledge/index.yaml` (Private Local Knowledge)
102
+
103
+ - Ưu tiên sử dụng các Knowledge đang có trạng thái `Active` thuộc:
104
+ - Architecture
105
+ - Hard Bug
106
+ - Convention
107
+ - Pattern
108
+ - Tech Debt Pattern
109
+ - 👉 *Domain Focus:* Convention / Architecture (vd: chiến lược migration backward-compatible, quy định FK).
110
+
111
+ - Memory chỉ đóng vai trò **Navigator (bản đồ chỉ đường)**.
112
+ Không được xem Memory là Source of Truth.
113
+ Luôn xác minh lại bằng source code, configuration và trạng thái hiện tại của dự án trước khi áp dụng.
114
+
115
+ ---
116
+
117
+ ### Learning Flow (AI tự học có kiểm soát)
118
+ - Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
119
+ - Hard Bug có khả năng tái diễn.
120
+ - Pattern làm việc lặp lại trong dự án.
121
+ - Convention hoặc quy tắc kiến trúc mới.
122
+ - Quyết định Architecture quan trọng.
123
+ - Tech Debt Pattern hoặc Code Smell có tính hệ thống.
124
+ - 👉 *Domain Harvest:* Quyết định Architecture quan trọng (vd: chuẩn index CSDL, quy tắc phân trang mới).
125
+
126
+ - Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
127
+ - Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
128
+ - AI không được tự động Promote Candidate Memory thành Project Knowledge.
129
+
130
+ ---
131
+
132
+ ### Post-flight Harvest (Đề xuất → Phê duyệt)
133
+ Sau khi hoàn thành task:
134
+ - AI đánh giá các Candidate Memory đã tạo.
135
+ - Nếu phát hiện tri thức có giá trị tái sử dụng:
136
+ - Đề xuất người dùng xem xét.
137
+ - Gửi yêu cầu phê duyệt thông qua:
138
+ - `/learn`
139
+ - `qk-project-memory`
140
+ - Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
141
+
142
+ ```
143
+ .ai-local/candidates/ ──(Approve)──> .ai-local/knowledge/index.yaml
144
+ ```
145
+
146
+ - Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
147
+ - Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
148
+
149
+ ---
150
+
151
+ ### Ignore (Không đưa vào Memory)
152
+ Không lưu:
153
+ - Trace log của một session đơn lẻ.
154
+ - Temporary debugging data.
155
+ - Output của một lần chạy test/scan.
156
+ - Report health tạm thời của một đợt kiểm tra.
157
+ - Lỗi nhỏ chỉ xảy ra một lần.
158
+ - Thông tin không có khả năng tái sử dụng.
159
+ - 👉 *Domain Ignore:* Thao tác thêm trường đơn giản hoặc temporary database fix.
160
+
161
+ ---
162
+
163
+ ### Golden Rule
164
+ > **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
165
+ > **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
166
+
167
+ ---
168
+
169
+
170
+
91
171
  ### Pre-flight Retrieve (Trước khi thực thi)
92
172
  - Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
93
173
  bắt buộc tra cứu:
@@ -211,6 +291,59 @@ Không lưu:
211
291
  > **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
212
292
  > **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
213
293
 
294
+ ---
295
+ ---
296
+
297
+ ### Learning Flow (AI tự học có kiểm soát)
298
+ - Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
299
+ - Hard Bug có khả năng tái diễn.
300
+ - Pattern làm việc lặp lại trong dự án.
301
+ - Convention hoặc quy tắc kiến trúc mới.
302
+ - Quyết định Architecture quan trọng.
303
+ - Tech Debt Pattern hoặc Code Smell có tính hệ thống.
304
+ - 👉 *Domain Harvest:* Quyết định Architecture quan trọng (vd: chuẩn index CSDL, quy tắc phân trang mới).
305
+
306
+ - Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
307
+ - Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
308
+ - AI không được tự động Promote Candidate Memory thành Project Knowledge.
309
+
310
+ ---
311
+
312
+ ### Post-flight Harvest (Đề xuất → Phê duyệt)
313
+ Sau khi hoàn thành task:
314
+ - AI đánh giá các Candidate Memory đã tạo.
315
+ - Nếu phát hiện tri thức có giá trị tái sử dụng:
316
+ - Đề xuất người dùng xem xét.
317
+ - Gửi yêu cầu phê duyệt thông qua:
318
+ - `/learn`
319
+ - `qk-project-memory`
320
+ - Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
321
+
322
+ ```
323
+ .ai-local/candidates/ ──(Approve)──> .agents/knowledge/index.yaml
324
+ ```
325
+
326
+ - Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
327
+ - Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
328
+
329
+ ---
330
+
331
+ ### Ignore (Không đưa vào Memory)
332
+ Không lưu:
333
+ - Trace log của một session đơn lẻ.
334
+ - Temporary debugging data.
335
+ - Output của một lần chạy test/scan.
336
+ - Report health tạm thời của một đợt kiểm tra.
337
+ - Lỗi nhỏ chỉ xảy ra một lần.
338
+ - Thông tin không có khả năng tái sử dụng.
339
+ - 👉 *Domain Ignore:* Thao tác thêm trường đơn giản hoặc temporary database fix.
340
+
341
+ ---
342
+
343
+ ### Golden Rule
344
+ > **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
345
+ > **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
346
+
214
347
  ---
215
348
  ---
216
349
  ---
@@ -1,7 +1,7 @@
1
1
  # Auto-generated from SKILL.md frontmatter
2
2
  schema_version: 1
3
3
  id: "qk-data-lifecycle"
4
- version: "9.0.0"
4
+ version: "9.1.0"
5
5
  description: "Quản lý Schema, Migrations an toàn — schema freeze → backward-compat migration → cleanup."
6
6
  tools:
7
7
  - "filesystem"
@@ -1,6 +1,6 @@
1
1
  name: qk-data-lifecycle-eval
2
2
  description: Đánh giá chất lượng quản lý Schema và an toàn Migration
3
- version: 9.0.0
3
+ version: 9.1.0
4
4
  threshold: 90 # Tiêu chuẩn rất cao vì rủi ro mất mát dữ liệu (Data loss) là CRITICAL
5
5
 
6
6
  metrics:
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  # ── Identity ───────────────────────────────────────────────
3
3
  name: qk-db-optimizer
4
- version: 9.0.0
4
+ version: 9.1.0
5
5
  status: stable
6
6
  description: "Tối ưu Database dựa trên bằng chứng: EXPLAIN → phân tích → index/join — không đoán mò."
7
7
  platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
@@ -87,6 +87,86 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
87
87
 
88
88
  ## Memory Workflow
89
89
 
90
+ ### 0. Self-Init Protocol (Khởi Tạo Bộ Nhớ Local & Gitignore)
91
+ - Trước khi tra cứu hoặc lưu trữ tri thức, BẮT BUỘC kiểm tra sự tồn tại của thư mục `.ai-local/` tại gốc dự án:
92
+ - **Tự động tạo mới:** Nếu `.ai-local/` chưa tồn tại, AI phải tự động tạo cấu trúc thư mục `.ai-local/knowledge/` (và file `index.yaml` nếu cần thiết) cùng `.ai-local/candidates/`. Tuyệt đối không ngưng chạy hay hỏi ý kiến người dùng về thao tác khởi tạo tiêu chuẩn này.
93
+ - **Bảo mật Gitignore:** BẮT BUỘC kiểm tra file `.gitignore` của dự án, nếu chưa có dòng `.ai-local/` thì phải tự động thêm vào để tuyệt đối bảo mật tri thức cá nhân và tránh lộ lọt lên Git.
94
+
95
+ ---
96
+
97
+ ### Pre-flight Retrieve (Trước khi thực thi)
98
+ - Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
99
+ bắt buộc tra cứu:
100
+ - `.ai-local/knowledge/index.yaml` (Private Local Knowledge)
101
+
102
+ - Ưu tiên sử dụng các Knowledge đang có trạng thái `Active` thuộc:
103
+ - Architecture
104
+ - Hard Bug
105
+ - Convention
106
+ - Pattern
107
+ - Tech Debt Pattern
108
+ - 👉 *Domain Focus:* Pattern / Hard Bug (vd: lỗi slow query từng gặp, kế hoạch index đã duyệt).
109
+
110
+ - Memory chỉ đóng vai trò **Navigator (bản đồ chỉ đường)**.
111
+ Không được xem Memory là Source of Truth.
112
+ Luôn xác minh lại bằng source code, configuration và trạng thái hiện tại của dự án trước khi áp dụng.
113
+
114
+ ---
115
+
116
+ ### Learning Flow (AI tự học có kiểm soát)
117
+ - Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
118
+ - Hard Bug có khả năng tái diễn.
119
+ - Pattern làm việc lặp lại trong dự án.
120
+ - Convention hoặc quy tắc kiến trúc mới.
121
+ - Quyết định Architecture quan trọng.
122
+ - Tech Debt Pattern hoặc Code Smell có tính hệ thống.
123
+ - 👉 *Domain Harvest:* Quyết định Architecture hoặc Pattern tối ưu (vd: chuẩn composite index, partition strategy).
124
+
125
+ - Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
126
+ - Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
127
+ - AI không được tự động Promote Candidate Memory thành Project Knowledge.
128
+
129
+ ---
130
+
131
+ ### Post-flight Harvest (Đề xuất → Phê duyệt)
132
+ Sau khi hoàn thành task:
133
+ - AI đánh giá các Candidate Memory đã tạo.
134
+ - Nếu phát hiện tri thức có giá trị tái sử dụng:
135
+ - Đề xuất người dùng xem xét.
136
+ - Gửi yêu cầu phê duyệt thông qua:
137
+ - `/learn`
138
+ - `qk-project-memory`
139
+ - Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
140
+
141
+ ```
142
+ .ai-local/candidates/ ──(Approve)──> .ai-local/knowledge/index.yaml
143
+ ```
144
+
145
+ - Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
146
+ - Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
147
+
148
+ ---
149
+
150
+ ### Ignore (Không đưa vào Memory)
151
+ Không lưu:
152
+ - Trace log của một session đơn lẻ.
153
+ - Temporary debugging data.
154
+ - Output của một lần chạy test/scan.
155
+ - Report health tạm thời của một đợt kiểm tra.
156
+ - Lỗi nhỏ chỉ xảy ra một lần.
157
+ - Thông tin không có khả năng tái sử dụng.
158
+ - 👉 *Domain Ignore:* Dữ liệu kết quả EXPLAIN tạm thời của 1 query.
159
+
160
+ ---
161
+
162
+ ### Golden Rule
163
+ > **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
164
+ > **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
165
+
166
+ ---
167
+
168
+
169
+
90
170
  ### Pre-flight Retrieve (Trước khi thực thi)
91
171
  - Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
92
172
  bắt buộc tra cứu:
@@ -210,6 +290,59 @@ Không lưu:
210
290
  > **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
211
291
  > **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
212
292
 
293
+ ---
294
+ ---
295
+
296
+ ### Learning Flow (AI tự học có kiểm soát)
297
+ - Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
298
+ - Hard Bug có khả năng tái diễn.
299
+ - Pattern làm việc lặp lại trong dự án.
300
+ - Convention hoặc quy tắc kiến trúc mới.
301
+ - Quyết định Architecture quan trọng.
302
+ - Tech Debt Pattern hoặc Code Smell có tính hệ thống.
303
+ - 👉 *Domain Harvest:* Quyết định Architecture hoặc Pattern tối ưu (vd: chuẩn composite index, partition strategy).
304
+
305
+ - Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
306
+ - Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
307
+ - AI không được tự động Promote Candidate Memory thành Project Knowledge.
308
+
309
+ ---
310
+
311
+ ### Post-flight Harvest (Đề xuất → Phê duyệt)
312
+ Sau khi hoàn thành task:
313
+ - AI đánh giá các Candidate Memory đã tạo.
314
+ - Nếu phát hiện tri thức có giá trị tái sử dụng:
315
+ - Đề xuất người dùng xem xét.
316
+ - Gửi yêu cầu phê duyệt thông qua:
317
+ - `/learn`
318
+ - `qk-project-memory`
319
+ - Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
320
+
321
+ ```
322
+ .ai-local/candidates/ ──(Approve)──> .agents/knowledge/index.yaml
323
+ ```
324
+
325
+ - Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
326
+ - Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
327
+
328
+ ---
329
+
330
+ ### Ignore (Không đưa vào Memory)
331
+ Không lưu:
332
+ - Trace log của một session đơn lẻ.
333
+ - Temporary debugging data.
334
+ - Output của một lần chạy test/scan.
335
+ - Report health tạm thời của một đợt kiểm tra.
336
+ - Lỗi nhỏ chỉ xảy ra một lần.
337
+ - Thông tin không có khả năng tái sử dụng.
338
+ - 👉 *Domain Ignore:* Dữ liệu kết quả EXPLAIN tạm thời của 1 query.
339
+
340
+ ---
341
+
342
+ ### Golden Rule
343
+ > **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
344
+ > **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
345
+
213
346
  ---
214
347
  ---
215
348
  ---
@@ -1,7 +1,7 @@
1
1
  # Auto-generated from SKILL.md frontmatter
2
2
  schema_version: 1
3
3
  id: "qk-db-optimizer"
4
- version: "9.0.0"
4
+ version: "9.1.0"
5
5
  description: "Tối ưu Database dựa trên bằng chứng: EXPLAIN → phân tích → index/join — không đoán mò."
6
6
  tools:
7
7
  - "filesystem"
@@ -1,6 +1,6 @@
1
1
  name: qk-db-optimizer-eval
2
2
  description: Đánh giá chất lượng tối ưu hóa Database
3
- version: 9.0.0
3
+ version: 9.1.0
4
4
  threshold: 85 # Yêu cầu dựa trên bằng chứng, không đoán mò
5
5
 
6
6
  metrics:
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  # ── Identity ───────────────────────────────────────────────
3
3
  name: qk-design-system-engineering
4
- version: 9.0.0
4
+ version: 9.1.0
5
5
  status: experimental
6
6
  description: "Quản trị hệ thống thiết kế (Định nghĩa quy tắc hệ thống, tokens, các biến thể component)."
7
7
  platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
@@ -105,6 +105,86 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
105
105
 
106
106
  ## Memory Workflow
107
107
 
108
+ ### 0. Self-Init Protocol (Khởi Tạo Bộ Nhớ Local & Gitignore)
109
+ - Trước khi tra cứu hoặc lưu trữ tri thức, BẮT BUỘC kiểm tra sự tồn tại của thư mục `.ai-local/` tại gốc dự án:
110
+ - **Tự động tạo mới:** Nếu `.ai-local/` chưa tồn tại, AI phải tự động tạo cấu trúc thư mục `.ai-local/knowledge/` (và file `index.yaml` nếu cần thiết) cùng `.ai-local/candidates/`. Tuyệt đối không ngưng chạy hay hỏi ý kiến người dùng về thao tác khởi tạo tiêu chuẩn này.
111
+ - **Bảo mật Gitignore:** BẮT BUỘC kiểm tra file `.gitignore` của dự án, nếu chưa có dòng `.ai-local/` thì phải tự động thêm vào để tuyệt đối bảo mật tri thức cá nhân và tránh lộ lọt lên Git.
112
+
113
+ ---
114
+
115
+ ### Pre-flight Retrieve (Trước khi thực thi)
116
+ - Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
117
+ bắt buộc tra cứu:
118
+ - `.ai-local/knowledge/index.yaml` (Private Local Knowledge)
119
+
120
+ - Ưu tiên sử dụng các Knowledge đang có trạng thái `Active` thuộc:
121
+ - Architecture
122
+ - Hard Bug
123
+ - Convention
124
+ - Pattern
125
+ - Tech Debt Pattern
126
+ - 👉 *Domain Focus:* Architecture / Convention (vd: hợp đồng màu sắc DESIGN.md, spacing, typography token).
127
+
128
+ - Memory chỉ đóng vai trò **Navigator (bản đồ chỉ đường)**.
129
+ Không được xem Memory là Source of Truth.
130
+ Luôn xác minh lại bằng source code, configuration và trạng thái hiện tại của dự án trước khi áp dụng.
131
+
132
+ ---
133
+
134
+ ### Learning Flow (AI tự học có kiểm soát)
135
+ - Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
136
+ - Hard Bug có khả năng tái diễn.
137
+ - Pattern làm việc lặp lại trong dự án.
138
+ - Convention hoặc quy tắc kiến trúc mới.
139
+ - Quyết định Architecture quan trọng.
140
+ - Tech Debt Pattern hoặc Code Smell có tính hệ thống.
141
+ - 👉 *Domain Harvest:* Pattern hoặc Convention mới (vd: định danh CSS variables mới cho toàn bộ hệ thống).
142
+
143
+ - Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
144
+ - Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
145
+ - AI không được tự động Promote Candidate Memory thành Project Knowledge.
146
+
147
+ ---
148
+
149
+ ### Post-flight Harvest (Đề xuất → Phê duyệt)
150
+ Sau khi hoàn thành task:
151
+ - AI đánh giá các Candidate Memory đã tạo.
152
+ - Nếu phát hiện tri thức có giá trị tái sử dụng:
153
+ - Đề xuất người dùng xem xét.
154
+ - Gửi yêu cầu phê duyệt thông qua:
155
+ - `/learn`
156
+ - `qk-project-memory`
157
+ - Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
158
+
159
+ ```
160
+ .ai-local/candidates/ ──(Approve)──> .ai-local/knowledge/index.yaml
161
+ ```
162
+
163
+ - Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
164
+ - Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
165
+
166
+ ---
167
+
168
+ ### Ignore (Không đưa vào Memory)
169
+ Không lưu:
170
+ - Trace log của một session đơn lẻ.
171
+ - Temporary debugging data.
172
+ - Output của một lần chạy test/scan.
173
+ - Report health tạm thời của một đợt kiểm tra.
174
+ - Lỗi nhỏ chỉ xảy ra một lần.
175
+ - Thông tin không có khả năng tái sử dụng.
176
+ - 👉 *Domain Ignore:* Sửa đổi CSS cục bộ cho 1 component đơn lẻ.
177
+
178
+ ---
179
+
180
+ ### Golden Rule
181
+ > **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
182
+ > **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
183
+
184
+ ---
185
+
186
+
187
+
108
188
  ### Pre-flight Retrieve (Trước khi thực thi)
109
189
  - Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
110
190
  bắt buộc tra cứu:
@@ -228,6 +308,59 @@ Không lưu:
228
308
  > **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
229
309
  > **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
230
310
 
311
+ ---
312
+ ---
313
+
314
+ ### Learning Flow (AI tự học có kiểm soát)
315
+ - Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
316
+ - Hard Bug có khả năng tái diễn.
317
+ - Pattern làm việc lặp lại trong dự án.
318
+ - Convention hoặc quy tắc kiến trúc mới.
319
+ - Quyết định Architecture quan trọng.
320
+ - Tech Debt Pattern hoặc Code Smell có tính hệ thống.
321
+ - 👉 *Domain Harvest:* Pattern hoặc Convention mới (vd: định danh CSS variables mới cho toàn bộ hệ thống).
322
+
323
+ - Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
324
+ - Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
325
+ - AI không được tự động Promote Candidate Memory thành Project Knowledge.
326
+
327
+ ---
328
+
329
+ ### Post-flight Harvest (Đề xuất → Phê duyệt)
330
+ Sau khi hoàn thành task:
331
+ - AI đánh giá các Candidate Memory đã tạo.
332
+ - Nếu phát hiện tri thức có giá trị tái sử dụng:
333
+ - Đề xuất người dùng xem xét.
334
+ - Gửi yêu cầu phê duyệt thông qua:
335
+ - `/learn`
336
+ - `qk-project-memory`
337
+ - Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
338
+
339
+ ```
340
+ .ai-local/candidates/ ──(Approve)──> .agents/knowledge/index.yaml
341
+ ```
342
+
343
+ - Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
344
+ - Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
345
+
346
+ ---
347
+
348
+ ### Ignore (Không đưa vào Memory)
349
+ Không lưu:
350
+ - Trace log của một session đơn lẻ.
351
+ - Temporary debugging data.
352
+ - Output của một lần chạy test/scan.
353
+ - Report health tạm thời của một đợt kiểm tra.
354
+ - Lỗi nhỏ chỉ xảy ra một lần.
355
+ - Thông tin không có khả năng tái sử dụng.
356
+ - 👉 *Domain Ignore:* Sửa đổi CSS cục bộ cho 1 component đơn lẻ.
357
+
358
+ ---
359
+
360
+ ### Golden Rule
361
+ > **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
362
+ > **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
363
+
231
364
  ---
232
365
  ---
233
366
  ---
@@ -1,7 +1,7 @@
1
1
  # Auto-generated from SKILL.md frontmatter
2
2
  schema_version: 1
3
3
  id: "qk-design-system-engineering"
4
- version: "9.0.0"
4
+ version: "9.1.0"
5
5
  description: "Quản trị hệ thống thiết kế (Định nghĩa quy tắc hệ thống, tokens, các biến thể component)."
6
6
  tools:
7
7
  - "filesystem"
@@ -1,6 +1,6 @@
1
1
  name: qk-design-system-engineering-eval
2
2
  description: Đánh giá chất lượng quản trị hệ thống thiết kế (Design System)
3
- version: 9.0.0
3
+ version: 9.1.0
4
4
  threshold: 85 # Đảm bảo sự nhất quán và ngăn chặn UI Slop từ gốc
5
5
 
6
6
  metrics: