К основному содержанию
скилл CX Codex

dart-package-maintenance — скилл для Claude Code

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

Apache-2.0 285 установок ★ 149 обновлён 2026-10-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add kevmoo/dash_skills --skill dart-package-maintenance -a claude-code
Открыть на GitHub

Что делает 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 для локальной проверки.

Какие задачи решает

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

Примеры запросов агенту

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

Как установить dart-package-maintenance

1Через Skills CLI (Vercel)

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/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о dart-package-maintenance

Как установить dart-package-maintenance в Claude Code?

Выполни в терминале npx skills add kevmoo/dash_skills --skill dart-package-maintenance -a claude-code, затем открой ~/.claude/skills/dart-package-maintenance/SKILL.md для справки.

Что делает dart-package-maintenance?

Скилл даёт рекомендации по ведению Dart-пакетов: как версионировать, когда добавлять -wip суффикс, как синхронизировать CHANGELOG, правила публикации и управления pull request'ами.

Нужно ли применять этот скилл к внутренним пакетам (publish_to: none)?

Нет. Скилл предназначен для пакетов, опубликованных на pub.dev. Для приватных пакетов с publish_to: none в pubspec.yaml версионирование и CHANGELOG не требуются по этим рекомендациям.

Исходный текст

SKILL.md · Apache-2.0
---
name: dart-package-maintenance
description: |-
  Guidelines for maintaining external Dart packages, covering versioning,
  publishing workflows, and pull request management. Use when updating Dart
  packages, preparing for a release, or managing collaborative changes in a
  repository.
key_features:
  - Versioning & CHANGELOG sync
  - Publishing workflow guidelines
  - Pull request management
---

# Dart Package Maintenance

Guidelines for maintaining Dart packages in alignment with the canonical Dart
team
[External Package Maintenance](https://github.com/dart-lang/sdk/blob/main/docs/External-Package-Maintenance.md)
specification.

## When to use this skill

Use this skill when:

- Updating Dart packages, preparing for a release, or managing collaborative
  changes in a repository.
- Managing versioning, `CHANGELOG.md` synchronization, and publishing workflows.
- Ensuring published packages comply with Dart team conventions.

### When NOT to use (Abstention Guardrails)

Do NOT apply package maintenance version bumps or changelog updates when:

- **Internal / Private Packages**: Packages marked `publish_to: none` in
  `pubspec.yaml` that are not published to `pub.dev` (e.g., application root
  packages or internal monorepo tooling).
- **Repository-Root Files or Historical `CHANGELOG.md` Typos**: Pull requests
  that only modify repository-level files outside a published package (such as
  `.github/workflows/`, repo-root `SKILL.md`, or root docs in a monorepo) or
  that only fix typos/formatting in historical `CHANGELOG.md` sections.
- **In-Flight PR Commits**: Intermediate commits on an active feature branch
  where the version already carries an appropriate `-wip` suffix.

## Versioning

### Semantic Versioning

Dart packages use [semantic versioning](https://semver.org) with a
[pre-`1.0.0` variation](https://dart.dev/tools/pub/dependencies#caret-syntax)
where the version numbers are shifted to the right before a `1.0.0` release; see
also the
[`package:pub_semver` semantics](https://pub.dev/packages/pub_semver#semantics):

- **Packages at `1.0.0` or later**: `major.minor.patch`.
- **Packages not yet at `1.0.0`**: `0.major.minor`, where the second number is
  bumped for breaking changes, such as `0.4.2` to `0.5.0-wip`, and the third
  number is bumped for non-breaking features and bug fixes, such as `0.4.2` to
  `0.4.3-wip`. Avoid `+1` build suffixes (in `package:pub_semver`, `0.4.2+1-wip`
  parses `+1-wip` as build metadata rather than a `-wip` pre-release).
- **Recommendation**: Aim to publish `1.0.0` as soon as the package is stable.

Choose the version bump based on the impact of the change:

- **Major**: Breaking changes, including removing or renaming a `pubspec.yaml`
  `executables` entry.
- **Minor**: New features and non-breaking API changes, such as introducing a
  new class or adding a `pubspec.yaml` `executables` entry.
- **Patch**: Bug fixes, minimum `environment.sdk` or runtime `dependencies`
  constraint updates, or any other change that does not impact calling code.

### Updating the Version

Whenever the code in the repo differs from the latest version published on
`pub.dev`, both `pubspec.yaml` and `CHANGELOG.md` must use a `-wip` version. We
bump to `-wip` on the _first_ change after a release, even if we don't plan on
publishing the code in that state or if the change doesn't impact consumers.

When opening or merging a PR, check the current version in `pubspec.yaml` and
`CHANGELOG.md`:

- **Currently at a published version**, such as `1.2.3`: Perform the appropriate
  version bump, append `-wip` in `pubspec.yaml`, and add a matching
  `## <version>-wip` section at the top of `CHANGELOG.md`.
- **Already at a `-wip` version**, such as `1.2.4-wip`: Compare the existing
  `-wip` bump against the bump required for your change. If your change requires
  a larger bump, such as from a _patch_ bump to a _minor_ bump when adding a
  feature, update `pubspec.yaml` and rename the existing `## <version>-wip`
  heading in `CHANGELOG.md` in place.
- **Not yet published to `pub.dev`**, at `0.1.0-wip`: Keep `0.1.0-wip` and the
  `- Initial release.` entry without adding per-PR changelog entries until after
  the first release.

### Updating `CHANGELOG.md`

- **User-visible changes**: Add an entry under the top `-wip` section.
- **Internal or non-user-visible changes**, such as safe refactorings, lint
  cleanups, `test/`, `tool/`, or `README.md` updates, or `dev_dependencies` and
  `dependency_overrides` changes:
  - If your PR creates the new `-wip` section, add the `## <version>-wip`
    heading with no bullet items below it.
  - If the package is already at a `-wip` version, leave `CHANGELOG.md`
    untouched and apply the `skip-changelog-check` PR label.
- **Follow-up edits to unreleased work**: If a subsequent PR modifies or reverts
  an unreleased change in the current `-wip` section, such as bumping an SDK or
  dependency constraint again before publishing, update or remove the existing
  `-wip` bullet in place instead of adding a duplicate entry.
- **Already-published sections**: Never add new entries under an
  already-published version heading, especially after merging `main` when a
  release landed while your PR was open.

### Breaking Changes

- Evaluate the impact on dependent packages and internal projects.
- Consider running changes through internal presubmits if possible.
- Prefer incremental rollouts (e.g., new behavior as opt-in) to minimize
  downstream breakage.

## Publishing Process

1. **Preparation**: Remove the `-wip` suffix from `pubspec.yaml` and
   `CHANGELOG.md` in a dedicated pull request.
2. **Execution**: Run `dart pub publish` (or `flutter pub publish`) and resolve
   all warnings and errors.
3. **Tagging**: Create and push a git tag for the published version:
   - For single-package repos: `v1.2.3`
   - For monorepos: `package_name-v1.2.3`
   - Example: `git tag v1.2.3 && git push --tags`

## Pull Request Management

- **Commits**: Each PR should generally correspond to a single squashed commit
  upon merging.
- **Shared History**: Once a PR is open, avoid force pushing to the branch.
- **Conflict Resolution**: Prefer merging `main` into the PR branch rather than
  rebasing to resolve conflicts. This preserves the review history and comments.
- **Reviewing**: Add comments from the "Files changed" view to batch them.
- **Local Inspection**: Use `gh pr checkout <number>` to inspect changes locally
  in your IDE.

© kevmoo · Apache-2.0 · kevmoo/dash_skills

Похожие скиллы

Все скиллы по теме «Языки программирования» →
dart-migrate-to-checks-package dart-lang Скилл dart-migrate-to-checks-package для Claude Code переводит тесты Dart с package:matcher на package:checks. Автоматизирует миграцию утверждений и улучшает диагностику ошибок. CX Codex +1 20 000установок dart-use-path-package flutter Скилл dart-use-path-package учит агента работать с путями файлов в Dart через package:path, избегая строковых операций, которые ломаются на Windows. CX Codex +1 8 800установок dart-resolve-package-conflicts dart-lang Скилл dart-resolve-package-conflicts для решения конфликтов версий пакетов в Dart-проектах, когда pub get не может найти совместимые версии. Помогает разобраться с lockfile и обновить зависимости без полного пересчёта. CX Codex +1 20 600установок list-npm-package-content vercel Скилл list-npm-package-content показывает точный список файлов, которые попадут в npm-пакет при публикации. Пригодится, чтобы проверить содержимое перед выкладкой или найти, почему в бандл попал лишний файл. CX Codex +1 22установок changelog-maintenance aj-geddes Скилл changelog-maintenance помогает агенту писать и поддерживать CHANGELOG.md по формату Keep a Changelog: разделы Added, Changed, Fixed, Security и отметки о ломающих изменениях. CX Codex +1 503установок dart-use-primary-constructors flutter Скилл dart-use-primary-constructors учит агента переводить классы Dart на первичные конструкторы и синтаксис Dart 3.13+. Он пригодится при рефакторинге моделей данных и сокращении шаблонного кода. CX Codex +1 17 000установок

Из того же набора9

dart-best-practices Скилл dart-best-practices задаёт правила оформления кода на Dart при генерации и ревью. Помогает форматировать многострочные блоки и соблюдать лимит длины строки в 80 знаков. CX Codex +1 847установок dart-test-fundamentals Скилл dart-test-fundamentals для Claude Code и Codex задаёт стандарты работы с библиотекой package:test в Dart. Инструмент следит за структурой тестов, вызовами setUp и очисткой ресурсов через addTearDown. CX Codex +1 455установок dart-modern-features Скилл dart-modern-features обучает агента современному синтаксису Dart версий 3.0–3.10. Он помогает безопасно внедрять записи, extension types и модификаторы классов при рефакторинге. CX Codex +1 370установок dart-doc-validation Скилл dart-doc-validation учит агента проверять комментарии документации в Dart-коде командой dart doc и включать линт comment_references, чтобы ловить битые ссылки на классы, методы и макросы. CX Codex +1 291установок dart-matcher-best-practices Скилл dart-matcher-best-practices для Claude Code помогает писать проверки Dart через expect и package:matcher. Он подключается при создании тестов, разборе сбоев и замене ручных проверок. CX Codex +1 269установок dart-test-coverage Скилл dart-test-coverage для Claude Code запускает сбор покрытия Dart-пакета, разбирает пропущенные строки и помогает наметить тесты. Помогает выявить непроверенный код в lib/. CX Codex +1 163установок dart-long-lines Скилл dart-long-lines для Claude Code помогает соблюдать лимит в 80 символов в строках Dart. Он подключается при написании и рефакторинге кода под lint lines_longer_than_80_chars. CX Codex +1 150установок dart-multiline-strings Скилл dart-multiline-strings для Claude Code учит переписывать цепочки print() и конкатенации в тройные кавычки. Запускается при рефакторинге CLI-вывода, шаблонных сообщений и многострочных блоков в Dart. CX Codex +1 116установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой