AIKraft/Skills/Жизненный цикл

Жизненный цикл

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

PPPosit, PBC official Другое

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

Управление жизненным циклом функций и аргументов R-пакетов в соответствии с принципами tidyverse с использованием пакета lifecycle. Позволяет помечать элементы как экспериментальные, устаревшие или замененные, обеспечивая плавный переход пользователей на новые API.

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

  • Настройка инфраструктуры жизненного цикла в пакете (добавление бейджей и импортов).
  • Устаревание (deprecated) функций или аргументов с выводом предупреждений.
  • Переименование функций или аргументов с сохранением обратной совместимости.
  • Замена (superseded) функций на альтернативы без удаления старых.
  • Пометка функций как экспериментальных (experimental).

Как работает

  1. Проверить наличие файлов lifecycle-*.svg в man/figures/; если нет, запустить usethis::use_lifecycle() для настройки DESCRIPTION и документации.
  2. Вставить соответствующие бейджи (experimental, deprecated, superseded) в roxygen2-документацию функций или аргументов.
  3. Для устаревания функции добавить вызов lifecycle::deprecate_warn() (или deprecate_soft()/deprecate_stop()) в начало тела функции и обновить описание.
  4. Для устаревания аргумента использовать значение deprecated() по умолчанию и проверку lifecycle::is_present() для вывода предупреждения.
  5. Для переименования перенести реализацию в новую функцию, а старую оставить как обертку с вызовом deprecate_warn().
  6. Для замены (superseded) функции добавить бейдж и описание предпочтительной альтернативы без вывода предупреждений.

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

Как пометить функцию как устаревшую и настроить вывод предупреждения при её вызове?
Как переименовать аргумент функции с сохранением обратной совместимости и уведомлением пользователя?
Как настроить инфраструктуру жизненного цикла в новом R-пакете с помощью usethis?

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

  • R-пакет lifecycle
  • R-пакет usethis
  • R-пакет rlang

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

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

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

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