# Tech Tutorial

> 技术教程写作技能。当用户要求写教程、入门指南、手把手教学类文章时使用。产出结构清晰、循序渐进、包含代码示例的技术教程。

- Skill: `datawhalechina/tech-tutorial` (Agent Skill)
- Install (CLI): `npx skillmds@latest add datawhalechina/tech-tutorial`
- Raw SKILL.md: https://api.skillmd.com/api/skills/datawhalechina/tech-tutorial/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: datawhalechina (https://skillmd.com/u/datawhalechina)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/datawhalechina/tech-tutorial

---


# 技术教程写作技能

## 适用场景
- 用户要求写 "XXX 入门教程"、"手把手教你 XXX"
- 文章类型为 tutorial / how-to / getting-started

## 写作方法论

### Phase 1: 受众分析
- 确定目标读者的技术水平（初级/中级/高级）
- 识别前置知识要求
- 设定学习目标（读完后读者能做什么）

### Phase 2: 大纲设计
- 采用 "概念 → 实践 → 深入" 的递进结构
- 每章设置核心问题（读者读完这章应该能回答什么）
- 预分配字数目标

### Phase 3: 内容写作
- 每个概念先给出直觉解释，再给出精确定义
- 代码示例必须可运行，附带注释
- 使用类比和图表辅助理解
- 每章末尾设置 "检查点"（读者自测）

### Phase 4: 质量检查
- 确保代码示例无语法错误
- 检查术语一致性
- 验证学习路径的连贯性