code-ai-installer 3.0.0 → 4.0.1-a

package/domains/development/.agents/skills/tooling-bun-biome/SKILL.md

@@ -1,16 +1,47 @@
 ---
 name: tooling-bun-biome
-description: Tooling — Biome (lint/format) и Bun (runtime/package manager). biome.json конфиг, ключевые правила, Bun scripts, pre-commit hooks, CI pipeline, миграция с ESLint+Prettier. Активируй при настройке tooling, добавлении линтера, или при вопросах «как настроить Biome/Bun».
+description: "Tooling — Biome (lint/format) и Bun (runtime/package manager). biome.json конфиг, ключевые правила, Bun scripts, pre-commit hooks, CI pipeline, миграция с ESLint+Prettier. Активируй при настройке tooling, добавлении линтера, или при вопросах «как настроить Biome/Bun»."
+type: discretionary
+domain: development
+owners:
+  - senior_full_stack
+gates:
+  - DEV
+tech:
+  - bun
+  - biome
+topic:
+  - general
+triggers:
+  - Biome конфиг
+  - Bun runtime
+  - Bun scripts
+  - миграция с ESLint
+  - pre-commit hook
+  - biome.json
+  - линтер настроить
+related:
+  - tooling-bun-biome-reference
+  - es2025-beast-practices
+  - es2025-beast-practices-reference
+  - typescript-beast-practices
+  - typescript-beast-practices-reference
+  - testing-strategy-js
+  - testing-strategy-js-reference
+  - dev-reference-snippets
+budget_lines: 300
+schema_version: 1
 ---
 
+
 # Skill: Tooling (Bun + Biome) Beast Practices
 
-Конкретные конфиги, команды и DO/DON'T для Biome (lint + format) и Bun (runtime + package manager).
+Decision rules + canonical tables для Biome (lint/format) и Bun (runtime/package manager). Полные конфиги — в `$tooling-bun-biome-reference`.
 
 **Разделы:**
-1. [Biome: setup и конфиг](#1-biome-setup)
+1. [Biome: setup и правила](#1-biome-setup)
 2. [Biome: ключевые правила](#2-ключевые-правила)
-3. [Bun: runtime и package manager](#3-bun)
+3. [Bun: когда использовать](#3-bun)
 4. [Scripts (package.json)](#4-scripts)
 5. [Pre-commit hooks](#5-pre-commit-hooks)
 6. [CI Pipeline](#6-ci-pipeline)
@@ -21,165 +52,19 @@ description: Tooling — Biome (lint/format) и Bun (runtime/package manager). b
 
 ## 1. Biome: setup
 
-### Установка
-
-```bash
-# Через npm
-npm install --save-dev --save-exact @biomejs/biome
-
-# Через Bun
-bun add --dev --exact @biomejs/biome
-
-# Инициализация конфига
-npx @biomejs/biome init
-```
-
-### ✅ DO: полный biome.json
-
-```jsonc
-// biome.json — корень проекта
-{
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-
-  "organizeImports": {
-    "enabled": true
-  },
-
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-
-      // Стиль
-      "style": {
-        "useConst": "error",
-        "noVar": "error",
-        "useTemplate": "warn",
-        "noNonNullAssertion": "warn",
-        "useImportType": "error"
-      },
-
-      // Подозрительный код
-      "suspicious": {
-        "noExplicitAny": "warn",
-        "noConsoleLog": "warn",
-        "noDebugger": "error",
-        "noDoubleEquals": "error",
-        "noFallthroughSwitchClause": "error",
-        "noImplicitAnyLet": "warn"
-      },
-
-      // Производительность
-      "performance": {
-        "noAccumulatingSpread": "warn",
-        "noDelete": "warn"
-      },
-
-      // Сложность
-      "complexity": {
-        "noForEach": "warn",
-        "useFlatMap": "warn",
-        "useOptionalChain": "error"
-      },
-
-      // Корректность
-      "correctness": {
-        "noUnusedVariables": "error",
-        "noUnusedImports": "error",
-        "useExhaustiveDependencies": "warn",
-        "useHookAtTopLevel": "error"
-      },
-
-      // Безопасность
-      "security": {
-        "noDangerouslySetInnerHtml": "error"
-      },
-
-      // a11y (JSX)
-      "a11y": {
-        "useButtonType": "error",
-        "useAltText": "error",
-        "noBlankTarget": "error"
-      }
-    }
-  },
-
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 100,
-    "lineEnding": "lf"
-  },
-
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "single",
-      "trailingCommas": "all",
-      "semicolons": "always",
-      "arrowParentheses": "always",
-      "bracketSpacing": true,
-      "jsxQuoteStyle": "double"
-    }
-  },
-
-  "json": {
-    "formatter": {
-      "trailingCommas": "none"
-    }
-  },
-
-  "files": {
-    "ignore": [
-      "node_modules",
-      "dist",
-      "build",
-      ".next",
-      "coverage",
-      "*.min.js",
-      "*.bundle.js"
-    ],
-    "maxSize": 1048576
-  },
-
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": true
-  }
-}
-```
-
-### Monorepo конфиг
-
-```jsonc
-// biome.json (root)
-{
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-  "linter": { "rules": { "recommended": true } },
-  "formatter": { "indentStyle": "space", "indentWidth": 2 }
-}
-
-// apps/dashboard/biome.json (extends root)
-{
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-  "extends": ["../../biome.json"],
-  "linter": {
-    "rules": {
-      "suspicious": {
-        "noConsoleLog": "off"  // разрешить console.log в dashboard
-      }
-    }
-  }
-}
-```
+**Правила:**
+- **`@biomejs/biome` с `--save-exact`** — Biome быстро эволюционирует, фиксируй версию
+- **`biome init`** создаёт baseline `biome.json` — допиши `linter.rules.recommended: true`
+- **Monorepo**: root `biome.json` + sub-package `extends: ["../../biome.json"]` для overrides
+- **`organizeImports.enabled: true`** — авто-сортировка импортов
+- **`vcs.useIgnoreFile: true`** — уважает `.gitignore`
+
+> Полный `biome.json` (root + monorepo overrides) → `$tooling-bun-biome-reference` §1.
 
 ---
 
 ## 2. Ключевые правила
 
-### Правила по категориям
-
 | Правило | Уровень | Почему важно |
 |---------|---------|-------------|
 | `useConst` | error | Не мутируемые переменные = `const` |
@@ -195,16 +80,9 @@ npx @biomejs/biome init
 | `useButtonType` | error | a11y: кнопка без type = submit |
 | `useOptionalChain` | error | `?.` вместо `&&` chains |
 
-### ✅ DO: настроить ignore для конкретного кода
-
-```js
-// ✅ Точечный ignore с обоснованием
-// biome-ignore lint/suspicious/noConsoleLog: Intentional debug output for dev
-console.log('Startup config:', config);
-
-// ❌ Не игнорировать массово без причины
-// biome-ignore lint: TODO fix later  ← ❌ нет причины
-```
+**Точечный ignore:**
+- ✅ `// biome-ignore lint/suspicious/noConsoleLog: <reason>` — всегда с причиной после `:`
+- ❌ `// biome-ignore lint: TODO fix later` — нет причины
 
 ---
 
@@ -222,34 +100,9 @@ console.log('Startup config:', config);
 | Production | Растёт, но npm стабильнее | Стандарт индустрии |
 
 > [!IMPORTANT]
-> Используй Bun только если разрешено проектом. Для продакшна → npm.
-> Bun отлично для dev-loop: install, test, scripts.
-
-### ✅ DO: основные Bun команды
-
-```bash
-# Package management
-bun install                     # Install all deps (lockfile: bun.lockb)
-bun add react @types/react      # Add dependency
-bun add --dev vitest             # Add devDependency
-bun remove lodash                # Remove dependency
-
-# Scripts
-bun run dev                      # Run script from package.json
-bun run test                     # Run tests
-bun run build                    # Build
+> Bun используй только если разрешено проектом. Для прода → npm. Bun отлично для dev-loop.
 
-# Direct execution
-bun run src/server.js            # Run file directly
-bun --watch src/server.js        # Run with watch mode
-
-# Built-in test runner (Jest-compatible)
-bun test                         # Run all tests
-bun test --coverage              # With coverage
-bun test src/utils.test.js       # Run specific test
-```
-
-### Bun vs npm commands mapping
+### Bun vs npm commands
 
 | Задача | npm | Bun |
 |--------|-----|-----|
@@ -261,46 +114,12 @@ bun test src/utils.test.js       # Run specific test
 | Execute | `npx vitest` | `bunx vitest` |
 | Lockfile | `package-lock.json` | `bun.lockb` |
 
+> Полные Bun команды → `$tooling-bun-biome-reference` §3.
+
 ---
 
 ## 4. Scripts
 
-### ✅ DO: стандартные scripts в package.json
-
-```jsonc
-{
-  "scripts": {
-    // Development
-    "dev": "vite",
-    "dev:debug": "vite --debug",
-
-    // Build
-    "build": "vite build",
-    "preview": "vite preview",
-
-    // Testing
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:ui": "vitest --ui",
-
-    // Quality
-    "lint": "biome lint .",
-    "lint:fix": "biome lint --write .",
-    "format": "biome format --write .",
-    "check": "biome check .",
-    "check:fix": "biome check --write .",
-
-    // All-in-one
-    "quality": "biome check --write . && vitest run",
-
-    // CI (no auto-fix, strict mode)
-    "ci:lint": "biome ci .",
-    "ci:test": "vitest run --reporter=junit --outputFile=test-results.xml"
-  }
-}
-```
-
 ### Biome CLI commands explained
 
 | Команда | Что делает | Когда |
@@ -312,158 +131,54 @@ bun test src/utils.test.js       # Run specific test
 | `biome format --write .` | Только format | Dev |
 | `biome ci .` | Strict mode для CI (error on warnings) | CI pipeline |
 
----
-
-## 5. Pre-commit hooks
-
-### ✅ DO: lefthook (быстрее husky + lint-staged)
-
-```bash
-# Установка
-npm install --save-dev lefthook
-npx lefthook install
-```
-
-```yaml
-# lefthook.yml
-pre-commit:
-  commands:
-    biome:
-      glob: "*.{js,jsx,ts,tsx,json,css}"
-      run: npx @biomejs/biome check --write --no-errors-on-unmatched --files-ignore-unknown=true {staged_files}
-      stage_fixed: true   # re-stage fixed files
-
-    typecheck:
-      glob: "*.{ts,tsx}"
-      run: npx tsc --noEmit
-```
-
-### ✅ DO: альтернатива — husky + lint-staged
-
-```bash
-npm install --save-dev husky lint-staged
-npx husky init
-```
-
-```jsonc
-// package.json
-{
-  "lint-staged": {
-    "*.{js,jsx,ts,tsx,json,css}": [
-      "biome check --write --no-errors-on-unmatched --files-ignore-unknown=true"
-    ]
-  }
-}
-```
-
-```bash
-# .husky/pre-commit
-npx lint-staged
-```
-
----
-
-## 6. CI Pipeline
+**Правила scripts:**
+- **CI использует `biome ci .`** (без `--write`, strict — warnings становятся errors)
+- **Dev использует `biome check --write .`** (lint + format + imports одной командой)
+- **`quality: "biome check --write . && vitest run"`** — комбинированная локальная проверка
 
-### ✅ DO: GitHub Actions с Biome
-
-```yaml
-# .github/workflows/quality.yml
-name: Quality Check
-
-on:
-  pull_request:
-    branches: [main, develop]
-
-jobs:
-  quality:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: 'npm'
-
-      - run: npm ci
-
-      # Biome: lint + format + import sorting (strict CI mode)
-      - name: Biome CI
-        run: npx @biomejs/biome ci .
-
-      # TypeScript check
-      - name: TypeScript
-        run: npx tsc --noEmit
-
-      # Tests
-      - name: Tests
-        run: npm run test -- --coverage
-
-      # Upload coverage
-      - uses: actions/upload-artifact@v4
-        if: always()
-        with:
-          name: coverage
-          path: coverage/
-```
-
-### ✅ DO: CI с Bun (если используется)
-
-```yaml
-jobs:
-  quality:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - run: bun install --frozen-lockfile
-      - run: bun run ci:lint
-      - run: bun test --coverage
-```
+> Полный package.json scripts → `$tooling-bun-biome-reference` §4.
 
 ---
 
-## 7. Миграция с ESLint + Prettier
-
-### Пошаговый план
-
-```bash
-# 1. Установить Biome
-npm install --save-dev --save-exact @biomejs/biome
+## 5. Pre-commit hooks
 
-# 2. Мигрировать конфиг
-npx @biomejs/biome migrate eslint --write       # ESLint → Biome
-npx @biomejs/biome migrate prettier --write     # Prettier → Biome
+**Правила:**
+- **lefthook** быстрее husky + lint-staged (preferred); альтернатива husky + lint-staged
+- **`stage_fixed: true`** — re-stage автофикснутые файлы
+- **`--no-errors-on-unmatched`** + **`--files-ignore-unknown=true`** — для частичного staged
+- **`typecheck`** отдельной командой — `npx tsc --noEmit` после Biome
 
-# 3. Проверить результат
-npx @biomejs/biome check .
+> Полные lefthook.yml + husky + lint-staged configs → `$tooling-bun-biome-reference` §5.
 
-# 4. Исправить все ошибки
-npx @biomejs/biome check --write .
+---
 
-# 5. Удалить старые зависимости
-npm uninstall eslint prettier eslint-config-prettier eslint-plugin-react \
-  eslint-plugin-react-hooks @typescript-eslint/parser @typescript-eslint/eslint-plugin
+## 6. CI Pipeline
 
-# 6. Удалить старые конфиги
-rm -f .eslintrc* .prettierrc* .eslintignore .prettierignore
+**Правила:**
+- **`biome ci .`** — strict mode (без `--write`, warnings → errors)
+- **TypeScript отдельным шагом** — `npx tsc --noEmit`
+- **Coverage upload** через `actions/upload-artifact@v4`
+- **Bun CI**: `oven-sh/setup-bun@v2` + `bun install --frozen-lockfile`
 
-# 7. Обновить scripts в package.json
-# "lint": "biome lint ."
-# "format": "biome format --write ."
+> Полные GitHub Actions YAML (npm + Bun варианты) → `$tooling-bun-biome-reference` §6.
 
-# 8. Обновить pre-commit hooks (если есть)
+---
 
-# 9. Обновить CI pipeline
+## 7. Миграция
 
-# 10. Коммит
-git add -A && git commit -m "chore: migrate from ESLint+Prettier to Biome"
-```
+**Step-by-step:**
+1. `npm install --save-dev --save-exact @biomejs/biome`
+2. `npx @biomejs/biome migrate eslint --write` — миграция ESLint конфига
+3. `npx @biomejs/biome migrate prettier --write` — миграция Prettier
+4. `npx @biomejs/biome check .` — проверить
+5. `npx @biomejs/biome check --write .` — исправить ошибки
+6. `npm uninstall eslint prettier eslint-config-prettier ...`
+7. `rm -f .eslintrc* .prettierrc*`
+8. Обновить `scripts` в package.json
+9. Обновить pre-commit hooks + CI pipeline
+10. Commit: `chore: migrate from ESLint+Prettier to Biome`
 
-### Маппинг ESLint → Biome
+### ESLint → Biome маппинг
 
 | ESLint правило | Biome эквивалент |
 |----------------|-----------------|
@@ -475,6 +190,8 @@ git add -A && git commit -m "chore: migrate from ESLint+Prettier to Biome"
 | `react-hooks/exhaustive-deps` | `correctness/useExhaustiveDependencies` |
 | `react-hooks/rules-of-hooks` | `correctness/useHookAtTopLevel` |
 
+> Полный migration bash + VS Code settings → `$tooling-bun-biome-reference` §7.
+
 ---
 
 ## 8. Anti-patterns
@@ -506,34 +223,12 @@ git add -A && git commit -m "chore: migrate from ESLint+Prettier to Biome"
 
 ---
 
-## VS Code интеграция
-
-```jsonc
-// .vscode/settings.json
-{
-  "editor.defaultFormatter": "biomejs.biome",
-  "editor.formatOnSave": true,
-  "editor.codeActionsOnSave": {
-    "quickfix.biome": "explicit",
-    "source.organizeImports.biome": "explicit"
-  },
-  "[javascript]": { "editor.defaultFormatter": "biomejs.biome" },
-  "[typescript]": { "editor.defaultFormatter": "biomejs.biome" },
-  "[json]": { "editor.defaultFormatter": "biomejs.biome" },
-  "[jsonc]": { "editor.defaultFormatter": "biomejs.biome" }
-}
-```
-
-```jsonc
-// .vscode/extensions.json
-{
-  "recommendations": ["biomejs.biome"]
-}
-```
-
----
-
 ## См. также
+- `$tooling-bun-biome-reference` — полный справочник конфигов (biome.json, lefthook, CI, VS Code)
 - `$es2025-beast-practices` — современный JavaScript (правила совпадают с Biome rules)
+- `$es2025-beast-practices-reference` — JS code reference
+- `$typescript-beast-practices` — TypeScript строгость + Biome
+- `$typescript-beast-practices-reference` — TS code reference
 - `$testing-strategy-js` — Vitest конфигурация
-- `$dev-reference-snippets` — примеры кода
+- `$testing-strategy-js-reference` — testing code reference
+- `$dev-reference-snippets` — примеры кода

package/domains/development/.agents/skills/tooling-bun-biome/agents/kimi.yaml

@@ -1,15 +1,15 @@
-name: "tooling-bun-biome"
-display_name: "Инструменты Bun и Biome"
-description: "Tooling — Biome (lint/format) и Bun (runtime/package manager). biome.json конфиг, ключевые правила, Bun scripts, pre-commit hooks, CI pipeline, миграция с ESLint+Prettier. Активируй при настройке tooling, добавлении линтера, или при вопросах «как настроить Biome/Bun»."
-default_prompt: "Используй $tooling-bun-biome, когда задача относится к навыку \"Инструменты Bun и Biome\"."
-triggers:
-  - "tooling-bun-biome"
-  - "tooling bun biome"
-  - "Инструменты Bun и Biome"
-  - "Tooling — Biome (lint/format) и Bun (runtime/package manager)"
-capabilities:
-  - "tooling"
-  - "bun"
-  - "biome"
-tools: []
-implicit_invocation: true
+name: "tooling-bun-biome"
+display_name: "Инструменты Bun и Biome"
+description: "Tooling — Biome (lint/format) и Bun (runtime/package manager). biome.json конфиг, ключевые правила, Bun scripts, pre-commit hooks, CI pipeline, миграция с ESLint+Prettier. Активируй при настройке tooling, добавлении линтера, или при вопросах «как настроить Biome/Bun»."
+default_prompt: "Используй $tooling-bun-biome, когда задача относится к навыку \"Инструменты Bun и Biome\"."
+triggers:
+  - "tooling-bun-biome"
+  - "tooling bun biome"
+  - "Инструменты Bun и Biome"
+  - "Tooling — Biome (lint/format) и Bun (runtime/package manager)"
+capabilities:
+  - "tooling"
+  - "bun"
+  - "biome"
+tools: []
+implicit_invocation: true