ai-developer-skill-os 9.3.0 → 10.1.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 (185) hide show
  1. package/.agents/AGENTS.md +60 -40
  2. package/.agents/DEV_PROFILE.md +36 -2
  3. package/.agents/registry/graph.json +95 -342
  4. package/.agents/registry/index.yaml +61 -237
  5. package/.agents/rules/coding.md +30 -12
  6. package/.agents/rules/command-safety.md +19 -8
  7. package/.agents/rules/global.md +234 -28
  8. package/.agents/rules/prompt-compiler.md +170 -0
  9. package/.agents/skills/qk-api-data-discovery/SKILL.md +470 -0
  10. package/.agents/skills/qk-backend-data/SKILL.md +190 -0
  11. package/.agents/skills/qk-bug-resolution/SKILL.md +176 -248
  12. package/.agents/skills/qk-code-cleaner/SKILL.md +250 -0
  13. package/.agents/skills/qk-code-review/SKILL.md +126 -247
  14. package/.agents/skills/qk-devops-release/SKILL.md +145 -0
  15. package/.agents/skills/qk-feature-delivery/SKILL.md +179 -247
  16. package/.agents/skills/qk-orchestrator/SKILL.md +100 -151
  17. package/.agents/skills/qk-product-spec/SKILL.md +113 -0
  18. package/.agents/skills/qk-prompt-compiler/SKILL.md +321 -0
  19. package/.agents/skills/qk-ui-engineer/SKILL.md +137 -0
  20. package/.agents/workflows/feature-delivery.yml +1 -1
  21. package/.agents/workflows/production-release.yml +1 -1
  22. package/.agents/workflows/spec-driven-development.yml +109 -87
  23. package/CHANGELOG.md +54 -0
  24. package/README.md +125 -184
  25. package/bin/install.js +337 -329
  26. package/package.json +2 -2
  27. package/.agents/README.md +0 -90
  28. package/.agents/docs/CHI_TIET_SKILLS.md +0 -126
  29. package/.agents/docs/HUONG_DAN_SU_DUNG.md +0 -120
  30. package/.agents/docs/MIGRATION-CLEANUP-V8.1.3.md +0 -36
  31. package/.agents/docs/MIGRATION-STATUS.md +0 -35
  32. package/.agents/docs/MIGRATION-V8.md +0 -10
  33. package/.agents/docs/ROADMAP-V8.2.md +0 -78
  34. package/.agents/docs/V8-CERTIFICATION.md +0 -27
  35. package/.agents/skills/qk-access-policy/SKILL.md +0 -206
  36. package/.agents/skills/qk-access-policy/capability.yaml +0 -23
  37. package/.agents/skills/qk-access-policy/evals/scorecard.yaml +0 -36
  38. package/.agents/skills/qk-agent-observability/SKILL.md +0 -108
  39. package/.agents/skills/qk-agent-observability/capability.yaml +0 -29
  40. package/.agents/skills/qk-agent-observability/evals/scorecard.yaml +0 -29
  41. package/.agents/skills/qk-agent-observability/references/scorecard.yaml +0 -80
  42. package/.agents/skills/qk-ai-builder/SKILL.md +0 -254
  43. package/.agents/skills/qk-ai-builder/capability.yaml +0 -23
  44. package/.agents/skills/qk-ai-builder/evals/scorecard.yaml +0 -30
  45. package/.agents/skills/qk-api-consumer/SKILL.md +0 -256
  46. package/.agents/skills/qk-api-consumer/capability.yaml +0 -21
  47. package/.agents/skills/qk-api-consumer/evals/scorecard.yaml +0 -29
  48. package/.agents/skills/qk-api-lifecycle/SKILL.md +0 -251
  49. package/.agents/skills/qk-api-lifecycle/capability.yaml +0 -23
  50. package/.agents/skills/qk-api-lifecycle/evals/scorecard.yaml +0 -29
  51. package/.agents/skills/qk-bug-resolution/capability.yaml +0 -25
  52. package/.agents/skills/qk-code-review/capability.yaml +0 -23
  53. package/.agents/skills/qk-context-loader/SKILL.md +0 -198
  54. package/.agents/skills/qk-context-loader/capability.yaml +0 -23
  55. package/.agents/skills/qk-context-loader/evals/scorecard.yaml +0 -28
  56. package/.agents/skills/qk-data-engineer/SKILL.md +0 -253
  57. package/.agents/skills/qk-data-lifecycle/SKILL.md +0 -197
  58. package/.agents/skills/qk-data-lifecycle/capability.yaml +0 -23
  59. package/.agents/skills/qk-data-lifecycle/evals/scorecard.yaml +0 -29
  60. package/.agents/skills/qk-db-optimizer/SKILL.md +0 -210
  61. package/.agents/skills/qk-db-optimizer/capability.yaml +0 -22
  62. package/.agents/skills/qk-db-optimizer/evals/scorecard.yaml +0 -28
  63. package/.agents/skills/qk-design-system-engineering/SKILL.md +0 -193
  64. package/.agents/skills/qk-design-system-engineering/capability.yaml +0 -25
  65. package/.agents/skills/qk-design-system-engineering/evals/scorecard.yaml +0 -27
  66. package/.agents/skills/qk-devops-platform/SKILL.md +0 -198
  67. package/.agents/skills/qk-devops-platform/capability.yaml +0 -29
  68. package/.agents/skills/qk-devops-platform/evals/scorecard.yaml +0 -28
  69. package/.agents/skills/qk-docs/SKILL.md +0 -193
  70. package/.agents/skills/qk-docs/capability.yaml +0 -23
  71. package/.agents/skills/qk-docs/evals/scorecard.yaml +0 -27
  72. package/.agents/skills/qk-engineering-standard/SKILL.md +0 -89
  73. package/.agents/skills/qk-engineering-standard/capability.yaml +0 -23
  74. package/.agents/skills/qk-engineering-standard/evals/scorecard.yaml +0 -28
  75. package/.agents/skills/qk-engineering-standard/references/anti-patterns.md +0 -121
  76. package/.agents/skills/qk-engineering-standard/rules/backend.md +0 -122
  77. package/.agents/skills/qk-engineering-standard/rules/database.md +0 -3
  78. package/.agents/skills/qk-engineering-standard/rules/frontend.md +0 -152
  79. package/.agents/skills/qk-engineering-standard/rules/security.md +0 -3
  80. package/.agents/skills/qk-engineering-standard/rules/testing.md +0 -3
  81. package/.agents/skills/qk-fe-api-integration/SKILL.md +0 -704
  82. package/.agents/skills/qk-fe-api-integration/capability.yaml +0 -21
  83. package/.agents/skills/qk-fe-api-integration/evals/scorecard.yaml +0 -29
  84. package/.agents/skills/qk-feature-delivery/capability.yaml +0 -24
  85. package/.agents/skills/qk-frontend-architecture/SKILL.md +0 -127
  86. package/.agents/skills/qk-frontend-architecture/capability.yaml +0 -28
  87. package/.agents/skills/qk-frontend-architecture/evals/scorecard.yaml +0 -28
  88. package/.agents/skills/qk-help/SKILL.md +0 -107
  89. package/.agents/skills/qk-help/capability.yaml +0 -20
  90. package/.agents/skills/qk-help/evals/scorecard.yaml +0 -13
  91. package/.agents/skills/qk-orchestrator/capability.yaml +0 -22
  92. package/.agents/skills/qk-product-specification/SKILL.md +0 -187
  93. package/.agents/skills/qk-product-specification/capability.yaml +0 -27
  94. package/.agents/skills/qk-product-specification/evals/scorecard.yaml +0 -27
  95. package/.agents/skills/qk-production-release/SKILL.md +0 -188
  96. package/.agents/skills/qk-production-release/capability.yaml +0 -27
  97. package/.agents/skills/qk-production-release/evals/scorecard.yaml +0 -28
  98. package/.agents/skills/qk-project-audit/SKILL.md +0 -174
  99. package/.agents/skills/qk-project-bootstrap/SKILL.md +0 -372
  100. package/.agents/skills/qk-project-bootstrap/capability.yaml +0 -23
  101. package/.agents/skills/qk-project-bootstrap/evals/scorecard.yaml +0 -28
  102. package/.agents/skills/qk-project-health/SKILL.md +0 -202
  103. package/.agents/skills/qk-project-health/capability.yaml +0 -23
  104. package/.agents/skills/qk-project-health/evals/scorecard.yaml +0 -27
  105. package/.agents/skills/qk-project-memory/SKILL.md +0 -303
  106. package/.agents/skills/qk-project-memory/capability.yaml +0 -23
  107. package/.agents/skills/qk-project-memory/evals/scorecard.yaml +0 -27
  108. package/.agents/skills/qk-refactor/SKILL.md +0 -243
  109. package/.agents/skills/qk-refactor/capability.yaml +0 -26
  110. package/.agents/skills/qk-refactor/evals/scorecard.yaml +0 -27
  111. package/.agents/skills/qk-security-audit/SKILL.md +0 -280
  112. package/.agents/skills/qk-security-audit/capability.yaml +0 -29
  113. package/.agents/skills/qk-security-audit/evals/scorecard.yaml +0 -27
  114. package/.agents/skills/qk-system-evolution/SKILL.md +0 -625
  115. package/.agents/skills/qk-system-evolution/capability.yaml +0 -24
  116. package/.agents/skills/qk-system-evolution/evals/scorecard.yaml +0 -26
  117. package/.agents/skills/qk-test-engineering/SKILL.md +0 -215
  118. package/.agents/skills/qk-test-engineering/capability.yaml +0 -28
  119. package/.agents/skills/qk-test-engineering/evals/scorecard.yaml +0 -26
  120. package/.agents/skills/qk-ui-audit/SKILL.md +0 -175
  121. package/.agents/skills/qk-ui-audit/capability.yaml +0 -23
  122. package/.agents/skills/qk-ui-audit/evals/scorecard.yaml +0 -26
  123. package/.agents/skills/qk-ui-audit/references/anti-slop-checklist.md +0 -136
  124. package/.agents/skills/qk-ui-builder/SKILL.md +0 -521
  125. package/.agents/skills/qk-ui-builder/capability.yaml +0 -29
  126. package/.agents/skills/qk-ui-builder/evals/scorecard.yaml +0 -26
  127. package/.agents/skills/qk-ui-builder/references/anti-patterns.md +0 -295
  128. package/.agents/skills/qk-ui-builder/references/color.md +0 -115
  129. package/.agents/skills/qk-ui-builder/references/component-cookbook.md +0 -458
  130. package/.agents/skills/qk-ui-builder/references/copy.md +0 -250
  131. package/.agents/skills/qk-ui-builder/references/interaction-and-states.md +0 -115
  132. package/.agents/skills/qk-ui-builder/references/layout-and-space.md +0 -111
  133. package/.agents/skills/qk-ui-builder/references/macrostructures/01-bento-grid.md +0 -48
  134. package/.agents/skills/qk-ui-builder/references/macrostructures/02-long-document.md +0 -50
  135. package/.agents/skills/qk-ui-builder/references/macrostructures/03-marquee-hero.md +0 -51
  136. package/.agents/skills/qk-ui-builder/references/macrostructures/04-stat-led.md +0 -49
  137. package/.agents/skills/qk-ui-builder/references/macrostructures/05-workbench.md +0 -44
  138. package/.agents/skills/qk-ui-builder/references/macrostructures/06-conversational-faq.md +0 -50
  139. package/.agents/skills/qk-ui-builder/references/macrostructures/07-manifesto.md +0 -51
  140. package/.agents/skills/qk-ui-builder/references/macrostructures/08-photographic.md +0 -50
  141. package/.agents/skills/qk-ui-builder/references/macrostructures/09-quote-led.md +0 -50
  142. package/.agents/skills/qk-ui-builder/references/macrostructures/11-catalogue.md +0 -49
  143. package/.agents/skills/qk-ui-builder/references/macrostructures/12-letter.md +0 -49
  144. package/.agents/skills/qk-ui-builder/references/macrostructures/13-index-first.md +0 -49
  145. package/.agents/skills/qk-ui-builder/references/macrostructures/14-narrative-workflow.md +0 -48
  146. package/.agents/skills/qk-ui-builder/references/macrostructures/15-split-studio.md +0 -48
  147. package/.agents/skills/qk-ui-builder/references/macrostructures/16-feature-stack.md +0 -51
  148. package/.agents/skills/qk-ui-builder/references/macrostructures/17-type-specimen.md +0 -48
  149. package/.agents/skills/qk-ui-builder/references/macrostructures/18-portfolio-grid.md +0 -48
  150. package/.agents/skills/qk-ui-builder/references/macrostructures/19-map-diagram.md +0 -50
  151. package/.agents/skills/qk-ui-builder/references/macrostructures/20-ecosystem-index.md +0 -48
  152. package/.agents/skills/qk-ui-builder/references/macrostructures/21-component-playground.md +0 -45
  153. package/.agents/skills/qk-ui-builder/references/macrostructures.md +0 -38
  154. package/.agents/skills/qk-ui-builder/references/motion.md +0 -95
  155. package/.agents/skills/qk-ui-builder/references/responsive.md +0 -115
  156. package/.agents/skills/qk-ui-builder/references/slop-test.md +0 -135
  157. package/.agents/skills/qk-ui-builder/references/structure.md +0 -280
  158. package/.agents/skills/qk-ui-builder/references/themes/atmospheric.md +0 -53
  159. package/.agents/skills/qk-ui-builder/references/themes/carnival.md +0 -52
  160. package/.agents/skills/qk-ui-builder/references/themes/cobalt.md +0 -52
  161. package/.agents/skills/qk-ui-builder/references/themes/editorial.md +0 -52
  162. package/.agents/skills/qk-ui-builder/references/themes/garden.md +0 -52
  163. package/.agents/skills/qk-ui-builder/references/themes/hum.md +0 -52
  164. package/.agents/skills/qk-ui-builder/references/themes/lumen.md +0 -52
  165. package/.agents/skills/qk-ui-builder/references/themes/midnight.md +0 -52
  166. package/.agents/skills/qk-ui-builder/references/themes/modern-minimal.md +0 -52
  167. package/.agents/skills/qk-ui-builder/references/themes/playful.md +0 -52
  168. package/.agents/skills/qk-ui-builder/references/themes/specimen.md +0 -52
  169. package/.agents/skills/qk-ui-builder/references/themes/terminal.md +0 -52
  170. package/.agents/skills/qk-ui-builder/references/typography.md +0 -129
  171. package/.agents/skills/qk-ui-system-builder/SKILL.md +0 -183
  172. package/.agents/skills/qk-ui-system-builder/capability.yaml +0 -25
  173. package/.agents/skills/qk-ui-system-builder/evals/scorecard.yaml +0 -26
  174. package/.agents/skills/qk-upgrade/SKILL.md +0 -301
  175. package/.agents/skills/qk-upgrade/capability.yaml +0 -24
  176. package/.agents/skills/qk-upgrade/evals/scorecard.yaml +0 -26
  177. package/.agents/skills/qk-validation-gate/SKILL.md +0 -88
  178. package/.agents/skills/qk-validation-gate/capability.yaml +0 -23
  179. package/.agents/skills/qk-validation-gate/evals/scorecard.yaml +0 -26
  180. package/.agents/skills/qk-web-quality-gate/SKILL.md +0 -197
  181. package/.agents/skills/qk-web-quality-gate/capability.yaml +0 -24
  182. package/.agents/skills/qk-web-quality-gate/evals/scorecard.yaml +0 -26
  183. package/.agents/workflows/research.yml +0 -75
  184. package/.agents/workflows/skill-evolution.yml +0 -97
  185. package/tooling/fix-refactor.js +0 -8
@@ -1,183 +0,0 @@
1
- ---
2
- # ── Identity ───────────────────────────────────────────────
3
- name: qk-ui-system-builder
4
- version: 9.2.0
5
- status: stable
6
- description: "Xây dựng Design System và token library từ DESIGN.md — không tự đặt ra token ngoài contract. Dùng skill này khi user nhắc đến: design system, token, setup css, ui system, tạo design system, cấu hình token — kể cả khi chỉ nói 'tạo file tailwind tokens từ bảng màu này'."
7
- platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
8
-
9
- # ── V9: Classification ─────────────────────────────────────
10
- type: capability
11
-
12
- intent:
13
- - ui-system-design
14
- - frontend-development
15
-
16
- complexity:
17
- level: medium
18
- criteria:
19
- files_affected: "1-5"
20
- has_behavior_change: true
21
- has_external_dependency: false
22
- has_breaking_change: false
23
-
24
- triggers:
25
- - "design system"
26
- - "token"
27
- - "setup css"
28
- - "ui system"
29
- - "tạo design system"
30
- - "cấu hình token"
31
-
32
-
33
- # ── V8: References ─────────────────────────────────────────
34
- workflow: feature-delivery
35
-
36
- rules:
37
- - global
38
- - coding
39
-
40
- tools:
41
- - filesystem
42
- - terminal
43
-
44
- related_skills:
45
- - qk-ui-builder
46
-
47
- knowledge_scope:
48
- owns:
49
- - design-tokens
50
- - ui-system
51
- references:
52
- - design-system
53
-
54
- decision_boundary:
55
- owns:
56
- - tokens
57
- - ui-system
58
- does_not_own:
59
- - page implementation
60
- - visual direction
61
- conflicts_with:
62
- - qk-design-system-engineering
63
-
64
- knowledge_dependencies:
65
- - design-intelligence
66
-
67
- # ── V8: Verification ───────────────────────────────────────
68
- verification:
69
- required: true
70
- strategy: feature
71
-
72
- selection:
73
- priority: medium
74
- confidence_threshold: 0.80
75
-
76
- examples: []
77
- learnings: []
78
-
79
- # ── V7 Runtime ─────────────────────────────────────────────
80
- execution_mode: deterministic
81
- cost: medium
82
- latency: medium
83
- risk: low
84
- side_effects: edit_files
85
- produces: [code, tokens]
86
- consumes: [design-md]
87
-
88
- token_budget:
89
- max_files_read: 3
90
- max_lines_per_read: 150
91
- max_shell_commands: 0
92
- stop_early: true
93
-
94
- exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
95
- ---
96
-
97
- # qk-ui-system-builder — Design System & Token Constructor
98
-
99
- > **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
100
-
101
- Chịu trách nhiệm hiện thực hóa hệ thống Design Tokens (màu sắc, typography, spacing, shadows, radius) thành mã nguồn (CSS Variables, Tailwind Config, hoặc TypeScript Tokens) dựa trên tài liệu thiết kế (`DESIGN.md`). **Tuyệt đối không tự ý bịa đặt token ngoài hợp đồng thiết kế.**
102
-
103
- ---
104
-
105
- ## Preconditions
106
-
107
- Trước khi tạo hoặc sửa đổi file token, AI BẮT BUỘC kiểm tra:
108
-
109
- - [ ] Tìm và đọc file đặc tả thiết kế (`DESIGN.md` hoặc styleguide document).
110
- - [ ] Xác định CSS framework đang sử dụng từ `.agents/DEV_PROFILE.md` (Tailwind CSS, CSS Modules, Styled Components, Vanilla CSS).
111
- - [ ] Kiểm tra xem đã có hệ thống tokens cũ chưa (tránh ghi đè làm vỡ giao diện đang chạy).
112
- - [ ] Nếu không có `DESIGN.md` và user không cung cấp giá trị màu sắc/kích thước cụ thể:
113
- → **EXIT: BLOCKED**
114
- → Báo cáo user yêu cầu cung cấp bảng màu (Palette) hoặc file quy chuẩn thiết kế trước.
115
-
116
- ---
117
-
118
- ## Scope
119
-
120
- ✅ Skill này làm:
121
- - Chuyển đổi mã màu Hex/HSL thành semantic CSS custom properties (`--color-primary`, `--color-surface-base`).
122
- - Cấu hình file `tailwind.config.js` / `tailwind.config.ts` khớp chính xác với Design Tokens.
123
- - Khai báo token cho Spacing (bội số của 4px/8px), Font sizes, Border Radius, Shadows, Transitions.
124
- - Tạo theme hỗ trợ Light/Dark mode qua CSS variables.
125
- - Xuất type definition TypeScript cho autocomplete token trong code.
126
-
127
- ❌ Skill này KHÔNG làm:
128
- - Dựng các màn hình hay component hoàn chỉnh (→ `qk-ui-builder`).
129
- - Định nghĩa chiến lược quy chuẩn thiết kế cấp cao (→ `qk-design-system-engineering`).
130
- - Sửa đổi business logic backend.
131
-
132
- ---
133
-
134
- ## Execution Steps
135
-
136
- ### Step 1 — Parse Design Specs & Contracts
137
- ```
138
- Inputs: DESIGN.md, Bảng màu từ user
139
- Actions:
140
- - Trích xuất: Primitive tokens (Brand colors, Neutrals, Font families).
141
- - Trích xuất: Semantic tokens (Background, Foreground, Border, Primary, Destructive).
142
- - Phân loại thang đo Spacing, Radius và Elevation (box-shadow).
143
- Output: Structured Token Contract
144
- ```
145
-
146
- ### Step 2 — CSS Variable & Theme Definition
147
- ```
148
- Inputs: Structured Token Contract
149
- Actions:
150
- - Khởi tạo `:root` chứa biến màu Light mode.
151
- - Khởi tạo `.dark` hoặc `[data-theme="dark"]` chứa biến màu Dark mode tương ứng.
152
- - Bảo đảm tỉ lệ tương phản đạt chuẩn WCAG AA giữa Foreground và Background.
153
- Output: globals.css / theme.css
154
- ```
155
-
156
- ### Step 3 — Framework Config Integration
157
- ```
158
- Inputs: globals.css, Tailwind config (hoặc tương đương)
159
- Actions:
160
- - Mở rộng (extend) theme của Tailwind: colors, spacing, borderRadius, fontSize.
161
- - Ánh xạ trực tiếp sang `var(--...)` để tận dụng tính năng theme switching động.
162
- Output: tailwind.config.ts / tokens.ts
163
- ```
164
-
165
- ### Step 4 — Verification & Type Generation
166
- ```
167
- Inputs: Generated config files
168
- Actions:
169
- - Kiểm tra cú pháp config file.
170
- - Đảm bảo token types được export rõ ràng cho IDE autocomplete.
171
- Exit: SUCCESS
172
- ```
173
-
174
- ---
175
-
176
- ## Prompt Template
177
-
178
- ```
179
- Tài liệu thiết kế: [Đường dẫn DESIGN.md hoặc paste bảng màu]
180
- Framework CSS: [Tailwind CSS / CSS Modules / Vanilla CSS]
181
- Dark Mode: [Có hỗ trợ không — class / data-theme / media query]
182
- Yêu cầu riêng: [Cần bổ sung font chữ mới, radius đặc biệt, ...]
183
- ```
@@ -1,25 +0,0 @@
1
- # Auto-generated from SKILL.md frontmatter
2
- schema_version: 1
3
- id: "qk-ui-system-builder"
4
- version: "9.1.0"
5
- description: "Xây dựng Design System và token library từ DESIGN.md — không tự đặt ra token ngoài contract."
6
- tools:
7
- - "filesystem"
8
- - "terminal"
9
- knowledge:
10
- owns:
11
- - "design-tokens"
12
- - "ui-system"
13
- references:
14
- - "design-system"
15
- eval:
16
- scorecard: "evals/scorecard.yaml"
17
- decision_boundary:
18
- owns:
19
- - "tokens"
20
- - "ui-system"
21
- does_not_own:
22
- - "page implementation"
23
- - "visual direction"
24
- conflicts_with:
25
- - "qk-design-system-engineering"
@@ -1,26 +0,0 @@
1
- name: qk-ui-system-builder-eval
2
- description: Đánh giá việc khởi tạo Design System Tokens
3
- version: 9.1.0
4
- threshold: 85 # Đảm bảo tokens sinh ra ánh xạ 1:1 với contract
5
-
6
- metrics:
7
- - id: strict_token_mapping
8
- name: Ánh xạ chuẩn xác từ Contract
9
- description: Các token được tạo ra có khớp 1:1 với DESIGN.md không?
10
- weight: 45
11
- criteria:
12
- - Tuyệt đối không tự bịa (hallucinate) các token màu sắc/kích thước ngoài hợp đồng (45đ)
13
-
14
- - id: naming_conventions
15
- name: Kỷ luật Đặt tên (Naming Convention)
16
- description: Cấu trúc biến CSS có đúng chuẩn và dễ mở rộng không?
17
- weight: 30
18
- criteria:
19
- - Sử dụng đúng cấu trúc `--color-role-shade` thay vì tên ngẫu nhiên (30đ)
20
-
21
- - id: dark_mode_support
22
- name: Hỗ trợ Giao diện Tối (Dark Mode)
23
- description: Có xử lý cấu trúc biến để hỗ trợ Data-theme/Dark-mode không?
24
- weight: 25
25
- criteria:
26
- - Thiết lập base variables có khả năng scale cho các theme khác nhau (25đ)
@@ -1,301 +0,0 @@
1
- ---
2
- # ── Identity ───────────────────────────────────────────────
3
- name: qk-upgrade
4
- version: 9.2.0
5
- status: stable
6
- description: "Nâng cấp library/framework an toàn — incremental strategy, audit breaking changes, rollback plan bắt buộc, không big-bang update. Dùng skill này khi user nhắc đến: upgrade, nâng cấp thư viện, update package, migrate framework, version, cập nhật dependency, breaking change — kể cả khi chỉ nói 'nâng Next.js lên bản mới nhất'."
7
- platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
8
-
9
- # ── Classification ─────────────────────────────────────────
10
- type: capability
11
-
12
- intent:
13
- - library-upgrade
14
- - framework-migration
15
- - dependency-management
16
-
17
- complexity:
18
- level: high
19
- criteria:
20
- files_affected: "10+"
21
- has_behavior_change: false
22
- has_external_dependency: true
23
- has_breaking_change: true
24
-
25
- triggers:
26
- - "upgrade"
27
- - "nâng cấp thư viện"
28
- - "update package"
29
- - "migrate framework"
30
- - "version"
31
- - "cập nhật dependency"
32
- - "breaking change"
33
-
34
-
35
- # ── References ─────────────────────────────────────────────
36
- workflow: refactor
37
-
38
- rules:
39
- - global
40
- - coding
41
- - safety
42
-
43
- tools:
44
- - filesystem
45
- - terminal
46
-
47
- related_skills:
48
- - qk-project-health # Chạy trước để biết tech debt tổng thể
49
- - qk-refactor # Dùng sau upgrade để clean code dùng deprecated API
50
- - qk-test-engineering # Verify không có regression sau upgrade
51
-
52
- knowledge_scope:
53
- owns:
54
- - upgrade-strategy
55
- - rollback-plan
56
- - migration-path
57
- - breaking-change-analysis
58
- references:
59
- - testing
60
- - architecture
61
- - security
62
- - anti-patterns
63
-
64
- # ── Verification ───────────────────────────────────────────
65
- verification:
66
- required: true
67
- strategy: refactor
68
-
69
- selection:
70
- priority: medium
71
- confidence_threshold: 0.85
72
-
73
- # ── Runtime ────────────────────────────────────────────────
74
- execution_mode: deterministic
75
- cost: high
76
- latency: slow
77
- risk: high
78
- side_effects: edit_files
79
- produces: [code, report, plan]
80
- consumes: [context-graph, source-code]
81
-
82
- token_budget:
83
- max_files_read: 6
84
- max_lines_per_read: 120
85
- max_shell_commands: 3
86
- stop_early: true
87
-
88
- exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
89
- ---
90
-
91
- # qk-upgrade — Safe Library & Framework Upgrade
92
-
93
- > **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
94
-
95
- ---
96
-
97
- ## Preconditions
98
-
99
- Trước khi bắt đầu, AI PHẢI xác nhận:
100
-
101
- - [ ] Biết version hiện tại và version target
102
- → Đọc `package.json` / `requirements.txt` / `go.mod` / `Cargo.toml`
103
- - [ ] Biết changelog / migration guide của version target
104
- → Search official docs hoặc GitHub releases
105
- - [ ] Có test suite để verify regression (unit test, E2E, hoặc ít nhất manual smoke test)
106
- → Nếu không có test: `BLOCKED` với warning — upgrade không có safety net
107
- - [ ] Git working tree clean (không có uncommitted changes)
108
- → Nếu dirty: `BLOCKED` — yêu cầu commit hoặc stash trước
109
-
110
- **Risk classification:**
111
- - `patch` (1.2.3 → 1.2.4): low — thường safe, proceed autonomously
112
- - `minor` (1.2.x → 1.3.x): medium — check deprecations, report trước
113
- - `major` (1.x → 2.x): high — PHẢI có rollback plan, confirm với user
114
-
115
- ---
116
-
117
- ## Scope
118
-
119
- ✅ Skill này làm:
120
- - Phân tích breaking changes giữa version hiện tại và target
121
- - Lên migration plan từng bước (không big-bang)
122
- - Update dependency files
123
- - Sửa code dùng deprecated/removed API
124
- - Verify sau upgrade (chạy test, check build)
125
- - Tạo rollback instructions
126
-
127
- ❌ Skill này KHÔNG làm:
128
- - Refactor business logic không liên quan đến upgrade
129
- - Thêm feature mới trong khi upgrade
130
- - Upgrade nhiều major versions cùng lúc (→ chia nhỏ thành nhiều tasks)
131
- - Deploy lên production (→ `qk-production-release`)
132
-
133
- ---
134
-
135
- ## Execution Steps
136
-
137
- ### Step 1 — Audit hiện trạng
138
- ```
139
- Inputs: package.json / lock file / dependency manifest
140
- Actions:
141
- - List tất cả dependencies + version hiện tại
142
- - Xác định dependency cần upgrade (target) + version muốn lên
143
- - Check transitive dependencies có bị ảnh hưởng không
144
- - Tìm migration guide chính thức
145
- Outputs: Upgrade scope + risk level
146
- Exit: BLOCKED nếu không tìm được migration guide cho major upgrade
147
- ```
148
-
149
- ### Step 2 — Phân tích Breaking Changes
150
- ```
151
- Inputs: Changelog / migration guide / GitHub releases
152
- Actions:
153
- - List tất cả breaking changes giữa current → target version
154
- - Categorize: API removed / renamed / signature changed / behavior changed
155
- - Grep codebase để đếm số lần dùng từng API bị ảnh hưởng
156
- - Ước tính effort (số file, số thay đổi)
157
- Outputs: Breaking change inventory + impact assessment
158
- ```
159
-
160
- ### Step 3 — Lên Migration Plan
161
- ```
162
- Inputs: Breaking change inventory
163
- Actions:
164
- - Chia thành phases nếu major upgrade (không làm tất cả 1 lần)
165
- - Phase 1: Update dependency, fix compile errors
166
- - Phase 2: Replace deprecated API
167
- - Phase 3: Adopt new patterns (optional, separate task)
168
- - Viết rollback command rõ ràng
169
- Outputs: Phased migration plan + rollback instructions
170
- Human checkpoint: Confirm plan trước khi thực thi (nếu major upgrade)
171
- ```
172
-
173
- ### Step 4 — Execute Migration
174
- ```
175
- Actions:
176
- 4a. Update version trong dependency file
177
- 4b. Chạy package manager install
178
- 4c. Fix compile errors / type errors theo thứ tự từ entry point
179
- 4d. Replace deprecated API calls (grep → replace có kiểm soát)
180
- 4e. Không refactor code không liên quan — chỉ làm đủ để build pass
181
-
182
- Rules:
183
- - Mỗi phase phải build và test pass trước khi sang phase tiếp
184
- - Không dùng `// @ts-ignore` để ẩn lỗi type
185
- - Không dùng `any` để workaround type conflict
186
- - Document lý do nếu phải dùng compatibility shim tạm thời
187
- ```
188
-
189
- ### Step 5 — Verify
190
- ```
191
- Actions:
192
- - Chạy build: không có compile error
193
- - Chạy test suite: không có regression
194
- - Smoke test manual những path quan trọng nhất
195
- - So sánh bundle size / performance nếu có tool
196
- - Review diff cuối: không có thay đổi không liên quan
197
- Outputs: Verification report (pass/fail per check)
198
- Exit: FAILED nếu test regression, đính kèm rollback instructions
199
- ```
200
-
201
- ---
202
-
203
- ## Prompt Template
204
-
205
- AI đọc `DEV_PROFILE.md` để biết stack. Cung cấp target version — AI lo phân tích và plan.
206
-
207
- ```
208
- Package: [Tên thư viện / framework cần upgrade]
209
- Từ: [Version hiện tại — vd: 4.x]
210
- Lên: [Version target — vd: 5.0]
211
- Lý do: [Bug fix / security patch / new feature / EOL]
212
- Test suite: [Có / Không / Partial — vd: "có Jest unit tests, không có E2E"]
213
- Deadline: [Urgent / Can plan carefully]
214
- ```
215
-
216
- ---
217
-
218
- ### Theo Stack:
219
-
220
- **Node.js / TypeScript — Major upgrade (Express 4 → 5)**
221
- ```
222
- Package: Express
223
- Từ: 4.18.x
224
- Lên: 5.0.0
225
- Lý do: Security patches + async error handling native
226
- Test suite: Có Jest + Supertest cho API routes
227
- Deadline: Can plan carefully
228
- ```
229
- → AI phân tích: async middleware error handling thay đổi (không cần try/catch),
230
- `req.query` parsing thay đổi, path-to-regexp breaking changes,
231
- deprecated `res.json()` overloads, router API changes.
232
- Plan: Phase 1 — update + fix types, Phase 2 — adopt async handlers,
233
- Phase 3 — remove compatibility workarounds.
234
-
235
- **Python — Minor upgrade (FastAPI 0.100 → 0.110)**
236
- ```
237
- Package: FastAPI + Pydantic
238
- Từ: fastapi==0.100, pydantic==1.10
239
- Lên: fastapi==0.110, pydantic==2.x
240
- Lý do: Pydantic v2 performance 5-50x nhanh hơn
241
- Test suite: Có pytest + httpx async tests
242
- Deadline: Can plan carefully
243
- ```
244
- → AI phân tích: Pydantic v2 breaking changes (validators syntax, model_config,
245
- Field() params), FastAPI Pydantic v2 compatibility layer,
246
- `orm_mode` → `model_config = ConfigDict(from_attributes=True)`.
247
- Plan: Phase 1 — upgrade Pydantic, fix models, Phase 2 — remove compat layer.
248
-
249
- **Frontend — Major upgrade (React 17 → 18)**
250
- ```
251
- Package: React + ReactDOM
252
- Từ: 17.0.2
253
- Lên: 18.x
254
- Lý do: Concurrent features + automatic batching
255
- Test suite: Có Vitest + React Testing Library
256
- Deadline: Urgent (security)
257
- ```
258
- → AI phân tích: `ReactDOM.render` → `createRoot`, `ReactDOM.hydrate` → `hydrateRoot`,
259
- Strict Mode double-invoke effects (test side effects), auto-batching setState
260
- (có thể break code expect sync update), Suspense behavior changes.
261
-
262
- **Database ORM — Minor upgrade (Prisma 4 → 5)**
263
- ```
264
- Package: Prisma
265
- Từ: 4.x
266
- Lên: 5.x
267
- Lý do: Performance improvements + new features
268
- Test suite: Có Jest + Prisma test utilities
269
- Deadline: Can plan carefully
270
- ```
271
- → AI phân tích: `rejectOnNotFound` removed → dùng `findUniqueOrThrow`,
272
- `jsonProtocol` now default (check binary targets),
273
- `db push --accept-data-loss` behavior change,
274
- type changes trong `Prisma.XxxWhereInput`.
275
-
276
- **Data / Python ecosystem — Major (Python 3.9 → 3.12)**
277
- ```
278
- Package: Python runtime + dependencies
279
- Từ: 3.9
280
- Lên: 3.12
281
- Lý do: EOL approach + performance gains
282
- Test suite: Có pytest full suite
283
- Deadline: Can plan carefully
284
- ```
285
- → AI phân tích: deprecated stdlib modules (distutils removed),
286
- `typing` module changes (use built-in generics `list[str]` thay `List[str]`),
287
- f-string improvements, asyncio API changes,
288
- check requirements.txt compatibility với 3.12 (numpy, pandas versions).
289
-
290
- **DevOps — Upgrade CI runner (ubuntu-20.04 → ubuntu-24.04)**
291
- ```
292
- Package: GitHub Actions ubuntu runner
293
- Từ: ubuntu-20.04
294
- Lên: ubuntu-24.04
295
- Lý do: ubuntu-20.04 EOL
296
- Test suite: Workflow chạy được là pass
297
- Deadline: Urgent (EOL)
298
- ```
299
- → AI phân tích: Node.js bundled version thay đổi, Python 2 removed,
300
- OpenSSL version differences (affect TLS), apt package names thay đổi,
301
- action versions cần update (actions/setup-node@v3 → v4).
@@ -1,24 +0,0 @@
1
- # Auto-generated from SKILL.md frontmatter
2
- schema_version: 1
3
- id: "qk-system-evolution"
4
- version: "9.1.0"
5
- description: "Nâng cấp thư viện/framework an toàn với rollback plan bắt buộc — incremental, không big-bang."
6
- tools:
7
- - "filesystem"
8
- - "terminal"
9
- knowledge:
10
- owns:
11
- - "upgrade-strategy"
12
- - "rollback-plan"
13
- references:
14
- - "testing"
15
- - "architecture"
16
- - "security"
17
- - "anti-patterns"
18
- eval:
19
- scorecard: "evals/scorecard.yaml"
20
- decision_boundary:
21
- owns:
22
- - "qk-system-evolution"
23
- does_not_own: []
24
- conflicts_with: []
@@ -1,26 +0,0 @@
1
- name: qk-system-evolution-eval
2
- description: Đánh giá độ an toàn của quy trình nâng cấp System & Framework
3
- version: 9.1.0
4
- threshold: 90 # Việc nâng cấp framework mang rủi ro sập hệ thống rất cao
5
-
6
- metrics:
7
- - id: rollback_safety
8
- name: Cơ chế Rollback bắt buộc
9
- description: Agent có thiết lập và ghi chép lại lệnh rollback trước khi nâng cấp không?
10
- weight: 40
11
- criteria:
12
- - Phải yêu cầu/lưu lại Rollback command (git tag / version trước đó) trước khi sửa code (40đ)
13
-
14
- - id: changelog_awareness
15
- name: Phân tích Breaking Changes
16
- description: Agent có đọc Changelog thay vì nhắm mắt upgrade không?
17
- weight: 35
18
- criteria:
19
- - Quét và liệt kê các Breaking Changes từ Changelog/Migration Guide trước khi chạy (35đ)
20
-
21
- - id: incremental_upgrade
22
- name: Nâng cấp gia tăng (Incremental)
23
- description: Có nâng cấp từng phần và chạy test xác minh thay vì Big-bang không?
24
- weight: 25
25
- criteria:
26
- - Chạy test ngay sau khi nâng cấp 1 package thay vì update hàng loạt (25đ)
@@ -1,88 +0,0 @@
1
- ---
2
- # ── Identity ───────────────────────────────────────────────
3
- name: qk-validation-gate
4
- version: 9.2.1
5
- status: relocated
6
- description: "Cổng kiểm tra chất lượng & Eval Pipeline bắt buộc — chạy linters, tests, và đánh giá scorecard.yaml định lượng cho AI Agent."
7
- platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
8
-
9
- # ── V9: Classification ─────────────────────────────────────
10
- type: utility
11
-
12
- intent:
13
- - quality-assurance
14
- - verification
15
- - code-review
16
-
17
- complexity:
18
- level: low
19
- criteria:
20
- files_affected: "1-5"
21
- has_behavior_change: false
22
- has_external_dependency: false
23
- has_breaking_change: false
24
-
25
- triggers:
26
- - "verify"
27
- - "kiểm tra"
28
- - "lint"
29
- - "test"
30
- - "run checks"
31
-
32
- selection:
33
- priority: high
34
- confidence_threshold: 0.75
35
-
36
- # ── V8: References ─────────────────────────────────────────
37
- workflow: code-review
38
-
39
- rules:
40
- - global
41
-
42
- tools:
43
- - filesystem
44
- - terminal
45
-
46
- related_skills:
47
- - qk-engineering-standard
48
-
49
- knowledge_scope:
50
- owns:
51
- - verification
52
- - quality-gates
53
- - test-execution
54
- references:
55
- - coding
56
- - architecture
57
-
58
- # ── V8: Verification ───────────────────────────────────────
59
- verification:
60
- required: true
61
- strategy: review
62
-
63
- examples: []
64
- learnings: []
65
-
66
- # ── V7 Runtime ─────────────────────────────────────────────
67
- execution_mode: deterministic
68
- cost: medium
69
- latency: medium
70
- risk: low
71
- side_effects: run_commands
72
- produces: [report]
73
- consumes: [source-code]
74
-
75
- token_budget:
76
- max_files_read: 3
77
- max_lines_per_read: 100
78
- max_shell_commands: 2
79
- stop_early: false # Must run all checks — cannot skip for token budget
80
-
81
- exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
82
- ---
83
-
84
- # qk-validation-gate — Quality Gate
85
-
86
- > **⚠️ ARCHIVED (v9.2.1):** Downgraded thành workflow step. Logic verify đã được embed vào step `verify` của `feature-delivery.yml`, `bug-resolution.yml`, `refactor.yml`. Không cần gọi trực tiếp.
87
-
88
- > **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
@@ -1,23 +0,0 @@
1
- # Auto-generated from SKILL.md frontmatter
2
- schema_version: 1
3
- id: "qk-validation-gate"
4
- version: "9.1.0"
5
- description: "Cổng kiểm tra chất lượng & Eval Pipeline bắt buộc — chạy linters, tests, và đánh giá scorecard.yaml định lượng cho AI Agent."
6
- tools:
7
- - "filesystem"
8
- - "terminal"
9
- knowledge:
10
- owns:
11
- - "verification"
12
- - "quality-gates"
13
- - "test-execution"
14
- references:
15
- - "coding"
16
- - "architecture"
17
- eval:
18
- scorecard: "evals/scorecard.yaml"
19
- decision_boundary:
20
- owns:
21
- - "qk-validation-gate"
22
- does_not_own: []
23
- conflicts_with: []