# Section Intro Guide

> 为本仓库新建、重写或审校 R 入门指南、学习路线、基础概念和首次上手教程。适用于 `doc/00xx-*.rmd`、`doc/00xx-*.qmd` 与入门指南栏目；先用 `tutorial-authoring`，再按主题调用对应 R、文档或视觉 skill。不用于把进阶统计方法强行简化成零基础文章。

- Skill: `kangwang42/section-intro-guide` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add kangwang42/section-intro-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kangwang42/section-intro-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kangwang42 (https://skillmd.com/u/kangwang42)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kangwang42/section-intro-guide

---


# R 入门指南

## 开工

1. 先执行 `tutorial-authoring`，完整读取其质量标准，再读取 [content-structure.md](references/content-structure.md)。
2. 明确读者已经会什么、读完要完成什么任务，以及可用于练习的最小数据或文件。
3. 新建文章前核对 `00xx` 编号、相近主题、稳定 URL 和 `_quarto.yml` 位置。
4. 涉及 R、RStudio、Positron、Quarto 或包接口时核对当前官方文档；不要复用过期界面和安装步骤。
5. 按 [共同辨析合同](../tutorial-authoring/references/comparison-and-visuals.md) 判断当前任务是否涉及初学者容易混淆的相邻概念，例如对象类型、赋值与比较、向量化与循环、脚本与控制台。只有误解会影响当前任务时才比较，不提前堆进阶术语。

## 教学主线

按学习问题组织内容，不固定章节数、行数或文字/代码比例。入门教程通常依次完成：建立任务语境、解释最少必要概念、给出可复制的最小示例、展示预期输出、让读者完成一个小练习，并说明失败时从哪里检查。

- 一个例子只引入少量新概念；后续例子复用前文对象，避免每节重新造数据。
- 代码块前说明输入和目的，代码块后解释输出中需要看的量；不逐行翻译显而易见的语法。
- 类比只用于建立直觉，随后明确其不能覆盖的技术边界。
- 易混淆概念在第一次代码使用前用最小反例、短表或对象结构说明；不要等到常见错误章节才纠正读者已经形成的误解。
- 错误示例必须能实际复现，并给出错误信息、最早检查点、原因和修复。
- 学习路线以能力和可验证任务分阶段，不承诺固定周数，也不把安装大量包当作学习成果。

需要编写路线图时读取 [learning-roadmap.md](references/learning-roadmap.md)。

## 代码与环境

- 从空白 R 会话按文章顺序实跑全部可执行代码；随机过程才设置种子。
- 优先使用小而真实的数据结构，不通过隐藏 warning、错误或输出制造“顺利”体验。
- 安装与日常代码分开。缺少运行时、系统库或外部软件时遵循仓库依赖规则，不默认改全局环境。
- 展示文件路径时说明工作目录并使用本项目可复现的相对路径。

## 图件

读取 [visual-templates.md](references/visual-templates.md)。真实控制台、编辑器、文档和图形均来自实际运行或渲染。只有关系、顺序或层级用文字难以追踪时才生成内容图；封面和示意图均不设数量指标。

## 验证与导航

1. 运行项目教程审计脚本并实跑示例。
2. 定向渲染目标文章，检查代码、表格、图件、中文和移动端可读性。
3. 更新 `doc/_quarto.yml` 后从 `doc/` 运行 `Rscript generate_sections.R`。
4. 只渲染 `sections/guide.qmd`、`index.qmd` 与目标文章，扫描完整日志中的 warning/error。