К основному содержанию
скилл CX Codex

r-lifecycle — скилл для Claude Code: что делает и как установить

Скилл r-lifecycle для Claude Code помогает управлять жизненным циклом функций и аргументов в пакетах на R. Ассистент настраивает предупреждения по стандартам tidyverse и обновляет roxygen2-документацию.

MIT 149 установок ★ 574 обновлён 2026-10-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add posit-dev/skills --skill r-lifecycle -a claude-code
Открыть на GitHub

Что делает r-lifecycle

Скилл инструктирует агента по работе с библиотекой lifecycle в проектах на R. Он задаёт правила добавления бейджей в roxygen2-блоки, оформление устаревших функций и вызов предупреждений через deprecate_soft(), deprecate_warn() или deprecate_stop().

Для переименования аргументов скилл применяет маркер по умолчанию deprecated() и проверку lifecycle::is_present(). В код тестов добавляются моментальные снимки expect_snapshot() и подавление предупреждений через опцию lifecycle_verbosity = "quiet".

Для работы требуются установленные R-пакеты lifecycle и usethis. Без инициализации через usethis::use_lifecycle() в каталоге man/figures/ будут отсутствовать SVG-файлы бейджей.

Какие задачи решает

  • перевести устаревшие функции R-пакета на lifecycle::deprecate_warn()
  • настроить бейджи стадий API в документации roxygen2
  • переименовать аргументы функции с сохранением обратной совместимости
  • написать тесты для проверки предупреждений об устаревании

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

  • Пометь функцию calculate_old() как устаревшую и предложи calculate_new() взамен
  • Настрой структуру пакета для использования lifecycle через usethis
  • Замени аргумент na.rm на na_rm в функции с мягким предупреждением

Как установить r-lifecycle

1Через Skills CLI (Vercel)

npx skills add posit-dev/skills --skill r-lifecycle -a claude-code

2Вручную: положить файлы

~/.claude/skills/r-lifecycle/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/r-lifecycle/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о r-lifecycle

Как установить r-lifecycle в Claude Code?

Выполните команду npx skills add posit-dev/skills --skill r-lifecycle -a claude-code.

Какие стадии жизненного цикла поддерживает r-lifecycle?

Скилл описывает работу со статусами experimental, deprecated и superseded, а также трёхступенчатый переход функций от deprecate_soft() до полного удаления.

Что нужно для работы r-lifecycle?

Требуются установленные пакеты lifecycle и usethis в среде разработки R, а также roxygen2 для генерации документации.

Исходный текст

SKILL.md · MIT
---
name: r-lifecycle
description: "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) Writing deprecation helpers for complex scenarios."
metadata:
  author: Garrick Aden-Buie (@gadenbuie)
  version: "1.1"
license: MIT
---

# R Package Lifecycle Management

Manage function and argument lifecycle using tidyverse conventions and the lifecycle package.

## Setup

Check if lifecycle is configured by looking for `lifecycle-*.svg` files in `man/figures/`.

If not configured, run:

```r
usethis::use_lifecycle()
```

This:

- Adds lifecycle to `Imports` in DESCRIPTION
- Adds `@importFrom lifecycle deprecated` to the package documentation file
- Copies badge SVGs to `man/figures/`

## Lifecycle Badges

Insert badges in roxygen2 documentation:

```r
#' @description
#' `r lifecycle::badge("experimental")`
#' `r lifecycle::badge("deprecated")`
#' `r lifecycle::badge("superseded")`
```

For arguments:

```r
#' @param old_arg `r lifecycle::badge("deprecated")` Use `new_arg` instead.
```

Only badge functions/arguments whose stage differs from the package's overall stage.

## Deprecating a Function

1. Add badge and explanation to `@description`:

```r
#' Do something
#'
#' @description
#' `r lifecycle::badge("deprecated")`
#'
#' `old_fun()` was deprecated in mypkg 1.0.0. Use [new_fun()] instead.
#' @keywords internal
```

2. Add `deprecate_warn()` as first line of function body:

```r
old_fun <- function(x) {

lifecycle::deprecate_warn("1.0.0", "old_fun()", "new_fun()")
new_fun(x)
}
```

3. Show migration in examples:

```r
#' @examples
#' old_fun(x)
#' # ->
#' new_fun(x)
```

## Deprecation Functions

| Function           | When to Use                                             |
| ------------------ | ------------------------------------------------------- |
| `deprecate_soft()` | First stage; warns only direct users and during tests   |
| `deprecate_warn()` | Standard deprecation; warns once per 8 hours            |
| `deprecate_stop()` | Final stage before removal; errors with helpful message |

**Deprecation workflow for major releases:**

1. Search `deprecate_stop()` - consider removing function entirely
2. Replace `deprecate_warn()` with `deprecate_stop()`
3. Replace `deprecate_soft()` with `deprecate_warn()`

## Renaming a Function

Move implementation to new name, call from old name with deprecation:

```r
#' @description
#' `r lifecycle::badge("deprecated")`
#'
#' `add_two()` was renamed to `number_add()` for API consistency.
#' @keywords internal
#' @export
add_two <- function(x, y) {
lifecycle::deprecate_warn("1.0.0", "add_two()", "number_add()")
number_add(x, y)
}

#' Add two numbers
#' @export
number_add <- function(x, y) {
x + y
}
```

## Deprecating an Argument

Use `deprecated()` as default value with `is_present()` check:

```r
#' @param path `r lifecycle::badge("deprecated")` Use `file` instead.
write_file <- function(x, file, path = deprecated()) {
  if (lifecycle::is_present(path)) {
    lifecycle::deprecate_warn("1.4.0", "write_file(path)", "write_file(file)")
    file <- path
  }
  # ... rest of function
}
```

## Renaming an Argument

```r
add_two <- function(x, y, na_rm = TRUE, na.rm = deprecated()) {
  if (lifecycle::is_present(na.rm)) {
    lifecycle::deprecate_warn("1.0.0", "add_two(na.rm)", "add_two(na_rm)")
    na_rm <- na.rm
  }
  sum(x, y, na.rm = na_rm)
}
```

## Superseding a Function

For functions with better alternatives that shouldn't be removed:

```r
#' Gather columns into key-value pairs
#'
#' @description
#' `r lifecycle::badge("superseded")`
#'
#' Development on `gather()` is complete. For new code, use [pivot_longer()].
#'
#' `df %>% gather("key", "value", x, y, z)` is equivalent to
#' `df %>% pivot_longer(c(x, y, z), names_to = "key", values_to = "value")`.
```

No warning needed - just document the preferred alternative.

## Marking as Experimental

```r
#' @description
#' `r lifecycle::badge("experimental")`
cool_function <- function() {
  lifecycle::signal_stage("experimental", "cool_function()")
  # ...
}
```

## Testing Deprecations

Test that deprecated functions work and warn appropriately:

```r
test_that("old_fun is deprecated", {
  expect_snapshot({
    x <- old_fun(1)
    expect_equal(x, expected_value)
  })
})
```

Suppress warnings in existing tests:

```r
test_that("old_fun returns correct value", {
  withr::local_options(lifecycle_verbosity = "quiet")
  expect_equal(old_fun(1), expected_value)
})
```

## Deprecation Helpers

For deprecations affecting many functions (e.g., removing a common argument), create an internal helper:

```r
warn_for_verbose <- function(
  verbose = TRUE,
  env = rlang::caller_env(),
  user_env = rlang::caller_env(2)
) {
  if (!lifecycle::is_present(verbose) || isTRUE(verbose)) {
    return(invisible())
  }

  lifecycle::deprecate_warn(
    when = "2.0.0",
    what = I("The `verbose` argument"),
    details = c(
      "Set `options(mypkg_quiet = TRUE)` to suppress messages.",
      "The `verbose` argument will be removed in a future release."
    ),
    user_env = user_env
  )

  invisible()
}
```

Then use in affected functions:

```r
my_function <- function(..., verbose = deprecated()) {
  warn_for_verbose(verbose)
  # ...
}
```

## Custom Deprecation Messages

For non-standard deprecations, use `I()` to wrap custom text:

```r
lifecycle::deprecate_warn(
  when = "1.0.0",
  what = I('Setting option "pkg.opt" to "foo"'),
  with = I('"pkg.new_opt"')
)
```

The `what` fragment must work with "was deprecated in..." appended.

## Reference

See `references/lifecycle-stages.md` for detailed stage definitions and transitions.

© Garrick Aden-Buie (@gadenbuie) · MIT · posit-dev/skills

Похожие скиллы

Все скиллы по теме «Языки программирования» →
laravel-php-83-cursorrules-prompt-file PatrickJS Правило laravel-php-83-cursorrules-prompt-file для Cursor, которое ведёт агента по разработке пакетов Laravel: структура, стандарты кода, тесты и документация. CX Codex +1 ★ 41 178звёзд репо r-expert personamanagmentlayer Скилл r-expert для Claude Code переводит агента в режим эксперта по R. Включается при статистическом анализе, визуализации в ggplot2 и работе с tidyverse. CX Codex +1 328установок r официальный github Задаёт стиль генерации кода на R: выбирает между tidyverse и base R, устанавливает конвенции по неймингу, безопасности и инструментам. Действует на .R, .Rmd и .qmd файлы в репозитории. CX Codex +1 ★ 41 430звёзд репо r-cursorrules-prompt-file-best-practices PatrickJS Правило r-cursorrules-prompt-file-best-practices задаёт стандарты разработки на R: структуру каталогов, стиль tidyverse, изоляцию окружения через renv и правила оформления пакетов. CX Codex +1 ★ 41 178звёзд репо review-r pedrohcgs Скилл review-r проверяет скрипты на языке R на стиль tidyverse, воспроизводимость и стандарты оформления. Создаёт отчёт с ошибками, не меняя исходные файлы. CX Codex +1 ★ 1 729звёзд репо m12-lifecycle actionbook Скилл m12-lifecycle для Claude Code помогает выбирать, когда создавать ресурс и как освобождать его. Подключается при проектировании RAII, пулов соединений и ленивой инициализации в Rust. CX Codex +1 3 700установок

Из того же набора30

Весь набор →
r-cran-status Скилл r-cran-status проверяет состояние R-пакета на cran.r-project.org: где он в очереди ревью, принят или отклонён, проходит ли R CMD check на всех платформах. CX Codex +1 227установок r-testthat Скилл r-testthat для Claude Code помогает писать и упорядочивать тесты R-пакетов с testthat версии 3 и выше. Агент подключает его при создании тестов или доработке существующих. CX Codex +1 182установок r-tidyverse-style Скилл r-tidyverse-style для Claude Code проверяет и форматирует код пакетов на R по гайдлайну tidyverse. Включается при запросе на ревью оформления или написании нового кода пакета. CX Codex +1 177установок r-cli Скилл r-cli для Claude Code помогает оформлять консольный интерфейс в R-пакетах через библиотеку cli. Включается при замене base R сообщений, настройке прогресс-баров и форматировании ошибок. CX Codex +1 151установок r-mirai Скилл r-mirai для Claude Code помогает писать R-код для асинхронных и параллельных вычислений через mirai. Включается при настройке воркеров, переносе кода с future или parallel и работе с mirai_map. CX Codex +1 148установок r-cran-extrachecks Скилл r-cran-extrachecks для Claude Code проверяет R-пакет перед отправкой в CRAN на требования, которые пропускает devtools::check(). Запускается при подготовке первой публикации, повторной отправке или разборе замечаний ревьюера. CX Codex +1 144установок shiny-r-optimize Скилл shiny-r-optimize для Claude Code находит причины медленной работы приложений Shiny for R и предлагает правки. Запускается при зависаниях, лишних пересчётах и росте числа пользователей. CX Codex +1 123установок shiny-py-optimize Скилл shiny-py-optimize для Claude Code находит и исправляет причины медленной работы приложений Shiny for Python. Включается при зависаниях, долгой загрузке или частых пересчётах. CX Codex +1 116установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой