Жизненный цикл
Guidance for managing R package lifecycle according to tidyverse principles using the lifecycle package. Use when: (1) Setting up lifecycle infrastructure in a package, (2) Deprecating functions or arguments, (3) Renaming functions or arguments, (4) Superseding functions, (5) Marking functions as experimental, (6) Understanding lifecycle stages (stable, experimental, deprecated, superseded), or (7
Что делает навык
Управление жизненным циклом функций и аргументов R-пакетов в соответствии с принципами tidyverse с использованием пакета lifecycle. Позволяет помечать элементы как экспериментальные, устаревшие или замененные, обеспечивая плавный переход пользователей на новые API.
Когда применять
- Настройка инфраструктуры жизненного цикла в пакете (добавление бейджей и импортов).
- Устаревание (deprecated) функций или аргументов с выводом предупреждений.
- Переименование функций или аргументов с сохранением обратной совместимости.
- Замена (superseded) функций на альтернативы без удаления старых.
- Пометка функций как экспериментальных (experimental).
Как работает
- Проверить наличие файлов lifecycle-*.svg в man/figures/; если нет, запустить usethis::use_lifecycle() для настройки DESCRIPTION и документации.
- Вставить соответствующие бейджи (experimental, deprecated, superseded) в roxygen2-документацию функций или аргументов.
- Для устаревания функции добавить вызов lifecycle::deprecate_warn() (или deprecate_soft()/deprecate_stop()) в начало тела функции и обновить описание.
- Для устаревания аргумента использовать значение deprecated() по умолчанию и проверку lifecycle::is_present() для вывода предупреждения.
- Для переименования перенести реализацию в новую функцию, а старую оставить как обертку с вызовом deprecate_warn().
- Для замены (superseded) функции добавить бейдж и описание предпочтительной альтернативы без вывода предупреждений.
Примеры запросов агенту
Что понадобится
- R-пакет lifecycle
- R-пакет usethis
- R-пакет rlang
Описание составлено по SKILL.md навыка, сверено 05.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.