1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | lifecycle-posit-dev-skills |
| 作者/维护者 | Posit PBC（posit-dev 官方组织）；本技能主要撰写与维护者为 Garrick Aden-Buie（@gadenbuie） |
| 来源链接 | https://github.com/posit-dev/skills/tree/main/r-lib/lifecycle |
| 许可证 | MIT（GitHub API 数据） |
| GitHub Stars | 443（GitHub API 数据；为合集仓库整体数字，不代表本技能自身热度） |
| Forks | 35（GitHub API 数据，合集仓库整体） |
| 最新版本 | SKILL.md 元数据标注 version 1.1 |
| 安装方式 | npx skills add、Claude Code 插件市场、或手动复制子目录 |
2. 功能介绍与亮点
这是一份指导如何按 tidyverse 规范管理 R 包函数生命周期的技能，覆盖：一键搭建生命周期徽章基础设施（usethis::use_lifecycle()）；experimental/deprecated/superseded 状态徽章标注；deprecate_soft → deprecate_warn → deprecate_stop 三段式废弃流程；函数与参数改名的过渡期写法；“有更优替代但不移除”场景的文档写法；复杂场景（如批量废弃某公共参数）的自定义废弃助手代码；废弃行为本身的 testthat 快照测试写法。
亮点：内容完全由可直接复制的 R 代码片段组成，各场景均配真实示例；由 Posit 官方持续维护至 2026-06-16；附带独立参考文档 references/lifecycle-stages.md。
3. 适用场景
所属分类：工程效率与代码质量
面向维护 R 包（尤其遵循 tidyverse 设计哲学的开源或内部包）的开发者：导出函数需要废弃但不能让下游代码无预警报错、函数改名需保留旧接口过渡期、给功能标注“实验性”、大版本升级前批量清理已到期的废弃函数。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 README 提供两条原生安装路径：/plugin marketplace add posit-dev/skills 插件市场安装，以及 npx skills add 通用安装 |
| Codex | 需适配 | 通过第三方分发工具 vercel-labs/skills 的 npx skills add 安装；该工具源码 src/agents.ts 明确定义 codex 目标（写入 ~/.codex/skills），非仓库原生集成 |
| OpenClaw | 需适配 | 同一分发工具源码明确定义 openclaw 目标（写入 ~/.openclaw/skills），同样依赖第三方安装器而非仓库原生支持 |
| Hermes Agent | 需适配 | 同一分发工具源码明确定义 hermes-agent 目标（读取 HERMES_HOME 环境变量定位技能目录），同样依赖第三方安装器 |
5. 推荐理由
废弃或重命名已发布的导出函数是 R 包维护者最容易踩坑的动作——处理不当会让下游代码无预警报错。本技能把 tidyverse 公认的 lifecycle 规范拆解成开箱即用的 R 代码模板，官方持续维护，无需额外配置或付费依赖。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 属官方多技能合集仓库中的独立子目录，合集整体 stars 不计入个体热度；子目录自身由具名 Posit 工程师约 5 个月内分 5 次提交持续维护，未查到合集之外的第三方 PR 或 issue 讨论 |
| 可用性 | 9 | 一条 npx skills add 命令或 Claude Code 插件市场即可安装；四类场景均给出可直接运行的 R 代码示例；近两个月内仍有维护提交；无付费依赖 |
| 安全性 | 9 | 纯知识/文档类技能，给出供开发者手动执行的 R 代码建议，不含可自动执行的外部脚本，不联网、不需要凭据；MIT 许可，内容开源可审计 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 无 shell 命令；仅提供 R 函数调用建议，需开发者手动执行 |
| ② 运行时联网外发 | 无 |
| ③ API Key/凭据 | 不涉及 |
| ④ 可疑指令 | 未发现 prompt injection 或混淆代码迹象 |
| ⑤ 作者/组织信誉 | Posit PBC 官方组织出品，撰写者为可查证的具名工程师 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护时间 | 2026-06-16，非弃置项目 |
7. 跟同类 Skills 相比的优势
同一官方仓库内还有几个覆盖 R 包开发其他环节的技能，可用于理解本技能的定位差异：
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| r-package-development | 覆盖 devtools/testthat/roxygen2 的整体 R 包开发工作流 | 是更宽泛的“全流程”指南，不专门处理 API 废弃/重命名的 tidyverse 规范细节 |
| testing-r-packages | 专注 testthat 3+ 的测试写法（结构、期望、快照、mock） | 处理“如何测试”，与本技能“如何管理 API 生命周期”是两个不同环节 |
| cli | 专注 cli 包的命令行输出与消息样式 | 解决用户交互展示问题，与函数废弃/重命名流程无关 |
本技能是其中唯一专门针对“已发布 API 如何优雅退场”给出完整代码模板的一份。
8. 用户评价
该技能目前在第三方平台尚无独立具名用户评价。其所在的官方合集仓库 posit-dev/skills 有 443 枚星标、35 次 fork 与 14 位具名贡献者。
9. 其他补充
正文之外附带独立参考文件 references/lifecycle-stages.md，补充生命周期各阶段的详细定义与转换规则。技能内容仅覆盖 R 语言生态，未提供其他语言版本。
10. 安装使用方式
方式一：通用安装器（适用于 Claude Code / Codex / OpenClaw / Hermes Agent）
npx skills add posit-dev/skills --skill lifecycle方式二：Claude Code 插件市场
/plugin marketplace add posit-dev/skills
/plugin install r-lib@posit-dev-skills方式三：手动安装
git clone https://github.com/posit-dev/skills.git
cp -r skills/r-lib/lifecycle ~/.claude/skills/安装后无需重启，检测到 R 包废弃/重命名/生命周期标注任务时自动触发。建议先执行 usethis::use_lifecycle() 完成 lifecycle 依赖初始化。
11. 注意事项
- 仅适用于 R 语言生态。
- 依赖
lifecycleR 包，需在DESCRIPTION中声明依赖并完成初始化配置后才能正常渲染徽章。 - 维护证据主要来自单一具名工程师的持续提交，规模小于同仓库部分姊妹技能。
- 属于官方多技能合集仓库的一部分，安装时需选择
r-lib分类。