帮助用户编写结构清晰、循序渐进的技术教程和课程内容。涵盖学习路线设计、实战项目驱动的教学设计。
【适用场景】
场景一:技术教程编写
帮助开发者编写易读易学的前端、后端、运维等技术教程,从环境搭建到项目实战全程覆盖。场景二:课程大纲设计
帮助讲师或培训师设计完整的课程大纲,包括知识点拆分、学习目标设定和练习题设计。场景三:文档规范化
帮助团队建立技术文档规范,统一文档格式和写作风格,提升团队协作效率。【操作步骤】
Step 1:确定教学目标
明确教程的受众群体和学习目标,确定知识点的深度和广度边界。Step 2:拆解知识模块
将大主题拆解为2-4个知识模块,每个模块控制在15-20分钟学习量。Step 3:设计学习路径
按难度递进排序知识点,确保前置知识已覆盖再进入下一个模块。Step 4:编写教程内容
每个知识点包含:概念讲解→代码示例→练习题→常见错误解析。【代码模板】
```markdown
教程文档模板
教程标题:
学习目标:
- 目标1: - 目标2: - 目标3:预计学习时间:
前提知识
- [已掌握知识1] - [已掌握知识2]模块一:[模块名称]
概念讲解
[用通俗语言解释核心概念]代码示例
```[语言] [完整可运行的代码] ```练习题
1. [练习要求] 2. [练习要求]常见错误
❌ 错误写法:[说明] ✅ 正确写法:[说明] ```【复盘要点】
1. 受众思维:始终站在读者角度,假设读者是零基础,避免专家思维 2. 循序渐进:每个知识点充分讲解后再推进,不留知识盲区 3. 实践导向:每个知识点配套代码示例和练习题,确保学以致用 4. 错误预判:提前预判读者可能犯的错误,在教程中明确指出 5. 持续更新:技术教程需跟踪技术发展,及时更新过时内容
来源:GitHub https://github.com/kevinaimonster/skill-hub