ai-developer-skill-os 9.3.1 → 10.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/AGENTS.md +73 -40
- package/.agents/DEV_PROFILE.md +36 -2
- package/.agents/LICENSE +21 -21
- package/.agents/docs/ARCHITECTURE.md +56 -120
- package/.agents/docs/GOVERNANCE.md +3 -3
- package/.agents/docs/SPEC.md +137 -60
- package/.agents/docs/VERSIONING.md +25 -57
- package/.agents/docs/adr/0005-v10-platform-consolidation.md +50 -0
- package/.agents/docs/schemas/learning.schema.yml +22 -57
- package/.agents/docs/schemas/skill.schema.yml +116 -161
- package/.agents/docs/schemas/workflow.schema.yml +51 -26
- package/.agents/docs/skill-classification.md +1 -1
- package/.agents/registry/graph.json +193 -346
- package/.agents/registry/index.yaml +90 -233
- package/.agents/rules/coding.md +30 -12
- package/.agents/rules/command-safety.md +20 -9
- package/.agents/rules/global.md +234 -28
- package/.agents/rules/prompt-compiler.md +170 -0
- package/.agents/rules/safety.md +1 -1
- package/.agents/rules/security.md +1 -1
- package/.agents/rules/skill-quality.md +18 -3
- package/.agents/skills/_template/SKILL.md +238 -88
- package/.agents/skills/qk-api-data-discovery/SKILL.md +456 -0
- package/.agents/skills/qk-api-data-discovery/references/bronze-record-format.md +47 -0
- package/.agents/skills/qk-api-data-discovery/references/data-contract-yaml.md +72 -0
- package/.agents/skills/qk-api-data-discovery/references/discovery-report-template.md +110 -0
- package/.agents/skills/qk-backend-data/SKILL.md +339 -0
- package/.agents/skills/qk-bug-resolution/SKILL.md +328 -248
- package/.agents/skills/qk-bug-resolution/evals/scorecard.yaml +1 -1
- package/.agents/skills/qk-code-cleaner/SKILL.md +399 -0
- package/.agents/skills/qk-code-review/SKILL.md +320 -247
- package/.agents/skills/qk-code-review/evals/scorecard.yaml +1 -1
- package/.agents/skills/qk-code-review/references/ai/{v8-schema-validation.md → schema-validation.md} +2 -2
- package/.agents/skills/qk-code-review/references/cross-cutting/async-concurrency-patterns.md +515 -515
- package/.agents/skills/qk-code-review/references/cross-cutting/error-handling-principles.md +492 -492
- package/.agents/skills/qk-code-review/references/cross-cutting/n-plus-one-queries.md +309 -309
- package/.agents/skills/qk-code-review/references/cross-cutting/sql-injection-prevention.md +307 -307
- package/.agents/skills/qk-code-review/references/cross-cutting/xss-prevention.md +263 -263
- package/.agents/skills/qk-code-review/references/languages/angular.md +768 -768
- package/.agents/skills/qk-code-review/references/languages/c.md +890 -890
- package/.agents/skills/qk-code-review/references/languages/cpp.md +893 -893
- package/.agents/skills/qk-code-review/references/languages/css-less-sass.md +661 -661
- package/.agents/skills/qk-code-review/references/languages/django.md +985 -985
- package/.agents/skills/qk-code-review/references/languages/fastapi.md +580 -580
- package/.agents/skills/qk-code-review/references/languages/go.md +993 -993
- package/.agents/skills/qk-code-review/references/languages/java.md +409 -409
- package/.agents/skills/qk-code-review/references/languages/java8.md +586 -586
- package/.agents/skills/qk-code-review/references/languages/kotlin.md +1018 -1018
- package/.agents/skills/qk-code-review/references/languages/nestjs.md +593 -593
- package/.agents/skills/qk-code-review/references/languages/php.md +684 -684
- package/.agents/skills/qk-code-review/references/languages/python.md +1073 -1073
- package/.agents/skills/qk-code-review/references/languages/qt.md +757 -757
- package/.agents/skills/qk-code-review/references/languages/react.md +871 -871
- package/.agents/skills/qk-code-review/references/languages/ruby.md +964 -964
- package/.agents/skills/qk-code-review/references/languages/rust.md +846 -846
- package/.agents/skills/qk-code-review/references/languages/svelte.md +1064 -1064
- package/.agents/skills/qk-code-review/references/languages/swift.md +936 -936
- package/.agents/skills/qk-code-review/references/languages/typescript.md +1016 -1016
- package/.agents/skills/qk-code-review/references/languages/vue.md +924 -924
- package/.agents/skills/qk-code-review/references/languages/zig.md +440 -440
- package/.agents/skills/qk-devops-release/SKILL.md +294 -0
- package/.agents/skills/qk-feature-delivery/SKILL.md +331 -247
- package/.agents/skills/qk-feature-delivery/evals/scorecard.yaml +1 -1
- package/.agents/skills/qk-orchestrator/SKILL.md +286 -152
- package/.agents/skills/qk-orchestrator/evals/scorecard.yaml +1 -1
- package/.agents/skills/qk-orchestrator/references/routing-table.md +1 -1
- package/.agents/skills/qk-product-spec/SKILL.md +262 -0
- package/.agents/skills/qk-prompt-compiler/SKILL.md +444 -0
- package/.agents/skills/qk-ui-engineer/SKILL.md +286 -0
- package/.agents/workflows/_schema.yml +146 -146
- package/.agents/workflows/bug-resolution.yml +155 -121
- package/.agents/workflows/code-review.yml +127 -93
- package/.agents/workflows/context-discovery.yml +128 -94
- package/.agents/workflows/documentation.yml +124 -90
- package/.agents/workflows/feature-delivery.yml +158 -124
- package/.agents/workflows/production-release.yml +207 -173
- package/.agents/workflows/prompt-compilation.yml +126 -0
- package/.agents/workflows/refactor.yml +136 -102
- package/.agents/workflows/security-audit.yml +149 -115
- package/.agents/workflows/shared/quality-gate.yml +3 -1
- package/.agents/workflows/skin-governance.yml +149 -115
- package/.agents/workflows/spec-driven-development.yml +116 -87
- package/CHANGELOG.md +77 -0
- package/README.md +125 -205
- package/bin/install.js +324 -329
- package/package.json +68 -74
- package/tooling/build-registry.js +226 -208
- package/tooling/run-aar.js +55 -126
- package/tooling/sync-versions.js +2 -2
- package/tooling/validate-graph.js +100 -87
- package/tooling/validate-skills.js +32 -14
- package/.agents/README.md +0 -90
- package/.agents/docs/CHI_TIET_SKILLS.md +0 -126
- package/.agents/docs/HUONG_DAN_SU_DUNG.md +0 -120
- package/.agents/docs/MIGRATION-CLEANUP-V8.1.3.md +0 -36
- package/.agents/docs/MIGRATION-STATUS.md +0 -35
- package/.agents/docs/MIGRATION-V8.md +0 -10
- package/.agents/docs/ROADMAP-V8.2.md +0 -78
- package/.agents/docs/V8-CERTIFICATION.md +0 -27
- package/.agents/docs/decisions/ADR-001-v8-migration.md +0 -58
- package/.agents/docs/decisions/ADR-002-workflow-separation.md +0 -50
- package/.agents/docs/decisions/ADR-003-registry-generated.md +0 -54
- package/.agents/docs/decisions/ADR-008-skill-boundary-review.md +0 -27
- package/.agents/registry/capability-graph.yml +0 -390
- package/.agents/registry/skills-index.yml +0 -305
- package/.agents/skills/_template/capability.yaml +0 -34
- package/.agents/skills/_template/evals/scorecard.yaml +0 -19
- package/.agents/skills/qk-access-policy/SKILL.md +0 -206
- package/.agents/skills/qk-access-policy/capability.yaml +0 -23
- package/.agents/skills/qk-access-policy/evals/scorecard.yaml +0 -36
- package/.agents/skills/qk-agent-observability/SKILL.md +0 -108
- package/.agents/skills/qk-agent-observability/capability.yaml +0 -29
- package/.agents/skills/qk-agent-observability/evals/scorecard.yaml +0 -29
- package/.agents/skills/qk-agent-observability/references/scorecard.yaml +0 -80
- package/.agents/skills/qk-ai-builder/SKILL.md +0 -254
- package/.agents/skills/qk-ai-builder/capability.yaml +0 -23
- package/.agents/skills/qk-ai-builder/evals/scorecard.yaml +0 -30
- package/.agents/skills/qk-api-consumer/SKILL.md +0 -256
- package/.agents/skills/qk-api-consumer/capability.yaml +0 -21
- package/.agents/skills/qk-api-consumer/evals/scorecard.yaml +0 -29
- package/.agents/skills/qk-api-lifecycle/SKILL.md +0 -251
- package/.agents/skills/qk-api-lifecycle/capability.yaml +0 -23
- package/.agents/skills/qk-api-lifecycle/evals/scorecard.yaml +0 -29
- package/.agents/skills/qk-bug-resolution/capability.yaml +0 -25
- package/.agents/skills/qk-code-review/capability.yaml +0 -23
- package/.agents/skills/qk-context-loader/SKILL.md +0 -198
- package/.agents/skills/qk-context-loader/capability.yaml +0 -23
- package/.agents/skills/qk-context-loader/evals/scorecard.yaml +0 -28
- package/.agents/skills/qk-data-engineer/SKILL.md +0 -253
- package/.agents/skills/qk-data-lifecycle/SKILL.md +0 -197
- package/.agents/skills/qk-data-lifecycle/capability.yaml +0 -23
- package/.agents/skills/qk-data-lifecycle/evals/scorecard.yaml +0 -29
- package/.agents/skills/qk-db-optimizer/SKILL.md +0 -210
- package/.agents/skills/qk-db-optimizer/capability.yaml +0 -22
- package/.agents/skills/qk-db-optimizer/evals/scorecard.yaml +0 -28
- package/.agents/skills/qk-design-system-engineering/SKILL.md +0 -193
- package/.agents/skills/qk-design-system-engineering/capability.yaml +0 -25
- package/.agents/skills/qk-design-system-engineering/evals/scorecard.yaml +0 -27
- package/.agents/skills/qk-devops-platform/SKILL.md +0 -198
- package/.agents/skills/qk-devops-platform/capability.yaml +0 -29
- package/.agents/skills/qk-devops-platform/evals/scorecard.yaml +0 -28
- package/.agents/skills/qk-docs/SKILL.md +0 -193
- package/.agents/skills/qk-docs/capability.yaml +0 -23
- package/.agents/skills/qk-docs/evals/scorecard.yaml +0 -27
- package/.agents/skills/qk-engineering-standard/SKILL.md +0 -89
- package/.agents/skills/qk-engineering-standard/capability.yaml +0 -23
- package/.agents/skills/qk-engineering-standard/evals/scorecard.yaml +0 -28
- package/.agents/skills/qk-engineering-standard/references/anti-patterns.md +0 -121
- package/.agents/skills/qk-engineering-standard/rules/backend.md +0 -122
- package/.agents/skills/qk-engineering-standard/rules/database.md +0 -3
- package/.agents/skills/qk-engineering-standard/rules/frontend.md +0 -152
- package/.agents/skills/qk-engineering-standard/rules/security.md +0 -3
- package/.agents/skills/qk-engineering-standard/rules/testing.md +0 -3
- package/.agents/skills/qk-fe-api-integration/SKILL.md +0 -704
- package/.agents/skills/qk-fe-api-integration/capability.yaml +0 -21
- package/.agents/skills/qk-fe-api-integration/evals/scorecard.yaml +0 -29
- package/.agents/skills/qk-feature-delivery/capability.yaml +0 -24
- package/.agents/skills/qk-frontend-architecture/SKILL.md +0 -127
- package/.agents/skills/qk-frontend-architecture/capability.yaml +0 -28
- package/.agents/skills/qk-frontend-architecture/evals/scorecard.yaml +0 -28
- package/.agents/skills/qk-help/SKILL.md +0 -107
- package/.agents/skills/qk-help/capability.yaml +0 -20
- package/.agents/skills/qk-help/evals/scorecard.yaml +0 -13
- package/.agents/skills/qk-orchestrator/capability.yaml +0 -22
- package/.agents/skills/qk-product-specification/SKILL.md +0 -187
- package/.agents/skills/qk-product-specification/capability.yaml +0 -27
- package/.agents/skills/qk-product-specification/evals/scorecard.yaml +0 -27
- package/.agents/skills/qk-production-release/SKILL.md +0 -188
- package/.agents/skills/qk-production-release/capability.yaml +0 -27
- package/.agents/skills/qk-production-release/evals/scorecard.yaml +0 -28
- package/.agents/skills/qk-project-audit/SKILL.md +0 -174
- package/.agents/skills/qk-project-bootstrap/SKILL.md +0 -372
- package/.agents/skills/qk-project-bootstrap/capability.yaml +0 -23
- package/.agents/skills/qk-project-bootstrap/evals/scorecard.yaml +0 -28
- package/.agents/skills/qk-project-health/SKILL.md +0 -202
- package/.agents/skills/qk-project-health/capability.yaml +0 -23
- package/.agents/skills/qk-project-health/evals/scorecard.yaml +0 -27
- package/.agents/skills/qk-project-memory/SKILL.md +0 -303
- package/.agents/skills/qk-project-memory/capability.yaml +0 -23
- package/.agents/skills/qk-project-memory/evals/scorecard.yaml +0 -27
- package/.agents/skills/qk-refactor/SKILL.md +0 -243
- package/.agents/skills/qk-refactor/capability.yaml +0 -26
- package/.agents/skills/qk-refactor/evals/scorecard.yaml +0 -27
- package/.agents/skills/qk-security-audit/SKILL.md +0 -280
- package/.agents/skills/qk-security-audit/capability.yaml +0 -29
- package/.agents/skills/qk-security-audit/evals/scorecard.yaml +0 -27
- package/.agents/skills/qk-system-evolution/SKILL.md +0 -625
- package/.agents/skills/qk-system-evolution/capability.yaml +0 -24
- package/.agents/skills/qk-system-evolution/evals/scorecard.yaml +0 -26
- package/.agents/skills/qk-test-engineering/SKILL.md +0 -215
- package/.agents/skills/qk-test-engineering/capability.yaml +0 -28
- package/.agents/skills/qk-test-engineering/evals/scorecard.yaml +0 -26
- package/.agents/skills/qk-ui-audit/SKILL.md +0 -175
- package/.agents/skills/qk-ui-audit/capability.yaml +0 -23
- package/.agents/skills/qk-ui-audit/evals/scorecard.yaml +0 -26
- package/.agents/skills/qk-ui-audit/references/anti-slop-checklist.md +0 -136
- package/.agents/skills/qk-ui-builder/SKILL.md +0 -521
- package/.agents/skills/qk-ui-builder/capability.yaml +0 -29
- package/.agents/skills/qk-ui-builder/evals/scorecard.yaml +0 -26
- package/.agents/skills/qk-ui-builder/references/anti-patterns.md +0 -295
- package/.agents/skills/qk-ui-builder/references/color.md +0 -115
- package/.agents/skills/qk-ui-builder/references/component-cookbook.md +0 -458
- package/.agents/skills/qk-ui-builder/references/copy.md +0 -250
- package/.agents/skills/qk-ui-builder/references/interaction-and-states.md +0 -115
- package/.agents/skills/qk-ui-builder/references/layout-and-space.md +0 -111
- package/.agents/skills/qk-ui-builder/references/macrostructures/01-bento-grid.md +0 -48
- package/.agents/skills/qk-ui-builder/references/macrostructures/02-long-document.md +0 -50
- package/.agents/skills/qk-ui-builder/references/macrostructures/03-marquee-hero.md +0 -51
- package/.agents/skills/qk-ui-builder/references/macrostructures/04-stat-led.md +0 -49
- package/.agents/skills/qk-ui-builder/references/macrostructures/05-workbench.md +0 -44
- package/.agents/skills/qk-ui-builder/references/macrostructures/06-conversational-faq.md +0 -50
- package/.agents/skills/qk-ui-builder/references/macrostructures/07-manifesto.md +0 -51
- package/.agents/skills/qk-ui-builder/references/macrostructures/08-photographic.md +0 -50
- package/.agents/skills/qk-ui-builder/references/macrostructures/09-quote-led.md +0 -50
- package/.agents/skills/qk-ui-builder/references/macrostructures/11-catalogue.md +0 -49
- package/.agents/skills/qk-ui-builder/references/macrostructures/12-letter.md +0 -49
- package/.agents/skills/qk-ui-builder/references/macrostructures/13-index-first.md +0 -49
- package/.agents/skills/qk-ui-builder/references/macrostructures/14-narrative-workflow.md +0 -48
- package/.agents/skills/qk-ui-builder/references/macrostructures/15-split-studio.md +0 -48
- package/.agents/skills/qk-ui-builder/references/macrostructures/16-feature-stack.md +0 -51
- package/.agents/skills/qk-ui-builder/references/macrostructures/17-type-specimen.md +0 -48
- package/.agents/skills/qk-ui-builder/references/macrostructures/18-portfolio-grid.md +0 -48
- package/.agents/skills/qk-ui-builder/references/macrostructures/19-map-diagram.md +0 -50
- package/.agents/skills/qk-ui-builder/references/macrostructures/20-ecosystem-index.md +0 -48
- package/.agents/skills/qk-ui-builder/references/macrostructures/21-component-playground.md +0 -45
- package/.agents/skills/qk-ui-builder/references/macrostructures.md +0 -38
- package/.agents/skills/qk-ui-builder/references/motion.md +0 -95
- package/.agents/skills/qk-ui-builder/references/responsive.md +0 -115
- package/.agents/skills/qk-ui-builder/references/slop-test.md +0 -135
- package/.agents/skills/qk-ui-builder/references/structure.md +0 -280
- package/.agents/skills/qk-ui-builder/references/themes/atmospheric.md +0 -53
- package/.agents/skills/qk-ui-builder/references/themes/carnival.md +0 -52
- package/.agents/skills/qk-ui-builder/references/themes/cobalt.md +0 -52
- package/.agents/skills/qk-ui-builder/references/themes/editorial.md +0 -52
- package/.agents/skills/qk-ui-builder/references/themes/garden.md +0 -52
- package/.agents/skills/qk-ui-builder/references/themes/hum.md +0 -52
- package/.agents/skills/qk-ui-builder/references/themes/lumen.md +0 -52
- package/.agents/skills/qk-ui-builder/references/themes/midnight.md +0 -52
- package/.agents/skills/qk-ui-builder/references/themes/modern-minimal.md +0 -52
- package/.agents/skills/qk-ui-builder/references/themes/playful.md +0 -52
- package/.agents/skills/qk-ui-builder/references/themes/specimen.md +0 -52
- package/.agents/skills/qk-ui-builder/references/themes/terminal.md +0 -52
- package/.agents/skills/qk-ui-builder/references/typography.md +0 -129
- package/.agents/skills/qk-ui-system-builder/SKILL.md +0 -183
- package/.agents/skills/qk-ui-system-builder/capability.yaml +0 -25
- package/.agents/skills/qk-ui-system-builder/evals/scorecard.yaml +0 -26
- package/.agents/skills/qk-upgrade/SKILL.md +0 -301
- package/.agents/skills/qk-upgrade/capability.yaml +0 -24
- package/.agents/skills/qk-upgrade/evals/scorecard.yaml +0 -26
- package/.agents/skills/qk-validation-gate/SKILL.md +0 -88
- package/.agents/skills/qk-validation-gate/capability.yaml +0 -23
- package/.agents/skills/qk-validation-gate/evals/scorecard.yaml +0 -26
- package/.agents/skills/qk-web-quality-gate/SKILL.md +0 -197
- package/.agents/skills/qk-web-quality-gate/capability.yaml +0 -24
- package/.agents/skills/qk-web-quality-gate/evals/scorecard.yaml +0 -26
- package/.agents/workflows/research.yml +0 -75
- package/.agents/workflows/skill-evolution.yml +0 -97
- 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: []
|