ai-developer-skill-os 7.5.0 → 7.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/CHANGELOG.md +2 -1
- package/.agents/README.md +51 -10
- package/.agents/docs/CHI_TIET_SKILLS.md +2 -1
- package/.agents/skills/qk-orchestrator/SKILL.md +3 -2
- package/.agents/skills/qk-orchestrator/references/routing-table.md +3 -2
- package/.agents/skills/qk-project-bootstrap/SKILL.md +2 -1
- package/.agents/skills/qk-project-memory/SKILL.md +46 -0
- package/.agents/skills/qk-ui-audit/SKILL.md +3 -2
- package/.agents/skills/qk-ui-builder/SKILL.md +446 -0
- package/.agents/skills/qk-ui-builder/references/anti-patterns.md +295 -0
- package/.agents/skills/qk-ui-builder/references/color.md +115 -0
- package/.agents/skills/qk-ui-builder/references/component-cookbook.md +1194 -0
- package/.agents/skills/qk-ui-builder/references/copy.md +250 -0
- package/.agents/skills/qk-ui-builder/references/interaction-and-states.md +115 -0
- package/.agents/skills/qk-ui-builder/references/layout-and-space.md +111 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/01-bento-grid.md +48 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/02-long-document.md +50 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/03-marquee-hero.md +51 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/04-stat-led.md +49 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/05-workbench.md +44 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/06-conversational-faq.md +50 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/07-manifesto.md +51 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/08-photographic.md +50 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/09-quote-led.md +50 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/11-catalogue.md +49 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/12-letter.md +49 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/13-index-first.md +49 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/14-narrative-workflow.md +48 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/15-split-studio.md +48 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/16-feature-stack.md +51 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/17-type-specimen.md +48 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/18-portfolio-grid.md +48 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/19-map-diagram.md +50 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/20-ecosystem-index.md +48 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures/21-component-playground.md +45 -0
- package/.agents/skills/qk-ui-builder/references/macrostructures.md +38 -0
- package/.agents/skills/qk-ui-builder/references/motion.md +95 -0
- package/.agents/skills/qk-ui-builder/references/responsive.md +115 -0
- package/.agents/skills/qk-ui-builder/references/slop-test.md +135 -0
- package/.agents/skills/qk-ui-builder/references/structure.md +280 -0
- package/.agents/skills/qk-ui-builder/references/themes/atmospheric.md +53 -0
- package/.agents/skills/qk-ui-builder/references/themes/carnival.md +52 -0
- package/.agents/skills/qk-ui-builder/references/themes/cobalt.md +52 -0
- package/.agents/skills/qk-ui-builder/references/themes/editorial.md +52 -0
- package/.agents/skills/qk-ui-builder/references/themes/garden.md +52 -0
- package/.agents/skills/qk-ui-builder/references/themes/hum.md +52 -0
- package/.agents/skills/qk-ui-builder/references/themes/lumen.md +52 -0
- package/.agents/skills/qk-ui-builder/references/themes/midnight.md +52 -0
- package/.agents/skills/qk-ui-builder/references/themes/modern-minimal.md +52 -0
- package/.agents/skills/qk-ui-builder/references/themes/playful.md +52 -0
- package/.agents/skills/qk-ui-builder/references/themes/specimen.md +52 -0
- package/.agents/skills/qk-ui-builder/references/themes/terminal.md +52 -0
- package/.agents/skills/qk-ui-builder/references/typography.md +129 -0
- package/.agents/skills.json +4 -4
- package/CHANGELOG.md +2 -1
- package/README.md +36 -16
- package/bin/lint.js +3 -2
- package/docs/CHI_TIET_SKILLS.md +2 -1
- package/framework/decision-primitives.md +2 -1
- package/package.json +2 -2
- package/skills/_template/SKILL.md +2 -1
- package/skills/qk-access-policy/SKILL.md +3 -2
- package/skills/qk-ai-builder/SKILL.md +3 -2
- package/skills/qk-api-lifecycle/SKILL.md +3 -2
- package/skills/qk-bug-resolution/SKILL.md +3 -2
- package/skills/qk-context-loader/SKILL.md +13 -12
- package/skills/qk-data-lifecycle/SKILL.md +3 -2
- package/skills/qk-db-optimizer/SKILL.md +3 -2
- package/skills/qk-docs/SKILL.md +3 -2
- package/skills/qk-engineering-standard/SKILL.md +19 -18
- package/skills/qk-fe-api-integration/SKILL.md +3 -2
- package/skills/qk-feature-delivery/SKILL.md +3 -2
- package/skills/qk-help/SKILL.md +3 -2
- package/skills/qk-orchestrator/SKILL.md +18 -16
- package/skills/qk-orchestrator/references/routing-table.md +3 -2
- package/skills/qk-production-release/SKILL.md +15 -14
- package/skills/qk-project-bootstrap/SKILL.md +5 -3
- package/skills/qk-project-health/SKILL.md +3 -2
- package/skills/qk-project-memory/SKILL.md +49 -2
- package/skills/qk-system-evolution/SKILL.md +16 -15
- package/skills/qk-ui-audit/SKILL.md +21 -19
- package/skills/qk-ui-builder/SKILL.md +447 -0
- package/skills/qk-ui-builder/references/anti-patterns.md +295 -0
- package/skills/qk-ui-builder/references/color.md +115 -0
- package/skills/qk-ui-builder/references/component-cookbook.md +1194 -0
- package/skills/qk-ui-builder/references/copy.md +250 -0
- package/skills/qk-ui-builder/references/interaction-and-states.md +115 -0
- package/skills/qk-ui-builder/references/layout-and-space.md +111 -0
- package/skills/qk-ui-builder/references/macrostructures/01-bento-grid.md +48 -0
- package/skills/qk-ui-builder/references/macrostructures/02-long-document.md +50 -0
- package/skills/qk-ui-builder/references/macrostructures/03-marquee-hero.md +51 -0
- package/skills/qk-ui-builder/references/macrostructures/04-stat-led.md +49 -0
- package/skills/qk-ui-builder/references/macrostructures/05-workbench.md +44 -0
- package/skills/qk-ui-builder/references/macrostructures/06-conversational-faq.md +50 -0
- package/skills/qk-ui-builder/references/macrostructures/07-manifesto.md +51 -0
- package/skills/qk-ui-builder/references/macrostructures/08-photographic.md +50 -0
- package/skills/qk-ui-builder/references/macrostructures/09-quote-led.md +50 -0
- package/skills/qk-ui-builder/references/macrostructures/11-catalogue.md +49 -0
- package/skills/qk-ui-builder/references/macrostructures/12-letter.md +49 -0
- package/skills/qk-ui-builder/references/macrostructures/13-index-first.md +49 -0
- package/skills/qk-ui-builder/references/macrostructures/14-narrative-workflow.md +48 -0
- package/skills/qk-ui-builder/references/macrostructures/15-split-studio.md +48 -0
- package/skills/qk-ui-builder/references/macrostructures/16-feature-stack.md +51 -0
- package/skills/qk-ui-builder/references/macrostructures/17-type-specimen.md +48 -0
- package/skills/qk-ui-builder/references/macrostructures/18-portfolio-grid.md +48 -0
- package/skills/qk-ui-builder/references/macrostructures/19-map-diagram.md +50 -0
- package/skills/qk-ui-builder/references/macrostructures/20-ecosystem-index.md +48 -0
- package/skills/qk-ui-builder/references/macrostructures/21-component-playground.md +45 -0
- package/skills/qk-ui-builder/references/macrostructures.md +38 -0
- package/skills/qk-ui-builder/references/motion.md +95 -0
- package/skills/qk-ui-builder/references/responsive.md +115 -0
- package/skills/qk-ui-builder/references/slop-test.md +135 -0
- package/skills/qk-ui-builder/references/structure.md +280 -0
- package/skills/qk-ui-builder/references/themes/atmospheric.md +53 -0
- package/skills/qk-ui-builder/references/themes/carnival.md +52 -0
- package/skills/qk-ui-builder/references/themes/cobalt.md +52 -0
- package/skills/qk-ui-builder/references/themes/editorial.md +52 -0
- package/skills/qk-ui-builder/references/themes/garden.md +52 -0
- package/skills/qk-ui-builder/references/themes/hum.md +52 -0
- package/skills/qk-ui-builder/references/themes/lumen.md +52 -0
- package/skills/qk-ui-builder/references/themes/midnight.md +52 -0
- package/skills/qk-ui-builder/references/themes/modern-minimal.md +52 -0
- package/skills/qk-ui-builder/references/themes/playful.md +52 -0
- package/skills/qk-ui-builder/references/themes/specimen.md +52 -0
- package/skills/qk-ui-builder/references/themes/terminal.md +52 -0
- package/skills/qk-ui-builder/references/typography.md +129 -0
- package/skills/qk-ui-system-builder/SKILL.md +3 -2
- package/skills/qk-validation-gate/SKILL.md +18 -17
- package/skills.json +28 -27
- package/.agents/_template/BEHAVIOR_SPEC.md +0 -96
- package/.agents/_template/examples/example-en.md +0 -49
- package/.agents/_template/examples/example-vi.md +0 -49
- package/.agents/skills/qk-design-to-code/SKILL.md +0 -285
- package/.qk-ai-skill-os/CHANGELOG.md +0 -69
- package/.qk-ai-skill-os/LICENSE +0 -21
- package/.qk-ai-skill-os/README.md +0 -59
- package/.qk-ai-skill-os/_template/BEHAVIOR_SPEC.md +0 -96
- package/.qk-ai-skill-os/_template/examples/example-en.md +0 -49
- package/.qk-ai-skill-os/_template/examples/example-vi.md +0 -49
- package/.qk-ai-skill-os/docs/CHI_TIET_SKILLS.md +0 -125
- package/.qk-ai-skill-os/docs/GOVERNANCE.md +0 -40
- package/.qk-ai-skill-os/docs/HUONG_DAN_SU_DUNG.md +0 -120
- package/.qk-ai-skill-os/docs/SPEC.md +0 -87
- package/.qk-ai-skill-os/docs/adr/0001-intent-based-architecture.md +0 -19
- package/.qk-ai-skill-os/docs/adr/0002-kernel-freeze.md +0 -21
- package/.qk-ai-skill-os/docs/adr/0003-risk-based-verification.md +0 -20
- package/.qk-ai-skill-os/docs/adr/0004-progressive-evidence.md +0 -19
- package/.qk-ai-skill-os/docs/skill-classification.md +0 -25
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-accessibility-audit/SKILL.md +0 -121
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-agent-orchestrator/SKILL.md +0 -179
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-api-integration/SKILL.md +0 -389
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-auth-security/SKILL.md +0 -96
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-backend-architecture/SKILL.md +0 -125
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-bug-fix/SKILL.md +0 -213
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-component-generator/SKILL.md +0 -136
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-context-manager/SKILL.md +0 -175
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-database-engineer/SKILL.md +0 -104
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-deployment/SKILL.md +0 -96
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-design-system/SKILL.md +0 -137
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-form-builder/SKILL.md +0 -140
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-frontend-architecture/SKILL.md +0 -155
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-frontend-debug/SKILL.md +0 -133
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-frontend-performance/SKILL.md +0 -129
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-frontend-testing/SKILL.md +0 -146
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-git-engineer/SKILL.md +0 -304
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-help/SKILL.md +0 -68
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-migration/SKILL.md +0 -284
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-project-audit/SKILL.md +0 -280
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-refactor/SKILL.md +0 -222
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-state-management/SKILL.md +0 -140
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-table-crud-generator/SKILL.md +0 -127
- package/.qk-ai-skill-os/skills/_archive_old_skills/qk-ui-builder/SKILL.md +0 -152
- package/.qk-ai-skill-os/skills/_template/SKILL.md +0 -238
- package/.qk-ai-skill-os/skills/qk-access-policy/SKILL.md +0 -179
- package/.qk-ai-skill-os/skills/qk-ai-builder/SKILL.md +0 -221
- package/.qk-ai-skill-os/skills/qk-api-lifecycle/SKILL.md +0 -176
- package/.qk-ai-skill-os/skills/qk-bug-resolution/SKILL.md +0 -307
- package/.qk-ai-skill-os/skills/qk-context-loader/SKILL.md +0 -218
- package/.qk-ai-skill-os/skills/qk-data-lifecycle/SKILL.md +0 -192
- package/.qk-ai-skill-os/skills/qk-db-optimizer/SKILL.md +0 -196
- package/.qk-ai-skill-os/skills/qk-design-to-code/SKILL.md +0 -291
- package/.qk-ai-skill-os/skills/qk-docs/SKILL.md +0 -198
- package/.qk-ai-skill-os/skills/qk-engineering-standard/SKILL.md +0 -351
- package/.qk-ai-skill-os/skills/qk-engineering-standard/rules/backend.md +0 -122
- package/.qk-ai-skill-os/skills/qk-engineering-standard/rules/database.md +0 -3
- package/.qk-ai-skill-os/skills/qk-engineering-standard/rules/frontend.md +0 -152
- package/.qk-ai-skill-os/skills/qk-engineering-standard/rules/security.md +0 -3
- package/.qk-ai-skill-os/skills/qk-engineering-standard/rules/testing.md +0 -3
- package/.qk-ai-skill-os/skills/qk-fe-api-integration/SKILL.md +0 -326
- package/.qk-ai-skill-os/skills/qk-feature-delivery/SKILL.md +0 -305
- package/.qk-ai-skill-os/skills/qk-help/SKILL.md +0 -193
- package/.qk-ai-skill-os/skills/qk-orchestrator/SKILL.md +0 -277
- package/.qk-ai-skill-os/skills/qk-orchestrator/references/routing-table.md +0 -77
- package/.qk-ai-skill-os/skills/qk-production-release/SKILL.md +0 -290
- package/.qk-ai-skill-os/skills/qk-project-bootstrap/SKILL.md +0 -240
- package/.qk-ai-skill-os/skills/qk-project-health/SKILL.md +0 -199
- package/.qk-ai-skill-os/skills/qk-project-memory/SKILL.md +0 -172
- package/.qk-ai-skill-os/skills/qk-system-evolution/SKILL.md +0 -285
- package/.qk-ai-skill-os/skills/qk-ui-audit/SKILL.md +0 -314
- package/.qk-ai-skill-os/skills/qk-ui-audit/references/anti-slop-checklist.md +0 -136
- package/.qk-ai-skill-os/skills/qk-ui-system-builder/SKILL.md +0 -225
- package/.qk-ai-skill-os/skills/qk-validation-gate/SKILL.md +0 -361
- package/.qk-ai-skill-os/skills.json +0 -819
- package/skills/qk-design-to-code/SKILL.md +0 -285
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Theme: Modern Minimal
|
|
2
|
+
|
|
3
|
+
**Genre:** modern-minimal
|
|
4
|
+
**Use case:** SaaS, startups, portfolios
|
|
5
|
+
|
|
6
|
+
## Axes
|
|
7
|
+
|
|
8
|
+
| Axis | Value |
|
|
9
|
+
|------|-------|
|
|
10
|
+
| Paper band | mid (30–85% lightness) |
|
|
11
|
+
| Display style | geometric-sans |
|
|
12
|
+
| Accent hue | neutral |
|
|
13
|
+
|
|
14
|
+
## Token Overrides
|
|
15
|
+
|
|
16
|
+
```css
|
|
17
|
+
:root {
|
|
18
|
+
--color-background: hsl(220, 15%, 98%);
|
|
19
|
+
--color-surface: hsl(220, 15%, 100%);
|
|
20
|
+
--color-text: hsl(220, 20%, 12%);
|
|
21
|
+
--color-text-muted: hsl(220, 10%, 50%);
|
|
22
|
+
--color-accent: hsl(220, 15%, 45%);
|
|
23
|
+
--color-accent-hover: hsl(220, 15%, 38%);
|
|
24
|
+
--font-display: 'Inter', 'Helvetica Neue', sans-serif;
|
|
25
|
+
--font-body: 'Inter', 'Helvetica Neue', sans-serif;
|
|
26
|
+
--radius-sm: 6px;
|
|
27
|
+
--radius-md: 8px;
|
|
28
|
+
--shadow-sm: 0 1px 2px hsl(220, 15%, 90%);
|
|
29
|
+
--shadow-md: 0 4px 12px hsl(220, 15%, 90%);
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Macrostructure Affinity
|
|
34
|
+
|
|
35
|
+
- ✅ Workbench
|
|
36
|
+
- ✅ Stat-Led
|
|
37
|
+
- ✅ Index-First
|
|
38
|
+
- ❌ Marquee Hero (too noisy)
|
|
39
|
+
- ❌ Manifesto (too expressive)
|
|
40
|
+
|
|
41
|
+
## Anti-Patterns (Modern Minimal-specific)
|
|
42
|
+
|
|
43
|
+
- ❌ Decorative illustrations
|
|
44
|
+
- ❌ Gradient buttons or backgrounds
|
|
45
|
+
- ❌ More than 2 font families
|
|
46
|
+
- ❌ Heavy drop shadows
|
|
47
|
+
|
|
48
|
+
## Voice
|
|
49
|
+
|
|
50
|
+
- Single-word actions: "Sign in", "Pricing", "Docs"
|
|
51
|
+
- No decorative copy
|
|
52
|
+
- Metrics and social proof prominent
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Theme: Playful
|
|
2
|
+
|
|
3
|
+
**Genre:** playful
|
|
4
|
+
**Use case:** games, kids, entertainment
|
|
5
|
+
|
|
6
|
+
## Axes
|
|
7
|
+
|
|
8
|
+
| Axis | Value |
|
|
9
|
+
|------|-------|
|
|
10
|
+
| Paper band | light (85–100% lightness) |
|
|
11
|
+
| Display style | rounded-sans |
|
|
12
|
+
| Accent hue | warm (30–60°) |
|
|
13
|
+
|
|
14
|
+
## Token Overrides
|
|
15
|
+
|
|
16
|
+
```css
|
|
17
|
+
:root {
|
|
18
|
+
--color-background: hsl(45, 60%, 97%);
|
|
19
|
+
--color-surface: hsl(45, 60%, 100%);
|
|
20
|
+
--color-text: hsl(45, 50%, 12%);
|
|
21
|
+
--color-text-muted: hsl(45, 20%, 45%);
|
|
22
|
+
--color-accent: hsl(35, 85%, 55%);
|
|
23
|
+
--color-accent-hover: hsl(35, 85%, 48%);
|
|
24
|
+
--font-display: 'Nunito', 'Varela Round', sans-serif;
|
|
25
|
+
--font-body: 'Nunito', 'Varela Round', sans-serif;
|
|
26
|
+
--radius-sm: 12px;
|
|
27
|
+
--radius-md: 16px;
|
|
28
|
+
--shadow-sm: 0 2px 4px hsl(45, 60%, 85%);
|
|
29
|
+
--shadow-md: 0 6px 16px hsl(45, 60%, 85%);
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Macrostructure Affinity
|
|
34
|
+
|
|
35
|
+
- ✅ Bento Grid
|
|
36
|
+
- ✅ Marquee Hero
|
|
37
|
+
- ✅ Feature Stack
|
|
38
|
+
- ❌ Long Document (too text-heavy)
|
|
39
|
+
- ❌ Quote-Led (too serious)
|
|
40
|
+
|
|
41
|
+
## Anti-Patterns (Playful-specific)
|
|
42
|
+
|
|
43
|
+
- ❌ Serious or corporate tones
|
|
44
|
+
- ❌ Monochrome palettes
|
|
45
|
+
- ❌ Minimal whitespace (dense layouts)
|
|
46
|
+
- ❌ Sharp corners or rigid grids
|
|
47
|
+
|
|
48
|
+
## Voice
|
|
49
|
+
|
|
50
|
+
- Exclamation marks and emoji allowed
|
|
51
|
+
- Action verbs: "Play", "Join", "Explore"
|
|
52
|
+
- Friendly, inclusive language
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Theme: Specimen
|
|
2
|
+
|
|
3
|
+
**Genre:** editorial
|
|
4
|
+
**Use case:** design systems, documentation
|
|
5
|
+
|
|
6
|
+
## Axes
|
|
7
|
+
|
|
8
|
+
| Axis | Value |
|
|
9
|
+
|------|-------|
|
|
10
|
+
| Paper band | mid (30–85% lightness) |
|
|
11
|
+
| Display style | high-contrast-serif |
|
|
12
|
+
| Accent hue | neutral |
|
|
13
|
+
|
|
14
|
+
## Token Overrides
|
|
15
|
+
|
|
16
|
+
```css
|
|
17
|
+
:root {
|
|
18
|
+
--color-background: hsl(40, 10%, 96%);
|
|
19
|
+
--color-surface: hsl(40, 10%, 100%);
|
|
20
|
+
--color-text: hsl(40, 15%, 8%);
|
|
21
|
+
--color-text-muted: hsl(40, 5%, 45%);
|
|
22
|
+
--color-accent: hsl(40, 5%, 45%);
|
|
23
|
+
--color-accent-hover: hsl(40, 5%, 38%);
|
|
24
|
+
--font-display: 'Playfair Display', Georgia, serif;
|
|
25
|
+
--font-body: 'Source Sans 3', 'Helvetica Neue', sans-serif;
|
|
26
|
+
--radius-sm: 4px;
|
|
27
|
+
--radius-md: 4px;
|
|
28
|
+
--shadow-sm: 0 1px 2px hsl(40, 15%, 90%);
|
|
29
|
+
--shadow-md: 0 4px 12px hsl(40, 15%, 90%);
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Macrostructure Affinity
|
|
34
|
+
|
|
35
|
+
- ✅ Type Specimen
|
|
36
|
+
- ✅ Index-First
|
|
37
|
+
- ✅ Component Playground
|
|
38
|
+
- ❌ Marquee Hero (too playful)
|
|
39
|
+
- ❌ Bento Grid (too casual)
|
|
40
|
+
|
|
41
|
+
## Anti-Patterns (Specimen-specific)
|
|
42
|
+
|
|
43
|
+
- ❌ Playful illustrations or mascots
|
|
44
|
+
- ❌ Warm saturated accents (orange, coral)
|
|
45
|
+
- ❌ Rounded corners > 4px
|
|
46
|
+
- ❌ Gradient hero backgrounds
|
|
47
|
+
|
|
48
|
+
## Voice
|
|
49
|
+
|
|
50
|
+
- Typographic precision: "Style guide", "Type scale", "Spacing rhythm"
|
|
51
|
+
- Noun-first labels: "Design tokens", "Component states"
|
|
52
|
+
- Neutral, authoritative tone
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Theme: Terminal
|
|
2
|
+
|
|
3
|
+
**Genre:** tech
|
|
4
|
+
**Use case:** CLI tools, developer tools, terminals
|
|
5
|
+
|
|
6
|
+
## Axes
|
|
7
|
+
|
|
8
|
+
| Axis | Value |
|
|
9
|
+
|------|-------|
|
|
10
|
+
| Paper band | dark (0–30% lightness) |
|
|
11
|
+
| Display style | mono |
|
|
12
|
+
| Accent hue | phosphor green (120–150°) |
|
|
13
|
+
|
|
14
|
+
## Token Overrides
|
|
15
|
+
|
|
16
|
+
```css
|
|
17
|
+
:root {
|
|
18
|
+
--color-background: hsl(220, 15%, 4%);
|
|
19
|
+
--color-surface: hsl(220, 15%, 8%);
|
|
20
|
+
--color-text: hsl(120, 30%, 75%);
|
|
21
|
+
--color-text-muted: hsl(120, 10%, 45%);
|
|
22
|
+
--color-accent: hsl(120, 60%, 55%);
|
|
23
|
+
--color-accent-hover: hsl(120, 60%, 48%);
|
|
24
|
+
--font-display: 'JetBrains Mono', 'Fira Code', monospace;
|
|
25
|
+
--font-body: 'JetBrains Mono', 'Fira Code', monospace;
|
|
26
|
+
--radius-sm: 0px;
|
|
27
|
+
--radius-md: 0px;
|
|
28
|
+
--shadow-sm: none;
|
|
29
|
+
--shadow-md: none;
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Macrostructure Affinity
|
|
34
|
+
|
|
35
|
+
- ✅ Workbench
|
|
36
|
+
- ✅ Component Playground
|
|
37
|
+
- ✅ Stat-Led
|
|
38
|
+
- ❌ Manifesto (too expressive)
|
|
39
|
+
- ❌ Photographic (too visual)
|
|
40
|
+
|
|
41
|
+
## Anti-Patterns (Terminal-specific)
|
|
42
|
+
|
|
43
|
+
- ❌ Serif or display fonts
|
|
44
|
+
- ❌ Warm accent hues
|
|
45
|
+
- ❌ Decorative shadows or borders
|
|
46
|
+
- ❌ Smooth transitions/animations
|
|
47
|
+
|
|
48
|
+
## Voice
|
|
49
|
+
|
|
50
|
+
- Command-line syntax: `$ npm install`, `> init()`
|
|
51
|
+
- Terse, imperative: "Run", "Deploy", "Configure"
|
|
52
|
+
- Status codes and badges
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
# Typography
|
|
2
|
+
|
|
3
|
+
Foundational rules for font selection, type scale, and textual hierarchy. These rules exist to guarantee readable, professional, and consistent type across every generated UI.
|
|
4
|
+
|
|
5
|
+
## The 2+1 Rule
|
|
6
|
+
|
|
7
|
+
Use **at most 2 font families + 1 monospace** per project. Exceeding this causes visual noise and slows load time.
|
|
8
|
+
|
|
9
|
+
- **Display / Heading family** (1): used for titles, hero text.
|
|
10
|
+
- **Body / UI family** (1): used for paragraphs, labels, controls.
|
|
11
|
+
- **Monospace** (1, optional): used for code, IDs, numeric tables, logs.
|
|
12
|
+
|
|
13
|
+
```css
|
|
14
|
+
:root {
|
|
15
|
+
--font-display: "Playfair Display", Georgia, serif;
|
|
16
|
+
--font-body: "Inter", system-ui, sans-serif;
|
|
17
|
+
--font-mono: "JetBrains Mono", ui-monospace, monospace;
|
|
18
|
+
}
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
If you only need one family, the body family can double as the display family. Do not introduce a third decorative family.
|
|
22
|
+
|
|
23
|
+
## Font Catalog
|
|
24
|
+
|
|
25
|
+
Pick from this approved catalog. Prefer fonts that share the same optical quality and load reliably via Google Fonts or system fallbacks.
|
|
26
|
+
|
|
27
|
+
| Family | Role | Notes |
|
|
28
|
+
| --- | --- | --- |
|
|
29
|
+
| Inter | Body / UI | Neutral, legible at small sizes. Default choice. |
|
|
30
|
+
| Source Serif 4 | Display / Body | Serif companion to Inter; good for reading-heavy UI. |
|
|
31
|
+
| Playfair Display | Display | High-contrast serif for hero/editorial headings. |
|
|
32
|
+
| JetBrains Mono | Mono | Developer-friendly monospace. |
|
|
33
|
+
| Poppins | Display / UI | Geometric, friendly; use sparingly. |
|
|
34
|
+
| Roboto / Roboto Flex | Body / UI | Safe system-adjacent alternative. |
|
|
35
|
+
| IBM Plex Sans / Mono | Body / Mono | Corporate, consistent pairing. |
|
|
36
|
+
|
|
37
|
+
Pairing examples that work:
|
|
38
|
+
- **Inter + Playfair Display + JetBrains Mono** (editorial + code)
|
|
39
|
+
- **Inter + Source Serif 4 + JetBrains Mono** (clean + reading)
|
|
40
|
+
- **Poppins + Inter + JetBrains Mono** (friendly branding)
|
|
41
|
+
|
|
42
|
+
## Type Scale
|
|
43
|
+
|
|
44
|
+
Use only these sizes. Do not invent intermediate sizes.
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
12px caption / meta
|
|
48
|
+
14px small text / secondary
|
|
49
|
+
16px body (base)
|
|
50
|
+
18px lead / intro paragraph
|
|
51
|
+
24px h3 / section title
|
|
52
|
+
32px h2 / page title
|
|
53
|
+
48px h1 / hero
|
|
54
|
+
64px display / marketing hero
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
```css
|
|
58
|
+
:root {
|
|
59
|
+
--text-xs: 0.75rem; /* 12px */
|
|
60
|
+
--text-sm: 0.875rem; /* 14px */
|
|
61
|
+
--text-base: 1rem; /* 16px */
|
|
62
|
+
--text-lg: 1.125rem; /* 18px */
|
|
63
|
+
--text-xl: 1.5rem; /* 24px */
|
|
64
|
+
--text-2xl: 2rem; /* 32px */
|
|
65
|
+
--text-3xl: 3rem; /* 48px */
|
|
66
|
+
--text-4xl: 4rem; /* 64px */
|
|
67
|
+
}
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Line Height
|
|
71
|
+
|
|
72
|
+
| Content | Line height |
|
|
73
|
+
| --- | --- |
|
|
74
|
+
| Body text | **1.5** |
|
|
75
|
+
| Headings (h1–h3) | **1.2** |
|
|
76
|
+
| Tight display (64px) | 1.1 |
|
|
77
|
+
|
|
78
|
+
```css
|
|
79
|
+
p, li, label { line-height: 1.5; }
|
|
80
|
+
h1, h2, h3 { line-height: 1.2; }
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## Hierarchy
|
|
84
|
+
|
|
85
|
+
Establish hierarchy with **size + weight + color**, not decoration.
|
|
86
|
+
|
|
87
|
+
```css
|
|
88
|
+
h1 { font-family: var(--font-display); font-size: var(--text-3xl); font-weight: 700; }
|
|
89
|
+
h2 { font-family: var(--font-display); font-size: var(--text-2xl); font-weight: 600; }
|
|
90
|
+
h3 { font-family: var(--font-body); font-size: var(--text-xl); font-weight: 600; }
|
|
91
|
+
body { font-family: var(--font-body); font-size: var(--text-base); font-weight: 400; }
|
|
92
|
+
.meta { font-size: var(--text-sm); color: var(--color-text-muted); }
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
Keep weight range tight: 400 (body), 500/600 (emphasis), 700 (headings). Avoid 900 unless for a single display word.
|
|
96
|
+
|
|
97
|
+
## Prose Measure
|
|
98
|
+
|
|
99
|
+
Constrain reading width for paragraphs to **45–75 characters** (`ch`).
|
|
100
|
+
|
|
101
|
+
```css
|
|
102
|
+
.prose {
|
|
103
|
+
max-width: 65ch;
|
|
104
|
+
font-size: var(--text-base);
|
|
105
|
+
line-height: 1.5;
|
|
106
|
+
}
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
For multi-column or card text, keep each text block within this measure. Never let body copy stretch across a full 1200px container.
|
|
110
|
+
|
|
111
|
+
## Ban List
|
|
112
|
+
|
|
113
|
+
Do **not** use these as an identity or UI font:
|
|
114
|
+
|
|
115
|
+
- Comic Sans
|
|
116
|
+
- Papyrus
|
|
117
|
+
- Bradley Hand
|
|
118
|
+
- Any `cursive` generic family used as a primary brand font
|
|
119
|
+
- Other "novelty" fonts that undermine legibility
|
|
120
|
+
|
|
121
|
+
System fallbacks (`system-ui`, `sans-serif`, `serif`, `monospace`) are allowed only as graceful degradation, never as the chosen aesthetic.
|
|
122
|
+
|
|
123
|
+
## Practical Checklist
|
|
124
|
+
|
|
125
|
+
- [ ] At most 2 families + 1 mono.
|
|
126
|
+
- [ ] Sizes only from the 8-step scale.
|
|
127
|
+
- [ ] Body line-height 1.5, headings 1.2.
|
|
128
|
+
- [ ] Prose capped at 65ch.
|
|
129
|
+
- [ ] No banned novelty fonts.
|
package/.agents/skills.json
CHANGED
|
@@ -256,8 +256,8 @@
|
|
|
256
256
|
"description": "Tối ưu hóa Database (đánh Index, xử lý N+1 Queries, Slow Queries)."
|
|
257
257
|
},
|
|
258
258
|
{
|
|
259
|
-
"name": "qk-
|
|
260
|
-
"path": "skills/qk-
|
|
259
|
+
"name": "qk-ui-builder",
|
|
260
|
+
"path": "skills/qk-ui-builder/SKILL.md",
|
|
261
261
|
"version": "7.5.0",
|
|
262
262
|
"category": "frontend",
|
|
263
263
|
"subcategory": "visual",
|
|
@@ -783,7 +783,7 @@
|
|
|
783
783
|
"qk-api-lifecycle",
|
|
784
784
|
"qk-data-lifecycle",
|
|
785
785
|
"qk-db-optimizer",
|
|
786
|
-
"qk-
|
|
786
|
+
"qk-ui-builder",
|
|
787
787
|
"qk-feature-delivery",
|
|
788
788
|
"qk-project-bootstrap",
|
|
789
789
|
"qk-ui-system-builder",
|
|
@@ -816,4 +816,4 @@
|
|
|
816
816
|
"readySkills": 23,
|
|
817
817
|
"archivedSkills": 22
|
|
818
818
|
}
|
|
819
|
-
}
|
|
819
|
+
}
|
package/CHANGELOG.md
CHANGED
|
@@ -14,7 +14,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
14
14
|
|
|
15
15
|
### Changed (The "Anti-Slop & Zero-Trust" Architecture Upgrade)
|
|
16
16
|
- **Zero-Trust Logic**: Core logic skills (`qk-context-loader`, `qk-orchestrator`, `qk-feature-delivery`) now mandate a Topological Context Graph prior to any code generation.
|
|
17
|
-
- **Strict Design Contract**: Frontend skills (`qk-ui-system-builder`, `qk-
|
|
17
|
+
- **Strict Design Contract**: Frontend skills (`qk-ui-system-builder`, `qk-ui-builder`, `qk-ui-audit`) now explicitly reject generic styling (slop) and enforce strict token matching against a mandated `DESIGN.md`.
|
|
18
18
|
- **Repair Loop Enforcement**: `qk-bug-resolution` updated to strictly prohibit jumping to fixes without explicitly establishing an `Observe -> Hypothesis -> Evidence` chain.
|
|
19
19
|
- **Contract-First APIs**: `qk-api-lifecycle` now requires explicit OpenAPI/Swagger definitions prior to endpoint implementation.
|
|
20
20
|
- **Upgraded Testing Framework**: Fixed regex and validation logic in `behavior-conformance.test.js` to rigorously support YAML array strings and precise V7 markdown constraints. All 22 skills bumped to `v7.0.0`.
|
|
@@ -67,3 +67,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
67
67
|
- Added detailed user documentation in `docs/HUONG_DAN_SU_DUNG.md` and `docs/CHI_TIET_SKILLS.md`.
|
|
68
68
|
- Translated all skill frontmatter descriptions to Vietnamese for better UX in agent terminals.
|
|
69
69
|
- Included generic English and Vietnamese usage examples in `_template/examples/`.
|
|
70
|
+
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
# 🚀 AI Developer Skill OS (ai-developer-skill-os) v7.
|
|
1
|
+
# 🚀 AI Developer Skill OS (ai-developer-skill-os) v7.5.1
|
|
2
2
|
|
|
3
|
-
> **
|
|
3
|
+
> **v7.5.1 "Anti-Slop & Zero-Trust Architecture"**
|
|
4
4
|
|
|
5
5
|
Hệ sinh thái AI Developer Skill OS đã được tái cấu trúc hoàn toàn. Thay vì cung cấp các "công cụ rời rạc" (Toolbox), phiên bản V7 được thiết kế như một **Hệ điều hành khép kín, hoạt động theo kỷ luật của một Kiến trúc sư Hệ thống (50 năm kinh nghiệm)**.
|
|
6
6
|
|
|
@@ -25,7 +25,7 @@ Bảo vệ mã nguồn khỏi thói quen "sửa vội" của AI. Lỗi bắt bu
|
|
|
25
25
|
|
|
26
26
|
Các kỹ năng được quản lý cực kỳ chặt chẽ với bài kiểm tra tự động (Vitest) để đảm bảo tính nhất quán của luật lệ:
|
|
27
27
|
- **Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-access-policy`
|
|
28
|
-
- **Engineering / Dev:** `qk-feature-delivery`, `qk-api-lifecycle`, `qk-fe-api-integration`, `qk-data-lifecycle`, `qk-
|
|
28
|
+
- **Engineering / Dev:** `qk-feature-delivery`, `qk-api-lifecycle`, `qk-fe-api-integration`, `qk-data-lifecycle`, `qk-ui-builder`, `qk-ui-system-builder`
|
|
29
29
|
- **Validation & Standards:** `qk-validation-gate`, `qk-engineering-standard`, `qk-ui-audit`, `qk-project-health`, `qk-bug-resolution`
|
|
30
30
|
- **Ops & AI:** `qk-system-evolution`, `qk-production-release`, `qk-ai-builder`, `qk-project-bootstrap`
|
|
31
31
|
- **Docs & Utils:** `qk-docs`, `qk-project-memory`, `qk-help`, `qk-db-optimizer`
|
|
@@ -34,40 +34,58 @@ Các kỹ năng được quản lý cực kỳ chặt chẽ với bài kiểm tr
|
|
|
34
34
|
|
|
35
35
|
## 💻 Cách Cài Đặt (Installation)
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
### Cách 1: NPM Global (Khuyên dùng cho nhiều máy)
|
|
38
38
|
```bash
|
|
39
39
|
npm i -g ai-developer-skill-os
|
|
40
40
|
```
|
|
41
41
|
|
|
42
|
-
###
|
|
43
|
-
Cài 1 lần, áp dụng cho mọi dự án trên máy:
|
|
42
|
+
### Cách 2: NXP (Không cần cài global)
|
|
44
43
|
```bash
|
|
45
|
-
|
|
44
|
+
npx ai-developer-skill-os init --ide=antigravity --scope=2
|
|
46
45
|
```
|
|
47
46
|
|
|
48
|
-
###
|
|
49
|
-
Cài riêng cho dự án hiện tại, override global:
|
|
47
|
+
### Cách 3: NPM Scripts (Trong dự án)
|
|
50
48
|
```bash
|
|
49
|
+
# Antigravity Global — 1 lần cài, mọi dự án dùng chung
|
|
50
|
+
npm run install:antigravity
|
|
51
|
+
|
|
52
|
+
# Antigravity Local — cài riêng cho dự án này
|
|
51
53
|
npm run install:antigravity:local
|
|
52
|
-
```
|
|
53
54
|
|
|
54
|
-
|
|
55
|
-
```bash
|
|
55
|
+
# Các IDE khác
|
|
56
56
|
npm run install:cursor # Global Cursor
|
|
57
57
|
npm run install:windsurf # Global Windsurf
|
|
58
58
|
npm run install:claude # Global Claude Code
|
|
59
59
|
npm run install:kilo # Global Kilo Code
|
|
60
|
-
npm run install:multi # Multi-IDE
|
|
60
|
+
npm run install:multi # Multi-IDE
|
|
61
61
|
```
|
|
62
62
|
|
|
63
|
-
|
|
63
|
+
## 📦 Tham số cho `init`
|
|
64
|
+
|
|
65
|
+
| Tham số | Giá trị | Mô tả |
|
|
66
|
+
|---------|---------|-------|
|
|
67
|
+
| `--ide` | `antigravity`, `cursor`, `windsurf`, `claude`, `kilo`, `multi-ide` | IDE/AI Assistant |
|
|
68
|
+
| `--scope` | `1` = Local, `2` = Global | Phạm vi cài đặt |
|
|
69
|
+
|
|
70
|
+
### Ví dụ thực tế
|
|
71
|
+
|
|
64
72
|
```bash
|
|
65
|
-
|
|
73
|
+
# Cài Antigravity Global (toàn máy)
|
|
74
|
+
npx ai-developer-skill-os init --ide=antigravity --scope=2
|
|
75
|
+
|
|
76
|
+
# Cài Antigravity Local (chỉ dự án này)
|
|
77
|
+
npx ai-developer-skill-os init --ide=antigravity --scope=1
|
|
78
|
+
|
|
79
|
+
# Cài Cursor Local
|
|
80
|
+
npx ai-developer-skill-os init --ide=cursor --scope=1
|
|
81
|
+
|
|
82
|
+
# Cài Multi-IDE (tạo CLAUDE.md + .qk-ai-skill-os)
|
|
83
|
+
npx ai-developer-skill-os init --ide=multi-ide --scope=2
|
|
66
84
|
```
|
|
67
85
|
|
|
68
86
|
## 🧪 Testing
|
|
69
87
|
|
|
70
|
-
Hệ thống được bảo vệ bằng bộ Test Suite (Vitest) để tự động kiểm toán tính hợp lệ của toàn bộ
|
|
88
|
+
Hệ thống được bảo vệ bằng bộ Test Suite (Vitest) để tự động kiểm toán tính hợp lệ của toàn bộ 22 file Kỹ năng trước khi xuất bản:
|
|
71
89
|
|
|
72
90
|
```bash
|
|
73
91
|
npm test
|
|
@@ -79,3 +97,5 @@ npm test
|
|
|
79
97
|
```bash
|
|
80
98
|
./qk-help
|
|
81
99
|
```
|
|
100
|
+
|
|
101
|
+
|
package/bin/lint.js
CHANGED
|
@@ -30,8 +30,8 @@ const REQUIRED_FOR_EXECUTION = [
|
|
|
30
30
|
'Retry Policy'
|
|
31
31
|
];
|
|
32
32
|
|
|
33
|
-
const ACTION_SKILLS = ['qk-bug-resolution', 'qk-feature-delivery', 'qk-fe-api-integration', 'qk-api-lifecycle', 'qk-data-lifecycle', 'qk-db-optimizer', 'qk-
|
|
34
|
-
const EXECUTION_SKILLS = ['qk-bug-resolution', 'qk-feature-delivery', 'qk-fe-api-integration', 'qk-api-lifecycle', 'qk-data-lifecycle', 'qk-db-optimizer', 'qk-
|
|
33
|
+
const ACTION_SKILLS = ['qk-bug-resolution', 'qk-feature-delivery', 'qk-fe-api-integration', 'qk-api-lifecycle', 'qk-data-lifecycle', 'qk-db-optimizer', 'qk-ui-builder', 'qk-ui-system-builder', 'qk-access-policy', 'qk-ai-builder', 'qk-system-evolution', 'qk-production-release', 'qk-project-bootstrap'];
|
|
34
|
+
const EXECUTION_SKILLS = ['qk-bug-resolution', 'qk-feature-delivery', 'qk-fe-api-integration', 'qk-api-lifecycle', 'qk-data-lifecycle', 'qk-db-optimizer', 'qk-ui-builder', 'qk-ui-system-builder', 'qk-access-policy', 'qk-ai-builder', 'qk-system-evolution', 'qk-production-release', 'qk-project-bootstrap', 'qk-engineering-standard', 'qk-validation-gate', 'qk-ui-audit', 'qk-project-health'];
|
|
35
35
|
|
|
36
36
|
const SKIP_LINT = ['qk-help'];
|
|
37
37
|
|
|
@@ -120,3 +120,4 @@ if (hasErrors) {
|
|
|
120
120
|
console.log('\n✅ All skills comply with V7.5 Runtime Standard!');
|
|
121
121
|
process.exit(0);
|
|
122
122
|
}
|
|
123
|
+
|
package/docs/CHI_TIET_SKILLS.md
CHANGED
|
@@ -40,7 +40,7 @@ Dưới đây là danh sách chi tiết và giải thích cụ thể cho toàn b
|
|
|
40
40
|
- **Mô tả:** Quản lý Design Token, tạo ra các Component có thể tái sử dụng (Button, Table, Form) đảm bảo tính nhất quán toàn dự án.
|
|
41
41
|
- **Khi nào dùng:** Xây dựng thư viện giao diện, tránh viết CSS lộn xộn.
|
|
42
42
|
|
|
43
|
-
### 8. `qk-
|
|
43
|
+
### 8. `qk-ui-builder` (Chuyển Đổi Thiết Kế)
|
|
44
44
|
- **Mô tả:** Đọc hiểu hình ảnh/Figma để tự động chuyển thành mã nguồn giao diện (React, Tailwind, v.v.).
|
|
45
45
|
- **Khi nào dùng:** Bóc tách UI từ bản thiết kế.
|
|
46
46
|
|
|
@@ -123,3 +123,4 @@ Dưới đây là danh sách chi tiết và giải thích cụ thể cho toàn b
|
|
|
123
123
|
### 22. `qk-help` (Tra Cứu Nhanh)
|
|
124
124
|
- **Mô tả:** Cuốn từ điển sống. Cung cấp thông tin và hướng dẫn chi tiết (Pro-tips) về cách sử dụng toàn bộ hệ thống.
|
|
125
125
|
- **Khi nào dùng:** Bất kỳ khi nào người dùng cần hỗ trợ sử dụng hệ điều hành.
|
|
126
|
+
|
|
@@ -33,7 +33,7 @@ Mọi hành vi phức tạp của bất kỳ Agent nào trong hệ thống đề
|
|
|
33
33
|
- **Bản chất:** Trực tiếp sửa đổi trạng thái hệ thống (viết code, xóa file, sửa file).
|
|
34
34
|
- **Trigger:** Đã có kế hoạch rõ ràng hoặc đã xác định xong lỗi.
|
|
35
35
|
- **Evidence Required:** Codebase hiện tại, Kế hoạch.
|
|
36
|
-
- **Ví dụ Skills:** `qk-feature-delivery` (bước sau), `qk-
|
|
36
|
+
- **Ví dụ Skills:** `qk-feature-delivery` (bước sau), `qk-ui-builder`.
|
|
37
37
|
|
|
38
38
|
## 6. 🚦 Delegate / Govern (Điều phối / Quản trị)
|
|
39
39
|
- **Bản chất:** Không trực tiếp làm việc, mà làm nhiệm vụ định tuyến (routing) công việc cho Agent khác hoặc kiểm soát quyền (deny/allow) dựa trên luật lệ.
|
|
@@ -45,3 +45,4 @@ Mọi hành vi phức tạp của bất kỳ Agent nào trong hệ thống đề
|
|
|
45
45
|
|
|
46
46
|
> **Nguyên tắc Thiết kế Hệ thống:**
|
|
47
47
|
> Khi tạo một Skill mới, đừng cố gắng mô tả "tính cách" của nó. Hãy tự hỏi: *Nó cần dùng những Primitives nào để hoàn thành nhiệm vụ?*
|
|
48
|
+
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ai-developer-skill-os",
|
|
3
|
-
"version": "7.5.
|
|
3
|
+
"version": "7.5.1",
|
|
4
4
|
"description": "Behavior Specification Format Framework, AI coding agents (Claude, Cursor, Windsurf, Antigravity) với 22 skills chuyên nghiệp.",
|
|
5
5
|
"main": "bin/install.js",
|
|
6
6
|
"bin": {
|
|
@@ -52,4 +52,4 @@
|
|
|
52
52
|
"gray-matter": "^4.0.0",
|
|
53
53
|
"js-yaml": "^4.1.0"
|
|
54
54
|
}
|
|
55
|
-
}
|
|
55
|
+
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: qk-[skill-name]
|
|
3
3
|
category: [core|frontend|backend|fullstack|security|qa|maintenance|devops|utilities]
|
|
4
|
-
version: 7.5.
|
|
4
|
+
version: 7.5.1
|
|
5
5
|
description: "[One sentence — what it does]"
|
|
6
6
|
platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
|
|
7
7
|
execution_mode: deterministic
|
|
@@ -236,3 +236,4 @@ Exit Code: [SUCCESS | PARTIAL | BLOCKED | FAILED]
|
|
|
236
236
|
| BLOCKED | Missing precondition or ambiguous requirement | STOP, ask user |
|
|
237
237
|
| FAILED | Task failed after 2 retry attempts | STOP, report error |
|
|
238
238
|
|
|
239
|
+
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: qk-access-policy
|
|
3
3
|
category: security
|
|
4
|
-
version: 7.5.
|
|
4
|
+
version: 7.5.1
|
|
5
5
|
description: "Quản lý RBAC, ABAC — định nghĩa role matrix trước, implement middleware sau."
|
|
6
6
|
platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
|
|
7
7
|
execution_mode: deterministic
|
|
@@ -17,7 +17,7 @@ token_budget:
|
|
|
17
17
|
max_shell_commands: 0
|
|
18
18
|
stop_early: true
|
|
19
19
|
exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
|
|
20
|
-
skill_version: 7.5.
|
|
20
|
+
skill_version: 7.5.1
|
|
21
21
|
runtime_version: 1
|
|
22
22
|
schema_version: 2
|
|
23
23
|
---
|
|
@@ -177,3 +177,4 @@ Recommended Assumptions:
|
|
|
177
177
|
|
|
178
178
|
---
|
|
179
179
|
|
|
180
|
+
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: qk-ai-builder
|
|
3
3
|
category: core
|
|
4
|
-
version: 7.5.
|
|
4
|
+
version: 7.5.1
|
|
5
5
|
description: "Thiết kế AI logic, Prompts, RAG pipelines với bảo mật chống Injection — structured output bắt buộc."
|
|
6
6
|
platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
|
|
7
7
|
execution_mode: deterministic
|
|
@@ -11,7 +11,7 @@ risk: high
|
|
|
11
11
|
side_effects: edit_files
|
|
12
12
|
produces: [code, schema]
|
|
13
13
|
consumes: [user-description]
|
|
14
|
-
skill_version: 7.5.
|
|
14
|
+
skill_version: 7.5.1
|
|
15
15
|
runtime_version: 1
|
|
16
16
|
schema_version: 2
|
|
17
17
|
token_budget:
|
|
@@ -213,3 +213,4 @@ Recommended Assumptions (if proceeding):
|
|
|
213
213
|
---
|
|
214
214
|
|
|
215
215
|
|
|
216
|
+
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: qk-api-lifecycle
|
|
3
3
|
category: fullstack
|
|
4
|
-
version: 7.5.
|
|
4
|
+
version: 7.5.1
|
|
5
5
|
description: "Thiết kế, triển khai API endpoints với Zero-Trust — contract trước, code sau."
|
|
6
6
|
platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
|
|
7
7
|
execution_mode: deterministic
|
|
@@ -20,7 +20,7 @@ token_budget:
|
|
|
20
20
|
stop_early: true
|
|
21
21
|
|
|
22
22
|
exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
|
|
23
|
-
skill_version: 7.5.
|
|
23
|
+
skill_version: 7.5.1
|
|
24
24
|
runtime_version: 1
|
|
25
25
|
schema_version: 2
|
|
26
26
|
---
|
|
@@ -174,3 +174,4 @@ Recommended Assumptions:
|
|
|
174
174
|
|
|
175
175
|
---
|
|
176
176
|
|
|
177
|
+
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: qk-bug-resolution
|
|
3
3
|
category: maintenance
|
|
4
|
-
version: 7.5.
|
|
4
|
+
version: 7.5.1
|
|
5
5
|
description: "Sửa lỗi (bugs) bằng chu trình khép kín: Quan sát → Giả thuyết → Bằng chứng → Sửa."
|
|
6
6
|
platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
|
|
7
7
|
execution_mode: deterministic
|
|
@@ -20,7 +20,7 @@ token_budget:
|
|
|
20
20
|
stop_early: true
|
|
21
21
|
|
|
22
22
|
exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
|
|
23
|
-
skill_version: 7.5.
|
|
23
|
+
skill_version: 7.5.1
|
|
24
24
|
runtime_version: 1
|
|
25
25
|
schema_version: 2
|
|
26
26
|
---
|
|
@@ -305,3 +305,4 @@ This skill is triggered when a user reports a specific defect with a stack trace
|
|
|
305
305
|
- Backward Compat: Preserve all existing public API behavior
|
|
306
306
|
- Evidence First: Every finding must use Evidence Format with file:line
|
|
307
307
|
---
|
|
308
|
+
|