ai-developer-skill-os 9.1.2 → 9.3.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.
Files changed (63) hide show
  1. package/.agents/AGENTS.md +139 -42
  2. package/.agents/DEV_PROFILE.md +95 -0
  3. package/.agents/registry/capability-graph.yml +171 -334
  4. package/.agents/registry/graph.json +37 -19
  5. package/.agents/registry/index.yaml +59 -13
  6. package/.agents/registry/skills-index.yml +204 -447
  7. package/.agents/rules/coding.md +23 -0
  8. package/.agents/rules/global.md +44 -30
  9. package/.agents/skills/_template/SKILL.md +2 -377
  10. package/.agents/skills/qk-access-policy/SKILL.md +98 -473
  11. package/.agents/skills/qk-agent-observability/SKILL.md +3 -439
  12. package/.agents/skills/qk-ai-builder/SKILL.md +132 -565
  13. package/.agents/skills/qk-api-consumer/SKILL.md +256 -0
  14. package/.agents/skills/qk-api-consumer/capability.yaml +21 -0
  15. package/.agents/skills/qk-api-consumer/evals/scorecard.yaml +29 -0
  16. package/.agents/skills/qk-api-lifecycle/SKILL.md +133 -456
  17. package/.agents/skills/qk-bug-resolution/SKILL.md +128 -561
  18. package/.agents/skills/qk-code-review/SKILL.md +142 -420
  19. package/.agents/skills/qk-context-loader/SKILL.md +99 -471
  20. package/.agents/skills/qk-data-engineer/SKILL.md +119 -340
  21. package/.agents/skills/qk-data-lifecycle/SKILL.md +89 -488
  22. package/.agents/skills/qk-db-optimizer/SKILL.md +102 -488
  23. package/.agents/skills/qk-design-system-engineering/SKILL.md +76 -461
  24. package/.agents/skills/qk-devops-platform/SKILL.md +77 -463
  25. package/.agents/skills/qk-docs/SKILL.md +88 -494
  26. package/.agents/skills/qk-engineering-standard/SKILL.md +4 -588
  27. package/.agents/skills/qk-fe-api-integration/SKILL.md +343 -343
  28. package/.agents/skills/qk-fe-api-integration/evals/scorecard.yaml +29 -29
  29. package/.agents/skills/qk-feature-delivery/SKILL.md +137 -445
  30. package/.agents/skills/qk-feature-delivery/evals/scorecard.yaml +1 -1
  31. package/.agents/skills/qk-frontend-architecture/SKILL.md +5 -479
  32. package/.agents/skills/qk-help/evals/scorecard.yaml +13 -13
  33. package/.agents/skills/qk-orchestrator/SKILL.md +63 -502
  34. package/.agents/skills/qk-orchestrator/references/routing-table.md +10 -14
  35. package/.agents/skills/qk-product-specification/SKILL.md +70 -479
  36. package/.agents/skills/qk-production-release/SKILL.md +80 -537
  37. package/.agents/skills/qk-project-audit/SKILL.md +174 -0
  38. package/.agents/skills/qk-project-bootstrap/SKILL.md +243 -471
  39. package/.agents/skills/qk-project-health/SKILL.md +97 -496
  40. package/.agents/skills/qk-project-memory/SKILL.md +76 -21
  41. package/.agents/skills/qk-refactor/SKILL.md +167 -384
  42. package/.agents/skills/qk-security-audit/SKILL.md +141 -463
  43. package/.agents/skills/qk-security-audit/capability.yaml +1 -2
  44. package/.agents/skills/qk-system-evolution/SKILL.md +343 -343
  45. package/.agents/skills/qk-system-evolution/evals/scorecard.yaml +26 -26
  46. package/.agents/skills/qk-test-engineering/SKILL.md +119 -509
  47. package/.agents/skills/qk-ui-audit/SKILL.md +73 -537
  48. package/.agents/skills/qk-ui-builder/SKILL.md +521 -482
  49. package/.agents/skills/qk-ui-system-builder/SKILL.md +68 -514
  50. package/.agents/skills/qk-upgrade/SKILL.md +301 -0
  51. package/.agents/skills/qk-upgrade/capability.yaml +24 -0
  52. package/.agents/skills/qk-upgrade/evals/scorecard.yaml +26 -0
  53. package/.agents/skills/qk-validation-gate/SKILL.md +4 -603
  54. package/.agents/skills/qk-web-quality-gate/SKILL.md +85 -463
  55. package/.agents/workflows/bug-resolution.yml +6 -6
  56. package/.agents/workflows/context-discovery.yml +94 -0
  57. package/.agents/workflows/feature-delivery.yml +8 -4
  58. package/.agents/workflows/refactor.yml +6 -3
  59. package/.agents/workflows/shared/quality-gate.yml +94 -0
  60. package/.agents/workflows/skin-governance.yml +115 -0
  61. package/README.md +152 -67
  62. package/package.json +2 -2
  63. package/tooling/build-registry.js +30 -8
@@ -1,548 +1,305 @@
1
1
  # registry/skills-index.yml
2
2
  # GENERATED FILE - DO NOT EDIT MANUALLY.
3
- version: 8.1.1
4
- generated_at: '2026-07-29T07:30:07.984Z'
5
- total_skills: 31
3
+ # Regenerate: node tooling/generate-registry.js
4
+ version: 9.2.0
5
+ generated_at: '2026-09-11T12:00:00.000Z'
6
+ total_active_skills: 29
7
+ archived: 2 # qk-frontend-architecture, qk-agent-observability
8
+ relocated: 2 # qk-engineering-standard (→ rules/coding.md), qk-validation-gate (→ workflow quality gate)
6
9
  skills:
7
10
  - name: qk-access-policy
8
- version: 8.0.0
11
+ version: 9.2.0
9
12
  status: stable
10
- description: >-
11
- Quản lý RBAC, ABAC — định nghĩa role matrix trước, implement middleware
12
- sau.
13
+ description: Quản lý RBAC, ABAC — định nghĩa role matrix trước, implement middleware sau.
13
14
  complexity: high
14
15
  workflow: feature-delivery
15
- triggers:
16
- - cấu hình rbac
17
- - phân quyền
18
- - bảo mật api
19
- - auth middleware
20
- intent:
21
- - access-control
22
- - security-policy
16
+ triggers: [cấu hình rbac, phân quyền, bảo mật api, auth middleware, access control]
17
+ intent: [access-control, security-policy]
18
+
23
19
  - name: qk-agent-observability
24
- version: 8.1.3
25
- status: experimental
26
- description: >-
27
- Lớp theo dõi (Observability) cho phép giám sát quyết định, luân chuyển và
28
- các mô hình lỗi.
20
+ version: 9.2.1
21
+ status: archived
22
+ description: Monitor AI skin routing decisions, failure patterns, skill success rate.
29
23
  complexity: medium
30
- workflow: skill-evolution
31
- triggers:
32
- - agent observability
33
- - routing logs
34
- - skill failure
35
- intent:
36
- - observability
37
- - agent-metrics
38
- - decision-trace
24
+ workflow: skin-governance
25
+ triggers: [agent observability, routing logs, skin monitor, skill failure]
26
+ intent: [observability, agent-metrics, decision-trace]
27
+
39
28
  - name: qk-ai-builder
40
- version: 8.2.0
29
+ version: 9.2.0
41
30
  status: stable
42
- description: >-
43
- Thiết kế Governed AI Agent & RAG pipelines theo chuẩn V8.2 — Đóng gói bằng
44
- capability.yaml, data discipline 4-folder và Eval Pipeline.
31
+ description: Governed AI Agent & RAG pipeline design — capability.yaml, 4-folder data discipline, Eval Pipeline.
45
32
  complexity: high
46
33
  workflow: feature-delivery
47
- triggers:
48
- - build ai
49
- - viết prompt
50
- - thiết kế bot
51
- - ai logic
52
- - tạo skill
53
- intent:
54
- - ai-integration
55
- - agent-behavior
34
+ triggers: [build ai, viết prompt, thiết kế bot, ai logic, rag pipeline, llm, vector]
35
+ intent: [ai-integration, agent-behavior, prompt-engineering]
36
+
37
+ - name: qk-api-consumer
38
+ version: 9.2.0
39
+ status: stable
40
+ description: Consume API (REST/GraphQL/tRPC), quản lý State, bind vào UI — bất kể FE framework nào.
41
+ complexity: medium
42
+ workflow: feature-delivery
43
+ triggers: [tích hợp api, gọi api, fetch data, consume api, kết nối api, api consumer]
44
+ intent: [api-integration, state-management, data-binding]
45
+
56
46
  - name: qk-api-lifecycle
57
- version: 8.0.0
47
+ version: 9.2.0
58
48
  status: stable
59
- description: >-
60
- Thiết kế, triển khai API endpoints với Zero-Trust — contract trước, code
61
- sau.
49
+ description: Thiết kế, triển khai API endpoints với Zero-Trust — contract trước, code sau.
62
50
  complexity: medium
63
51
  workflow: feature-delivery
64
- triggers:
65
- - viết api
66
- - tạo endpoint
67
- - build api
68
- - thiết kế api
69
- intent:
70
- - api-design
71
- - backend-development
52
+ triggers: [viết api, tạo endpoint, build api, thiết kế api, rest, graphql, trpc]
53
+ intent: [api-design, backend-development]
54
+
72
55
  - name: qk-bug-resolution
73
- version: 8.0.0
56
+ version: 9.2.0
74
57
  status: stable
75
- description: >-
76
- Sửa lỗi (bugs) bằng chu trình khép kín: Quan sát → Giả thuyết → Bằng chứng
77
- → Sửa.
58
+ description: Sửa lỗi bằng chu trình khép kín — Observe → Hypothesis → Evidence → Fix.
78
59
  complexity: medium
79
60
  workflow: bug-resolution
80
- triggers:
81
- - fix bug
82
- - sửa lỗi
83
- - crash
84
- - error
85
- - not working
86
- intent:
87
- - bug-fixing
88
- - debugging
89
- - error-resolution
61
+ triggers: [fix bug, sửa lỗi, crash, error, not working, debug]
62
+ intent: [bug-fixing, debugging, error-resolution]
63
+
90
64
  - name: qk-code-review
91
- version: 8.0.0
65
+ version: 9.2.0
92
66
  status: stable
93
- description: >-
94
- Elite AI/Code Review System: Kiểm toán, Review code và cấu hình AI với tư
95
- duy Architect, áp dụng 4-Phase Review.
67
+ description: 4-Phase elite code review với Architect mindset — code, AI config, skin.
96
68
  complexity: high
97
69
  workflow: code-review
98
- triggers:
99
- - review code
100
- - code review
101
- - kiểm tra code
102
- - đánh giá code
103
- - review skin
104
- - review rule
105
- - review ai
106
- intent:
107
- - code-review
108
- - quality-assurance
109
- - architecture-review
110
- - ai-config-audit
70
+ triggers: [review code, code review, kiểm tra code, review skin, review ai]
71
+ intent: [code-review, quality-assurance, architecture-review]
72
+
111
73
  - name: qk-context-loader
112
- version: 8.0.0
74
+ version: 9.2.0
113
75
  status: stable
114
- description: >-
115
- Tải context và vẽ dependency graph chính xác trước khi code — ngăn
116
- hallucination kiến trúc.
76
+ description: Load project context, vẽ dependency graph — ngăn hallucination kiến trúc.
117
77
  complexity: low
118
- workflow: research
119
- triggers:
120
- - load context
121
- - understand project
122
- - analyze architecture
123
- - vẽ dependency graph
124
- - build context
125
- intent:
126
- - context-loading
127
- - project-understanding
128
- - repository-analysis
78
+ workflow: context-discovery
79
+ triggers: [load context, understand project, vẽ dependency graph, analyze architecture]
80
+ intent: [context-loading, project-understanding]
81
+
82
+ - name: qk-data-engineer
83
+ version: 9.2.0
84
+ status: stable
85
+ description: Universal Data Engineering — pipelines, idempotency, data quality, lineage (dbt/Spark/Airflow/Delta).
86
+ complexity: high
87
+ workflow: feature-delivery
88
+ triggers: [data pipeline, etl, elt, dbt, spark, airflow, medallion, data quality]
89
+ intent: [data-pipeline, data-modeling, data-quality]
90
+
129
91
  - name: qk-data-lifecycle
130
- version: 8.0.0
92
+ version: 9.2.0
131
93
  status: stable
132
- description: >-
133
- Quản lý Schema, Migrations an toàn — schema freeze → backward-compat
134
- migration → cleanup.
94
+ description: Schema management + safe migrations — freeze → backward-compat → cleanup.
135
95
  complexity: high
136
96
  workflow: feature-delivery
137
- triggers:
138
- - sửa schema
139
- - cập nhật database
140
- - tạo migration
141
- - đổi model
142
- intent:
143
- - schema-management
144
- - database-migration
97
+ triggers: [sửa schema, cập nhật database, tạo migration, đổi model, db schema]
98
+ intent: [schema-management, database-migration]
99
+
145
100
  - name: qk-db-optimizer
146
- version: 8.0.0
101
+ version: 9.2.0
147
102
  status: stable
148
- description: >-
149
- Tối ưu Database dựa trên bằng chứng: EXPLAIN → phân tích → index/join —
150
- không đoán mò.
103
+ description: Evidence-based DB optimization — EXPLAIN → analyze → index/join, không đoán mò.
151
104
  complexity: high
152
105
  workflow: refactor
153
- triggers:
154
- - tối ưu query
155
- - query chậm
156
- - optimize db
157
- - thêm index
158
- intent:
159
- - database-optimization
160
- - performance-tuning
106
+ triggers: [tối ưu query, query chậm, optimize db, thêm index, explain]
107
+ intent: [database-optimization, performance-tuning]
108
+
161
109
  - name: qk-design-system-engineering
162
- version: 8.1.0
110
+ version: 9.2.0
163
111
  status: experimental
164
- description: >-
165
- Quản trị hệ thống thiết kế (Định nghĩa quy tắc hệ thống, tokens, các biến
166
- thể component).
112
+ description: Quản trị design system — tokens, component variants, governance rules.
167
113
  complexity: medium
168
114
  workflow: feature-delivery
169
- triggers:
170
- - định nghĩa design system
171
- - cấu trúc token
172
- - quy chuẩn ui
173
- - variants
174
- intent:
175
- - design-system
176
- - tokens
177
- - component-library
178
- - accessibility
115
+ triggers: [định nghĩa design system, cấu trúc token, quy chuẩn ui, variants]
116
+ intent: [design-system, tokens, component-library]
117
+
179
118
  - name: qk-devops-platform
180
- version: 8.1.1
119
+ version: 9.2.0
181
120
  status: experimental
182
- description: >-
183
- Kỹ sư nền tảng: Chiến lược CI/CD, kiến trúc triển khai, quản lý môi trường
184
- và chiến lược rollback.
121
+ description: CI/CD strategy, deployment architecture, environment management, rollback strategy.
185
122
  complexity: high
186
123
  workflow: feature-delivery
187
- triggers:
188
- - cấu hình ci/cd
189
- - deployment strategy
190
- - quản lý môi trường
191
- - devops platform
192
- - dockerize
193
- intent:
194
- - devops-strategy
195
- - cicd-pipeline
196
- - deployment-architecture
197
- - environment-management
124
+ triggers: [cấu hình ci/cd, deployment strategy, dockerize, devops platform]
125
+ intent: [devops-strategy, cicd-pipeline, deployment-architecture]
126
+
198
127
  - name: qk-docs
199
- version: 8.0.0
128
+ version: 9.2.0
200
129
  status: stable
201
- description: >-
202
- Viết và duy trì tài liệu chính xác tuyệt đối — phải match code thực tế,
203
- cấm bịa đặt.
130
+ description: Viết/cập nhật tài liệu chính xác tuyệt đối — match code thực tế, không bịa đặt.
204
131
  complexity: low
205
132
  workflow: documentation
206
- triggers:
207
- - viết docs
208
- - viết tài liệu
209
- - document this
210
- - generate docs
211
- - cập nhật readme
212
- intent:
213
- - documentation
214
- - technical-writing
133
+ triggers: [viết docs, viết tài liệu, document this, generate docs, readme]
134
+ intent: [documentation, technical-writing]
135
+
215
136
  - name: qk-engineering-standard
216
- version: 8.0.0
217
- status: stable
218
- description: >-
219
- Ép buộc SOLID, DRY, Clean Code với ngưỡng số liệu cụ thể — không có rule
220
- mơ hồ.
137
+ version: 9.2.1
138
+ status: relocated
139
+ description: Enforce SOLID, DRY, Clean Code với ngưỡng metric cụ thể — không rule mơ hồ.
221
140
  complexity: medium
222
141
  workflow: code-review
223
- triggers:
224
- - review code
225
- - clean code
226
- - check standard
227
- - refactor clean
228
- - kiểm tra chuẩn
229
- intent:
230
- - code-quality
231
- - standards-enforcement
232
- - name: qk-fe-api-integration
233
- version: 8.0.0
234
- status: stable
235
- description: >-
236
- Consume API Backend, quản lý State, bind vào UI — tuân thủ kiến trúc Base
237
- dự án
238
- complexity: medium
239
- workflow: feature-delivery
240
- triggers:
241
- - tích hợp api
242
- - gọi api
243
- - fetch data
244
- - consume api
245
- intent:
246
- - api-integration
247
- - frontend-development
142
+ triggers: [clean code, check standard, kiểm tra chuẩn, solid, dry]
143
+ intent: [code-quality, standards-enforcement]
144
+
248
145
  - name: qk-feature-delivery
249
- version: 8.0.0
146
+ version: 9.2.0
250
147
  status: stable
251
- description: >-
252
- Phát triển tính năng mới end-to-end: Requirements → Context → Design →
253
- Implement → Self-audit.
148
+ description: End-to-end feature delivery — Requirements → Context → Design → Implement → Audit.
254
149
  complexity: high
255
150
  workflow: feature-delivery
256
- triggers:
257
- - add feature
258
- - build new
259
- - implement
260
- - phát triển tính năng
261
- - tạo mới
262
- intent:
263
- - feature-building
264
- - end-to-end-development
265
- - implementation
151
+ triggers: [add feature, build new, implement, phát triển tính năng, tạo mới]
152
+ intent: [feature-building, end-to-end-development]
153
+
266
154
  - name: qk-frontend-architecture
267
- version: 8.1.0
268
- status: experimental
269
- description: >-
270
- Công cụ quyết định kiến trúc Frontend (Chiến lược component, quản lý
271
- state, định tuyến).
155
+ version: 9.2.1
156
+ status: archived
157
+ description: Quyết định kiến trúc FE — component strategy, state management, routing.
272
158
  complexity: high
273
159
  workflow: feature-delivery
274
- triggers:
275
- - cấu trúc frontend
276
- - thiết kế component
277
- - quản lý state
278
- - kiến trúc react
279
- intent:
280
- - frontend-architecture
281
- - component-strategy
282
- - state-management
283
- - name: qk-help
284
- version: 8.0.0
285
- status: deprecated
286
- description: Hiển thị danh sách skills V8 và hướng dẫn dùng lệnh ./qk-[skill-name].
287
- complexity: low
288
- workflow: documentation
289
- triggers:
290
- - help
291
- - có những skill nào
292
- - danh sách skill
293
- - làm sao để dùng
294
- - qk-help
295
- intent:
296
- - skill-discovery
297
- - command-help
160
+ triggers: [cấu trúc frontend, thiết kế component, quản lý state, kiến trúc react]
161
+ intent: [frontend-architecture, component-strategy, state-management]
162
+
298
163
  - name: qk-orchestrator
299
- version: 8.0.0
164
+ version: 9.2.0
300
165
  status: stable
301
- description: >-
302
- Điều hướng yêu cầu của người dùng đến đúng skill với kỷ luật thép — kiểm
303
- tra preconditions và routing table.
166
+ description: Route yêu cầu đến đúng skill — kiểm tra preconditions, resolve ambiguity.
304
167
  complexity: low
305
- workflow: research
306
- triggers:
307
- - which skill
308
- - what should i use
309
- - route this
310
- - help me choose
311
- - what skill for
312
- - help
313
- - list skills
314
- - what can you do
315
- intent:
316
- - task-routing
317
- - skill-selection
318
- - precondition-checking
168
+ workflow: context-discovery
169
+ triggers: [help, list skills, có những skill nào, chọn skill nào, what can you do]
170
+ intent: [task-routing, skill-selection]
171
+
319
172
  - name: qk-product-specification
320
- version: 8.1.0
173
+ version: 9.2.0
321
174
  status: experimental
322
- description: >-
323
- Product thinking (Idea → Requirement → Acceptance criteria → Technical
324
- spec).
175
+ description: Idea → Requirement → Acceptance Criteria → Technical Spec.
325
176
  complexity: medium
326
177
  workflow: spec-driven-development
327
- triggers:
328
- - viết spec
329
- - phân tích yêu cầu
330
- - ý tưởng sản phẩm
331
- - acceptance criteria
332
- intent:
333
- - product-specification
334
- - requirement-analysis
335
- - acceptance-criteria
336
- - technical-spec
178
+ triggers: [viết spec, phân tích yêu cầu, acceptance criteria, prd]
179
+ intent: [product-thinking, specification]
180
+
337
181
  - name: qk-production-release
338
- version: 8.0.0
182
+ version: 9.2.0
339
183
  status: stable
340
- description: >-
341
- Chuẩn bị release production với 8-gate checklist bắt buộc — không pass
342
- gate = không deploy.
184
+ description: 8-gate mandatory checklist trước khi deploy production — không skip.
343
185
  complexity: high
344
186
  workflow: production-release
345
- triggers:
346
- - release production
347
- - deploy production
348
- - chuẩn bị release
349
- - kiểm tra release
350
- intent:
351
- - release-management
352
- - production-deployment
187
+ triggers: [deploy production, release checklist, go live, rollout]
188
+ intent: [release-management, deployment-gate]
189
+
190
+ - name: qk-project-audit
191
+ version: 9.2.0
192
+ status: stable
193
+ description: Gap Analysis, Feasibility, Risk Assessment — báo cáo đầy đủ trước khi code.
194
+ complexity: medium
195
+ workflow: feature-delivery
196
+ triggers: [phân tích dự án, project audit, gap analysis, feasibility, risk assessment]
197
+ intent: [project-analysis, gap-analysis, feasibility-study]
198
+
353
199
  - name: qk-project-bootstrap
354
- version: 8.2.0
200
+ version: 9.2.0
355
201
  status: stable
356
- description: >-
357
- Khởi tạo dự án mới theo chuẩn V8.2 Blueprint Plugin Generator
358
- (project.yaml, 4-folder AI RAG hoặc Coding) với cấu trúc kiên cường.
359
- complexity: high
202
+ description: Khởi tạo dự án mới với Blueprint Plugins — RAG/AI, Coding, Workflow.
203
+ complexity: medium
360
204
  workflow: feature-delivery
361
- triggers:
362
- - khởi tạo project
363
- - tạo dự án mới
364
- - bootstrap
365
- - setup project
366
- - init repo
367
- intent:
368
- - project-initialization
369
- - setup
205
+ triggers: [khởi tạo dự án, project setup, scaffold, bootstrap, new app]
206
+ intent: [project-initialization, scaffolding]
207
+
370
208
  - name: qk-project-health
371
- version: 8.0.0
209
+ version: 9.2.0
372
210
  status: stable
373
- description: >-
374
- Kiểm toán toàn diện Code Smells, Tech Debt, Architecture — health score
375
- 0–100 với actionable roadmap.
211
+ description: Audit toàn diện — Code Smells, Tech Debt, Architecture (0–100 score).
376
212
  complexity: high
377
213
  workflow: code-review
378
- triggers:
379
- - audit code
380
- - check health
381
- - tech debt
382
- - code smell
383
- - kiểm toán
384
- intent:
385
- - project-audit
386
- - codebase-health
214
+ triggers: [audit project, code smell, tech debt, health check, project score]
215
+ intent: [project-audit, technical-debt, architecture-review]
216
+
387
217
  - name: qk-project-memory
388
- version: 8.0.0
218
+ version: 9.2.0
389
219
  status: stable
390
- description: >-
391
- Lưu trữ và truy xuất ngữ cảnh dự án dài hạn — chỉ lưu fact đã xác minh,
392
- không lưu giả thuyết.
393
- complexity: medium
220
+ description: Lưu/tra cứu project knowledge tại .ai-local/ — Architecture, Convention, Pattern, Hard Bug.
221
+ complexity: low
394
222
  workflow: documentation
395
- triggers:
396
- - lưu context
397
- - nhớ lại
398
- - project memory
399
- - lưu vào bộ nhớ
400
- - tìm lại fact
401
- intent:
402
- - context-management
403
- - knowledge-retrieval
223
+ triggers: [lưu context, project memory, ghi nhớ, /learn]
224
+ intent: [knowledge-management, project-memory]
225
+
404
226
  - name: qk-refactor
405
- version: 8.0.0
227
+ version: 9.2.0
406
228
  status: stable
407
- description: >-
408
- 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
409
- logic hoạt động bên ngoài.
229
+ description: Tái cấu trúc code không đổi external behavior — extract, simplify, decouple.
410
230
  complexity: medium
411
231
  workflow: refactor
412
- triggers:
413
- - refactor
414
- - tái cấu trúc
415
- - clean up this code
416
- - simplify
417
- - reduce complexity
418
- - dẫn cấu trúc code
419
- intent:
420
- - refactoring
421
- - code-cleanup
422
- - complexity-reduction
232
+ triggers: [refactor, tái cấu trúc, clean code, tách file, extract]
233
+ intent: [refactoring, code-quality]
234
+
423
235
  - name: qk-security-audit
424
- version: 8.1.0
236
+ version: 9.2.0
425
237
  status: experimental
426
- description: >-
427
- Security audit (OWASP, dependency security, secret detection, permission
428
- model).
238
+ description: OWASP, dependency risk, secret detection, permission model audit.
429
239
  complexity: high
430
240
  workflow: security-audit
431
- triggers:
432
- - kiểm tra bảo mật
433
- - scan lỗ hổng
434
- - audit code
435
- - tìm secret leak
436
- intent:
437
- - security-audit
438
- - vulnerability-scan
439
- - secret-detection
440
- - permission-review
441
- - name: qk-system-evolution
442
- version: 8.0.0
443
- status: stable
444
- description: >-
445
- Nâng cấp thư viện/framework an toàn với rollback plan bắt buộc —
446
- incremental, không big-bang.
447
- complexity: high
448
- workflow: refactor
449
- triggers:
450
- - upgrade package
451
- - nâng cấp
452
- - update framework
453
- - migration framework
454
- - system evolution
455
- intent:
456
- - framework-upgrade
457
- - system-maintenance
241
+ triggers: [security audit, owasp, lỗ hổng bảo mật, dependency risk, secret]
242
+ intent: [security, vulnerability-detection]
243
+
458
244
  - name: qk-test-engineering
459
- version: 8.1.0
245
+ version: 9.2.0
460
246
  status: experimental
461
- description: >-
462
- Công cụ quyết định chiến lược kiểm thử (Unit, Integration, E2E, Coverage,
463
- Regression, Mock).
464
- complexity: high
247
+ description: Test strategy decisions — pyramid, coverage, regression, mock, E2E.
248
+ complexity: medium
465
249
  workflow: feature-delivery
466
- triggers:
467
- - chiến lược test
468
- - viết test
469
- - mock data
470
- - test coverage
471
- intent:
472
- - testing-strategy
473
- - unit-test-strategy
474
- - integration-test-strategy
475
- - e2e-test-strategy
476
- - mock-strategy
477
- - test-coverage-planning
250
+ triggers: [viết test, test strategy, unit test, coverage, e2e]
251
+ intent: [testing-strategy, quality-assurance]
252
+
478
253
  - name: qk-ui-audit
479
- version: 8.0.0
254
+ version: 9.2.0
480
255
  status: stable
481
- description: >-
482
- Kiểm toán giao diện (UI) với 57-check Anti-Slop checklist — fail nếu score
483
- < 76/85 base.
256
+ description: Audit UI với 57-check Anti-Slop checklist (fail nếu < 76/85).
484
257
  complexity: medium
485
258
  workflow: code-review
486
- triggers:
487
- - audit ui
488
- - check ui
489
- - kiểm tra giao diện
490
- - ui slop
491
- - review ui
492
- intent:
493
- - ui-audit
494
- - codebase-health
259
+ triggers: [review ui, audit giao diện, kiểm tra ui, anti-slop]
260
+ intent: [ui-audit, design-quality]
261
+
262
+ - name: qk-ui-builder
263
+ version: 9.2.0
264
+ status: stable
265
+ description: Build/edit/audit/redesign UI từ Figma/ảnh/design reference — token-strict.
266
+ complexity: high
267
+ workflow: feature-delivery
268
+ triggers: [build ui, làm giao diện, css, layout, component, figma]
269
+ intent: [ui-development, frontend-design]
270
+
495
271
  - name: qk-ui-system-builder
496
- version: 8.0.0
272
+ version: 9.2.0
497
273
  status: stable
498
- description: >-
499
- Xây dựng Design System và token library từ DESIGN.md — không tự đặt ra
500
- token ngoài contract.
501
- complexity: medium
274
+ description: Build Design System và token library từ DESIGN.md.
275
+ complexity: high
502
276
  workflow: feature-delivery
503
- triggers:
504
- - tạo design system
505
- - build token
506
- - ui system
507
- - setup css
508
- intent:
509
- - ui-system-design
510
- - frontend-development
511
- - name: qk-validation-gate
512
- version: 8.2.0
277
+ triggers: [design system, token, setup css, ui system]
278
+ intent: [design-system, token-library]
279
+
280
+ - name: qk-upgrade
281
+ version: 9.2.0
513
282
  status: stable
514
- description: >-
515
- Cổng kiểm tra chất lượng & Eval Pipeline bắt buộc — chạy linters, tests,
516
- đánh giá scorecard.yaml định lượng cho AI Agent.
517
- complexity: low
518
- workflow: code-review
519
- triggers:
520
- - verify
521
- - kiểm tra
522
- - lint
523
- - test
524
- - run checks
525
- intent:
526
- - quality-assurance
527
- - verification
528
- - code-review
283
+ description: Nâng cấp library/framework an toàn — incremental, rollback bắt buộc, không big-bang.
284
+ complexity: high
285
+ workflow: refactor
286
+ triggers: [upgrade, nâng cấp, update package, migrate framework, breaking change]
287
+ intent: [library-upgrade, framework-migration]
288
+
289
+ - name: qk-validation-gate
290
+ version: 9.2.1
291
+ status: relocated
292
+ description: Quality gate — linters, tests, scorecard.yaml quantitative (0–100).
293
+ complexity: medium
294
+ workflow: feature-delivery
295
+ triggers: [chạy kiểm định, quality gate, validate build, scorecard]
296
+ intent: [quality-gate, validation]
297
+
529
298
  - name: qk-web-quality-gate
530
- version: 8.1.0
299
+ version: 9.2.0
531
300
  status: experimental
532
- description: >-
533
- Kiểm toán tổng thể chất lượng Web: Accessibility (A11y), SEO, Web
534
- Performance, Security, UX Heuristics.
535
- complexity: high
301
+ description: A11y, SEO, Web Performance, Security, UX Heuristics audit.
302
+ complexity: medium
536
303
  workflow: feature-delivery
537
- triggers:
538
- - kiểm tra web
539
- - tối ưu web
540
- - lighthouse
541
- - audit ui
542
- - core web vitals
543
- intent:
544
- - web-performance
545
- - accessibility
546
- - seo
547
- - lighthouse
548
- - ux-audit
304
+ triggers: [a11y, seo, web performance, lighthouse, quality gate]
305
+ intent: [web-quality, accessibility, performance]