posit-dev/skills · 上手攻略
- 仓库：posit-dev/skills
- 链接：https://github.com/posit-dev/skills
- 分类：developer-tool
- 作者：Tom
- 更新：2026-08-10
这是什么
posit-dev/skills 是 Posit 公司（RStudio 背后的公司）维护的 Claude Skills 集合，面向使用 Claude Code（或支持 Claude Skills 协议的其他 AI 编程助手）进行日常开发的工程师。涵盖代码审查、GitHub PR 工作流、R/Python 包开发、Shiny 应用、Quarto 文档写作、Posit Connect 部署等完整开发链条。
skill 以 SKILL.md 为核心，附带 references/ 参考文档和示例 agent 配置 YAML，Claude 根据任务描述自动激活对应 skill，无须手动调用指令。
解决什么问题
AI 编程助手本身通用能力强，但缺乏垂直领域的深度工作流指导。比如： - 让 AI 做代码审查，它可能只做表面语法检查，不会深入安全漏洞、测试边界、accessibility - 让 AI 帮你写 release blog，它不知道 Tidyverse 博客的格式规范 - 让 AI 创建 PR，它不懂 r-lib 生态的 changelog 惯例和 CRAN 提交流程
posit-dev/skills 把这些领域专家级经验编码进 Skill，让 Claude 在正确时机激活正确知识，输出符合 Posit / R 生态规范的产出。
快速安装
推荐方式：npx skills add（支持 Claude Code / Codex / Cursor / Cline 等）
# 列出所有可用 skills（不安装）
npx skills add posit-dev/skills --list
# 交互式菜单选择安装
npx skills add posit-dev/skills --all
# 按分类安装特定 skills
npx skills add posit-dev/skills --skill cli --skill lifecycle --skill review-testing
Claude Code 内置 marketplace（最方便）
/plugin marketplace add posit-dev/skills
之后在 Claude Code UI 中浏览和安装各分类 skill。
按分类安装（通过 plugin 命令）
/plugin install posit-dev@posit-dev-skills # 通用开发 skill（critical-code-reviewer、describe-design 等）
/plugin install github@posit-dev-skills # GitHub PR 工作流
/plugin install open-source@posit-dev-skills # 开源包发布流程
/plugin install r-lib@posit-dev-skills # R 包开发（r-lib 生态）
/plugin install shiny@posit-dev-skills # Shiny 应用开发
/plugin install quarto@posit-dev-skills # Quarto 文档写作
/plugin install connect@posit-dev-skills # Posit Connect 部署
/plugin install ggsql@posit-dev-skills # ggsql SQL 可视化查询
手动克隆（离线 / 自定义场景）
git clone https://github.com/posit-dev/skills.git
cd skills
# 安装单个 skill 到 Claude Code
cp -r posit-dev/critical-code-reviewer ~/.config/claude-code/skills/
# 或按分类安装所有
for skill in open-source/*/; do
cp -r "$skill" ~/.config/claude-code/skills/
done
Skill 分类一览
posit-dev（通用开发，5 个）
| Skill | 触发时机 | 核心能力 |
|---|---|---|
critical-code-reviewer |
要求代码审查 / PR review | 深度安全/边界/ accessibility 检查，对每个发现要求证据，不接受"代码风格偏好"作为 Blocking |
describe-design |
要求理解代码库架构 / 创建文档 | Mermaid 架构图 + 稳定代码引用，生成人和 AI 均可读的文档 |
new-work |
开始新功能 / bug / 任务 | 创建 todo 追踪文档，持续更新决策和进度 |
review-testing |
修复后 review 测试代码 | assertion 完整性、mock 边界、fixture 设计、覆盖率缺口 |
working-on |
已有追踪文档，设为当前 session 依据 | 保持追踪文档更新，同步决策与进度 |
github（GitHub PR 工作流）
| Skill | 触发时机 |
|---|---|
pr-create |
创建 PR 并监控 CI直到通过 |
pr-threads-address |
review 所有未解决 threads 并改代码 commit |
pr-threads-resolve |
批量 resolve 已解决的 review threads |
open-source（R/Python 开源包发布）
| Skill | 触发时机 |
|---|---|
create-release-checklist |
准备发布 R 包，创建 checklist + GitHub issue，含自动版本计算 |
release-post |
写 Tidyverse / Shiny 规范的 release blog，支持 R 和 Python 包 |
r-lib（R 包开发）
| Skill | 覆盖范围 |
|---|---|
testing-r-packages |
testthat 3+ 最佳实践（fixtures、snapshots、mock、BDD 风格） |
cli |
R 的 cli 包完整指南（语义消息、进度条、theming） |
cran-extrachecks |
CRAN 提交前检查（devtools::check() 覆盖不到的文档/格式/URL 规范） |
lifecycle |
tidyverse lifecycle 包管理（deprecation、superseding、experimental） |
r-package-development |
devtools + testthat + roxygen2 完整工作流 |
mirai |
异步并行计算（R mirai 包，对标 future/parallel） |
shiny（Shiny 应用开发）
| Skill | 覆盖范围 |
|---|---|
brand-yml |
创建和应用 brand.yml，统一 Shiny（R/Python）样式 |
shiny-bslib |
bslib 构建 modern Shiny dashboard（Bootstrap 5 布局、cards、theming） |
shiny-bslib-theming |
bslib 完整主题系统（bs_theme()、Bootswatch、自定义 Sass、暗色模式） |
quarto（Quarto 文档）
| Skill | 覆盖范围 |
|---|---|
authoring |
Quarto 写作最佳实践、R Markdown 迁移、交叉引用、callouts |
alt-text |
数据可视化 alt text 生成（三段式：图表类型+数据描述+关键洞察） |
connect（Posit Connect 部署）
| Skill | 覆盖范围 |
|---|---|
deploy-to-connect |
用 rsconnect-python / R rsconnect 部署到 Posit Connect（含 app/api/doc/rendered 四类） |
核心 Skill 详解：critical-code-reviewer
这是 posit-dev/skills 中最具代表性的 Skill，由 Posit 工程师 Garrick Aden-Buie 编写，版本 1.2，MIT 许可。触发方式：让 Claude 做 critical code review 或 review a PR。
审查广度：Python、R、JavaScript/TypeScript、SQL、前端代码全覆盖。
审查原则（与普通 AI review 的核心差异）：
Assume every line of code is broken, inefficient, or lazy
until it demonstrates otherwise.
分层审查逻辑：
1. 安全 / 边界：空值、恶意输入、异步竞态、错误被吞
2. 正确性：类型边界、序列化、API 契约
3. Accessibility：不只是有无 alt 属性，而是验证 alt 内容在上下文是否有意义
4. 可维护性：反对明显的注释（// increment counter above）、懒惰命名（data、temp）、超长文件（React >500 行）
5. 测试质量：mock 边界、fixture 设计、覆盖率缺口
输出分级：每个发现标记为 Blocking（核心任务受阻）/ Verify（需要更多信息验证）/ Suggestion（改进建议），不混用。
典型使用场景
| 场景 | 推荐 Skill |
|---|---|
| review 别人的 PR，重点查安全和边界 | critical-code-reviewer |
| 接手陌生代码库，要写架构文档 | describe-design |
| r-lib 包准备 CRAN 提交前自检 | r-lib/cran-extrachecks + r-lib/lifecycle |
| 用 bslib 重构 legacy Shiny dashboard | shiny/shiny-bslib + shiny/shiny-bslib-theming |
| Quarto 迁移旧 R Markdown 项目 | quarto/authoring |
| 创建新的 Shiny R 包并写 release post | open-source/create-release-checklist + open-source/release-post |
| 多轮 PR review，批量 resolve threads | github/pr-threads-resolve |
| 部署 ML model API 到 Posit Connect | connect/deploy-to-connect |
坑与注意
critical-code-reviewer是"建设性 brutal"而非"找茬"：它要求证据，对每个发现要求能复现的失败场景和具体修复建议，不接受"我觉得这里不好"作为 Finding。- Skill 版本追踪：当前
critical-code-reviewer为 v1.2（MIT，Garrick Aden-Buie），其他 Skill 尚无显式版本号，引用时建议注明 commit SHA。 - npx skills add 需要网络：离线环境请用 git clone + 手动复制方式。
- 不是所有 Skill 都在 Claude Code 默认 marketplace 可索引：部分 Skill（如 ggsql）需要通过 plugin 命令显式安装。
- Skill 仓库 2025 年初建，持续更新中：建议定期
git pull获取新 Skill 和规则更新。 - Shiny bslib Skill 依赖 bslib R 包（≥0.5.0 推荐），代码生成结果需要 R ≥4.1 环境验证。
与同类对比
| 方案 | 定位 | 优势 | 局限 |
|---|---|---|---|
| posit-dev/skills | Claude Code Skill 集 | Posit 工程师经验、R/Python 生态深度集成 | 主要面向 R/Python 开发者，JS/前端支持较弱 |
| anthropic/skills（官方） | Anthropic 维护的官方 Skill 集 | Claude 原生集成、覆盖日常场景 | 垂直领域深度不如 Posit |
| vercel-labs/skills | Vercel 部署相关 Skill | Next.js/部署工作流深度集成 | 不覆盖 R/Python 包开发 |
| 手工 Code Review | 人工 review | 最深入、无上下文丢失 | 耗时、不scalable |
| SonarQube 等静态分析工具 | 自动扫描 | 快、无需人工介入 | 无架构层级分析、无法理解业务意图 |
posit-dev/skills 的核心差异化：不是通用 AI 代码审查，而是带 R/Python 生态专家知识图谱的 Code Review Skill——critical-code-reviewer 的 accessibility 审查和 cran-extrachecks 的 CRAN 提交检查，是其他任何通用 Skill 都没有的。
一句话推荐结论
如果你是 R/Python 数据工程师或 Shiny 应用开发者，用 Claude Code 写代码，posit-dev/skills 是目前 R/Python 生态里经验密度最高的 Skill 合集——特别是 critical-code-reviewer 和 cran-extrachecks，分别把资深工程师的审查直觉和 CRAN submission 硬骨头编码成了可自动化触发的流程。