Posit Agent Skills

它是什么 – 一个精选的 Agent Skills 集合 – 可重用、与语言模型无关的插件，扩展编码助手（Claude Code、Cursor、Posit Assistant 等）的领域特定知识和工作流。每个技能都是一小组自包含的提示、模板和辅助脚本，当您处理相关任务时，助手可以自动调用它们。

核心概念

Agent Skills 是一个开放规范（参见 https://agentskills.io），用于描述编码助手应如何执行特定工作（例如，创建 GitHub PR、撰写发布博客文章、样式化 Shiny 应用）。
Posit Dev 提供了一个公开的现成技能仓库，涵盖常见的开发活动，特别是针对 R 生态系统和通用软件工程。
当技能安装后，助手会检测上下文（文件类型、项目布局、用户请求）并运行技能，而无需用户输入特殊命令。

包含什么？

类别	示例技能	它们做什么
posit-dev	`critical-code-reviewer`, `describe-design`, `new-work`	通用开发辅助 – 对抗性代码审查、自动架构文档、会话级待办跟踪。
github	`pr-create`, `pr-threads-address`, `pr-threads-resolve`	自动化拉取请求创建、监控 CI、批量解决审查线程。
open-source	`create-release-checklist`, `release-post`	为 R/Python 包构建发布检查清单和可发布的博客文章。
r-lib	`r-tidyverse-style`, `r-testthat`, `r-cran-extrachecks`, …	R 包中心辅助 – 样式强制、测试最佳实践、CRAN 预检检查、生命周期管理、使用 mirai 的异步计算等。
ggsql	`ggsql`	编写“图形语法风格”的 SQL 查询，适用于数据可视化管道。
shiny	`shiny-bslib`, `shiny-bslib-theming`, `brand-yml`	为 Shiny 应用（R 和 Python）构建现代 UI、主题和品牌。
quarto	`authoring`, `brand-yml`, `alt-text`	Quarto 文档的写作指导、品牌和可访问性替代文本生成。
connect	`deploy-to-connect`	将 R 或 Python 内容部署到 Posit Connect 服务器。

每个技能都位于自己的文件夹中，带有 README，解释提示、任何必需的模板以及助手应如何呈现功能。

安装技能

该仓库遵循 Agent Skills CLI（npx skills add）。典型工作流：

# 列出所有内容而不安装
npx skills add posit-dev/skills --list

# 交互式安装所有技能
npx skills add posit-dev/skills --all

# 仅安装几个技能（例如，从 r-lib 类别）
npx skills add posit-dev/skills --skill r-tidyverse-style --skill r-testthat

您可以针对特定助手：

--agent posit-assistant – 将技能复制到 Posit Assistant 目录（~/.posit/assistant/skills/）。
--agent claude-code – 安装到 Claude Code 的技能文件夹。
省略 --agent 以安装到通用的 ~/.agents/skills/ 位置，适用于任何遵循规范的 harness。

对于 Claude Code，有三种支持的方法（市场添加、直接安装或手动复制）– 最终都是将技能目录复制到代理的技能路径。

如何使用它们

安装后，助手会监视您的提示和您编辑的文件。当它检测到相关情况（例如，您问“帮我为 dplyr 1.2.0 写一篇发布文章”或您打开一个 CI 失败的 PR）时，它会自动激活匹配的技能并指导您完成步骤。安装后无需额外的命令行工作。

谁应该关注？

开发人员 使用 AI 编码助手，并希望为日常任务（代码审查、PR 处理、包发布等）提供可靠、可重复的辅助。
数据科学团队 依赖 Posit 栈（R、Shiny、Quarto、Connect），并希望他们的助手理解领域特定的约定。
团队负责人 / DevOps 希望通过 AI 标准化整个组织的 CI/PR 工作流。
贡献者 有兴趣扩展 Agent Skills 生态系统 – 该仓库包含贡献指南，并推荐使用 Anthropic 的 skill-creator 工具来构建新技能。

许可证与社区

根据 MIT 许可证授权 – 免费用于商业和非商业用途。
开放问题跟踪器用于错误和功能请求。
欢迎贡献；CONTRIBUTING.md 解释了如何添加新技能或改进现有技能。

底线 – Posit Dev 的 skills 仓库是一个实用、符合标准的工具箱，让您将 AI 编码助手转变为日常开发的专门队友，尤其是在 R/Posit 生态系统中。