Agent Skills: R 代码风格

编写、生成、修改、补充、优化 R 代码时使用此 skill。凡是用户请求涉及 R 语言脚本、R 分析代码、R 可视化代码、R 数据处理代码,或者用户说"用 R 写"、"R 代码"、"写个 R 脚本"时,必须遵循本 skill 的风格规范。

UncategorizedID: victory-hugo/s2-agent-skill/r-style

Install this agent skill to your local

pnpm dlx add-skill https://github.com/Victory-Hugo/S2-Agent-Skill/tree/HEAD/skills/code/%E8%87%AA%E5%88%B6/r-style

Skill Files

Browse the full folder contents for r-style.

Download Skill

Loading file tree…

skills/code/自制/r-style/SKILL.md

Skill Metadata

Name
r-style
Description
撰写R脚本必须遵循本规范,开发包除外。

R 代码风格

1. 线性执行

代码从上到下顺序执行,不封装函数。图形逐层保存为 pp2p3 等。

2. 注释格式

功能区块:

#* =====区块名称=====

步骤说明使用中文普通注释,并以动词开头:

# 读取数据
# 绘制基础图形

参数含义使用行末 #* 注释:

fill = Group, #* 填充颜色对应 Group 列
size = 3      #* 点大小

3. 数据处理

读取数据后使用 knitr::kable(head(df1)) 预览,再直接进行后续处理,不封装数据读取逻辑。

4. 变量命名

  • 图形:pp2p3
  • 数据框:df1df2df3
  • 多词变量:使用下划线连接

5. 包加载

所有 library() 放在脚本顶部,每行一个,不添加注释。

6. PDF 出图

需要导出可在 Illustrator 中逐标签独立编辑的 PDF 时:

  • 使用 grDevices::pdf(..., family = "Arial", useDingbats = FALSE)
  • 使用项目内注册的 Arial AFM 字体度量
  • 不使用 cairo_pdf(),避免连续文字被合并到同一 BT...ET 文本对象
  • 验收要求:BaseFont/Arial,且每个 BT...ET 中最多包含一个 TjTJ

7. 输出要求

  • 直接输出代码
  • 代码按顺序可执行
  • 不使用 main()tryCatch()invisible() 或自定义函数,除非用户明确要求
  • 说明内容优先写入代码注释,不在代码块外长篇解释