# dart-package-maintenance

Скилл dart-package-maintenance для Claude Code помогает вести Dart-пакеты: следить за версиями, синхронизировать CHANGELOG и управлять релизами. Описывает поддержку пакетов на pub.dev.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 285 установок · ★ 149 у репозитория
- Автор: kevmoo
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/kevmoo/dash_skills/tree/HEAD/skills/dart-package-maintenance/SKILL.md
- Обновлён: 2026-10-17
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/dart-package-maintenance

## Что делает

Скилл содержит рекомендации по семантическому версионированию пакетов Dart, включая правила для версий до 1.0.0 (где второе число отвечает за breaking changes) и после. Учит, когда добавлять суффикс `-wip` в `pubspec.yaml` и `CHANGELOG.md` — сразу после релиза, даже если изменения минимальны. Разбирает, какие версии указывают как major (breaking changes), minor (новые возможности) и patch (баги и баланс зависимостей).

Описывает, как управлять CHANGELOG: добавлять записи только для пользовательских изменений, пропускать внутренние рефакторинги и обновления dev-зависимостей. Объясняет процесс публикации: убрать `-wip`, запустить `dart pub publish`, создать git-тег в формате `v1.2.3` (или `имя-пакета-v1.2.3` в монорепозиториях). Советует, как работать с pull request'ами: избегать force push, мержить main в ветку вместо rebase, использовать `gh pr checkout` для локальной проверки.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add kevmoo/dash_skills --skill dart-package-maintenance -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/dart-package-maintenance/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/dart-package-maintenance/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add kevmoo/dash_skills --skill dart-package-maintenance -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/dart-package-maintenance/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add kevmoo/dash_skills --skill dart-package-maintenance -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/dart-package-maintenance/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install kevmoo/dash_skills skills/dart-package-maintenance
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/dart-package-maintenance/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add kevmoo/dash_skills --skill dart-package-maintenance -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/kevmoo/dash_skills --path skills/dart-package-maintenance
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/dart-package-maintenance/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add kevmoo/dash_skills --skill dart-package-maintenance -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/kevmoo/dash_skills/tree/HEAD/skills/dart-package-maintenance/SKILL.md

## Когда брать
- привести версию пакета в соответствие со стандартом семантического версионирования
- синхронизировать номер версии в pubspec.yaml и CHANGELOG.md
- подготовить пакет к публикации на pub.dev
- организовать совместную работу над пакетом без конфликтов в истории
- определить, какой вид версионирования применить (major, minor, patch)

## Примеры запросов агенту
- Я обновил функцию в пакете. Какой номер версии указать в pubspec.yaml?
- Подготовь релиз пакета на pub.dev: убери -wip из версии
- Добавь запись в CHANGELOG для нового экспортируемого класса

## Похожие
- [dart-migrate-to-checks-package](https://affpapa.org/nevibecode/skills/dart-migrate-to-checks-package.md) — скилл · 20000 установок
- [dart-use-path-package](https://affpapa.org/nevibecode/skills/dart-use-path-package.md) — скилл · 8800 установок
- [dart-resolve-package-conflicts](https://affpapa.org/nevibecode/skills/dart-resolve-package-conflicts.md) — скилл · 20600 установок
- [list-npm-package-content](https://affpapa.org/nevibecode/skills/list-npm-package-content.md) — скилл · 22 установки
- [changelog-maintenance](https://affpapa.org/nevibecode/skills/changelog-maintenance.md) — скилл · 503 установки
- [dart-use-primary-constructors](https://affpapa.org/nevibecode/skills/dart-use-primary-constructors.md) — скилл · 17000 установок

Из того же набора: [kevmoo/dash_skills](https://affpapa.org/nevibecode/by/kevmoo/dash_skills.md) — 9 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
