1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | create-release-checklist-posit-dev-skills |
| 作者/维护者 | Aaron Jacobs(Posit / posit-dev 组织工程师) |
| 来源链接 | https://github.com/posit-dev/skills/tree/main/open-source/create-release-checklist |
| 许可证 | MIT(GitHub API 获取) |
| GitHub Stars | 442(GitHub API 获取;数字属整个 posit-dev/skills 合集仓库,不代表本技能自身热度) |
| Forks | 35(同上,合集仓库整体数字) |
| 最新版本 | 1.0(SKILL.md front matter 标注) |
| 安装方式 | npx skills add / Claude Code 插件市场 / 手动复制目录(详见第 10 章) |
2. 功能介绍与亮点
该技能为 R 包维护者自动生成规范的发布检查清单,并直接创建对应的 GitHub Issue。核心流程:校验运行前提(项目根目录含 DESCRIPTION 文件、usethis R 包可用)→ 读取 DESCRIPTION 与 NEWS.md,根据变更内容中的关键词(如 “breaking”、“bug fixes”)智能建议本次应为 Major / Minor / Patch 发布 → 调用仓库自带的 generate_checklist.R 脚本生成初始清单 → 通过多轮问答让用户增删定制清单内容 → 若本机已安装并认证 gh CLI,则直接创建 GitHub Issue,否则展示清单供用户手动创建。
主要亮点:清单生成逻辑封装在可审计的 R 脚本中而非纯提示词猜测;对 gh CLI 不可用的场景有完整的人工兜底路径;官方 Posit 组织出品,所在仓库近期(2026-06-30)仍有提交,维护活跃。
3. 适用场景
固定分类:工程效率与代码质量
- R 包维护者准备发布新版本时,快速生成覆盖版本号选择、文档更新、NEWS.md 维护等环节的检查清单,避免遗漏
- 团队协作的开源项目中,把发布流程沉淀为可追踪的 GitHub Issue,替代口口相传的发布惯例
- 尤其适合遵循 tidyverse 风格发布规范、但尚未熟悉全部流程细节的新维护者
受益人群:R 包维护者、CRAN/GitHub 开源库贡献者、需要规范化版本发布流程的小型工程团队。
4. 跨 Agent 兼容性
- Claude Code:原生支持。SKILL.md 遵循标准 Agent Skills 规范,仓库 README 提供针对 Claude Code 的插件市场与手动安装路径;工作流中直接调用
AskUserQuestion交互工具完成版本类型确认与清单定制 - Codex:需适配。README 提到可通过
npx skills add(vercel-labs/skills 工具)安装到包括 Codex 在内的多种 Agent,但本技能工作流写死了AskUserQuestion(Claude Code 专有交互工具),迁移到 Codex 需要人工替换为等价的提问方式 - OpenClaw:未验证。已抓取材料未提及 OpenClaw 相关兼容性说明
- Hermes Agent:未验证。已抓取材料未提及 Hermes Agent 相关兼容性说明
5. 推荐理由
把 R 包发布前“该检查什么、该选哪种版本号”这类容易遗漏且因人而异的隐性经验,固化成一套可复用脚本加对话式确认流程,同时保留用户自定义空间;对独自或小团队维护 R 包的开发者来说,是一个即装即用、无需额外账号或付费依赖的效率工具。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 所属 posit-dev/skills 为合集仓库,442 stars 为整体数字不计入本技能;该子目录自身仅 2 次提交、1 个已合并 PR(10 条评审意见均来自仓库内部 Posit 工程师),暂未见第三方独立讨论 |
| 可用性 | 8 | SKILL.md 含完整分步工作流与版本号计算示例;仅依赖用户本机已有的 usethis R 包与 gh CLI,无需申请新凭据;仓库最近一次提交为 2026-06-30;gh 不可用时有清晰的人工兜底说明 |
| 安全性 | 9 | Posit 官方组织出品、完全开源可审计;唯一执行代码为仓库自带的 generate_checklist.R,唯一联网动作是通过用户自己已授权的 gh CLI 向自己仓库创建 Issue,用途透明;未见可疑指令 |
综合评分(三项均值)≈ 7.7
安全检查清单逐项结果:
① Shell 命令:仅调用 Rscript 执行仓库自带脚本与 gh CLI 创建 Issue,范围明确无任意命令执行 ② 联网外发:仅向用户自己的 GitHub 仓库写入 Issue,无第三方外发 ③ 凭据:复用用户本机已认证的 gh CLI,技能本身不索取也不存储任何新凭据 ④ 可疑指令:SKILL.md 全文未见提示注入或隐蔽指令迹象 ⑤ 作者信誉:作者为 Posit/RStudio 工程师,仓库无刷星或 SEO 操纵痕迹 ⑥ License:MIT,明确 ⑦ 维护时间:仓库整体持续维护,该子技能最近改动为 2026-02-20(补充元数据),在半年窗口内
7. 跟同类 Skills 相比的优势
| Skill / 工具 | 定位 | 与本技能的差异 |
|---|---|---|
usethis::use_release_issue()(R 生态原生函数) |
生成静态发布 checklist 模板并创建 Issue,是本技能显式对标的基线工具 | 无版本类型智能建议、不解析 NEWS.md 内容,也没有对话式定制环节 |
| pre-release(marcfargas/skills,4★) | 面向 npm/JS 生态的发布前检查清单技能,内置 AI 生成 changeset 与 npm Trusted Publishing 支持 | 服务生态是 JS/npm 而非 R/CRAN,侧重供应链溯源而非发布清单的可读性与协作 |
| asc-release-flow-rorkai-app-store-connect-cli-skills | 面向 iOS App Store Connect 的发布流程自动化 | 目标平台是移动应用商店发布,同属“发布流程自动化”主题但技术栈与受众完全不重叠 |
8. 用户评价
该技能目前在第三方平台尚无独立、具名的用户评价;唯一的公开评审记录来自代码仓库自身的 Pull Request(评审人为项目内部工程师,非外部使用者反馈)。
9. 安装使用方式
方式一:npx skills add(跨 Agent 通用 CLI)
npx skills add posit-dev/skills --skill create-release-checklist
方式二:Claude Code 插件市场
/plugin marketplace add posit-dev/skills
/plugin install open-source@posit-dev-skills
方式三:手动安装
git clone https://github.com/posit-dev/skills.git
cp -r skills/open-source/create-release-checklist ~/.claude/skills/
安装后无需重启。在含 DESCRIPTION 文件的 R 包项目根目录下,向 Claude 提出“创建发布检查清单”或 “start a release” 等请求即可触发;若本机 gh CLI 已安装并认证,会直接创建 GitHub Issue,否则展示清单供手动创建。
10. 注意事项
- 仅支持 R 包(要求项目根目录存在
DESCRIPTION文件),不适用于 Python、JS 等其他语言包的发布流程 - 自动创建 GitHub Issue 依赖用户本机已认证的
ghCLI;未安装或未认证时会降级为纯展示模式,需手动创建 Issue - 版本类型(Major/Minor/Patch)建议基于
NEWS.md关键词的简单规则判断,遇到复杂变更时仍需人工复核建议是否准确 - 该子技能目前第三方独立讨论证据有限,长期维护活跃度值得持续观察