dart-use-path-package
Управляет путями к файлам и директориям кроссплатформенно через package:path и package:file. Полезен для объединения, разбора и рефакторинга путей, заменяя ручную обработку строк. Не подходит для URI, URL или запросов к БД.
Что делает навык
Навык обеспечивает безопасное кроссплатформенное управление путями к файлам и директориям в Dart, заменяя ненадежную обработку строк на специализированные пакеты. Он предотвращает ошибки, связанные с различиями в разделителях путей между Windows и Unix-системами, а также с некорректным форматированием строк.
Когда применять
- Объединение директории и имени файла без риска появления двойных слешей или несовместимых разделителей.
- Проверка вхождения или начала пути, требующая учета системных особенностей (например, backslashes в Windows).
- Преобразование нативных путей в форматы POSIX, Git или URL для совместимости с внешними системами.
- Извлечение расширения файла или базового имени (stem) из пути с учетом кроссплатформенности.
Как работает
- Использовать пакет package:path для всех операций с путями, избегая сырых строк.
- Применять функции пакета для объединения путей, чтобы автоматически обрабатывать разделители.
- Использовать методы пакета для безопасной проверки структуры пути (содержит, начинается с).
- Применять преобразования путей для адаптации под контексты Git, POSIX или URL.
- Использовать расширения и извлечение стема для парсинга информации о файле.
- При необходимости тестирования использовать package:file для мока файловой системы вместо глобальных функций.
Примеры запросов агенту
Что понадобится
- Пакет package:path
- Пакет package:file (для мока файловой системы)
Описание составлено по SKILL.md навыка, сверено 07.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.