AIKraft/Skills/dart-use-path-package

dart-use-path-package

Управляет путями к файлам и директориям кроссплатформенно через package:path и package:file. Полезен для объединения, разбора и рефакторинга путей, заменяя ручную обработку строк. Не подходит для URI, URL или запросов к БД.

flutter official Разработка ★ 3k

Что делает навык

Навык обеспечивает безопасное кроссплатформенное управление путями к файлам и директориям в Dart, заменяя ненадежную обработку строк на специализированные пакеты. Он предотвращает ошибки, связанные с различиями в разделителях путей между Windows и Unix-системами, а также с некорректным форматированием строк.

Когда применять

  • Объединение директории и имени файла без риска появления двойных слешей или несовместимых разделителей.
  • Проверка вхождения или начала пути, требующая учета системных особенностей (например, backslashes в Windows).
  • Преобразование нативных путей в форматы POSIX, Git или URL для совместимости с внешними системами.
  • Извлечение расширения файла или базового имени (stem) из пути с учетом кроссплатформенности.

Как работает

  1. Использовать пакет package:path для всех операций с путями, избегая сырых строк.
  2. Применять функции пакета для объединения путей, чтобы автоматически обрабатывать разделители.
  3. Использовать методы пакета для безопасной проверки структуры пути (содержит, начинается с).
  4. Применять преобразования путей для адаптации под контексты Git, POSIX или URL.
  5. Использовать расширения и извлечение стема для парсинга информации о файле.
  6. При необходимости тестирования использовать package:file для мока файловой системы вместо глобальных функций.

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

Как безопасно объединить путь к директории и имя файла в Dart, чтобы избежать двойных слешей?
Как проверить, начинается ли путь с определенной папки, учитывая разницу между Windows и Linux?
Как преобразовать нативный путь файла в формат, совместимый с Git или URL?

Что понадобится

  • Пакет package:path
  • Пакет package:file (для мока файловой системы)

Описание составлено по SKILL.md навыка, сверено 07.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «dart-use-path-package» из репозитория: # https://github.com/flutter/agent-plugins
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r dart-use-path-package/ ~/.claude/skills/dart-use-path-package/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.