菜单
Use when bumping the dart_helper_utils package version in a project or auditing an upgrade's impact - detecting the installed version, sequencing migration hops across v2/v3/v4/v5/v6, patch-level 6.0.x bumps, or answering "is it safe to upgrade dart_helper_utils".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when Dart/Flutter code needs debouncing, throttling, stream shaping, or bounded-concurrency async work with the dart_helper_utils package - search-input debounce, rate-limited event streams, Debouncer/DebouncedCallback/Throttler lifecycle and disposal, TimeUtils.debounce/throttle/runWithTimeout, stream bufferCount/window/rateLimit/asPausable/withLatestValue/retry/replaceOnError, StreamController safeAdd/safeClose, Future minWait/timeoutOrNull, retry with exponential backoff, waitConcurrency, or mapConcurrent.
Use when upgrading a project from dart_helper_utils 5.x or earlier to 6.x, or fixing compile errors after that bump - ConvertObject/toString1/ParsingException renames, altKeys to alternativeKeys, firstValueForKeys to tryGetRaw, removed Paginator/DoublyLinkedList/country data/StringSimilarity, httpFormat to httpDateFormat, flatJson to flatMap, TimeUtils.throttle signature change, percentile 0-100 range, delay methods, or helpers that moved to convert_object or package collection.
Use when writing or reviewing Dart/Flutter code that uses the dart_helper_utils package - deep map utilities (flatMap, unflatten, getPath, setPath, deepMerge), string casing/slugify/masking/parseDuration/truncate, MIME filename checks, iterable chunks/windowed/partition/distinctBy, number stats and HTTP status helpers, DateTime and Duration extensions, intl formatting wrappers (formatAsReadableNumber, dateFormat, pluralize), Uri rebuild, or deciding between dart_helper_utils and direct collection/intl/convert_object imports.
| name | upgrade-dart-helper-utils |
| description | Use when bumping the dart_helper_utils package version in a project or auditing an upgrade's impact - detecting the installed version, sequencing migration hops across v2/v3/v4/v5/v6, patch-level 6.0.x bumps, or answering "is it safe to upgrade dart_helper_utils". |
Version-aware audit. Determine the CURRENT resolved version first, apply only the hops that cross it, and verify with the project's own tests.
grep -n "dart_helper_utils" pubspec.yaml # declared constraint
grep -A2 " dart_helper_utils:" pubspec.lock # resolved version
If the resolved version already equals the target: report "no migration needed" and stop (do not invent work).
| From | To | Size | What changes |
|---|---|---|---|
| 1.x | 2.x | small | toDateWithFormat to toDateFormatted; dateFormat became a method with optional locale; firstDayOfWeek/lastDayOfWeek became methods with startOfWeek:; flatJson to flatMap; makeEncodable/safelyEncodedJson to encodableCopy/encodedJsonString |
| 2.x | 3.x | small | removed deprecated String.toDateTime (use toDate/toDateFormatted) and DateTime.format (use formatted) |
| 3.x | 4.x | medium | paginators rebuilt on BasePaginator (lifecycle, transform caching, CancelableOperation); generic delay() replaced by unit methods (2.secondsDelay()); disposal became no-op instead of throwing |
| 4.x/5.x | 6.x | LARGE | use the dedicated migrate-dart-helper-utils-v5-to-v6 skill (conversion moved to convert_object, renames, removals, behavior changes) |
| 6.0.x | 6.0.y | none | patch releases are docs/tooling unless the CHANGELOG says otherwise - read it first |
Shortcut when crossing several majors: paginator work in the 3-to-4 hop is
WASTED if the target is 6.x (paginators were removed in v6) - go straight
to choosing a pagination replacement. The same applies to
encodableCopy/encodedJsonString (renamed again in v6 to
toJsonSafe/toJsonString).
dart pub get (or
dart pub upgrade dart_helper_utils).dart analyze and run the full test suite; compare failures against the
pre-upgrade baseline (record it first).^3.10.0 and convert_object ^1.1.0;
a direct dependency pinning convert_object <1.1 (or an old SDK) blocks
resolution.alternativeKeys, percentile range) are catalogued in the
migrate-dart-helper-utils-v5-to-v6 skill's behavior-changes section.