tech-learning-guide

Tech Learning Guide Skill

为任意技术主题生成一份完整、结构清晰且观点鲜明的学习指南。这份指南应读起来像是由一位曾教授过该主题的资深工程师撰写——注重实践、直截了当，并诚实说明哪些内容最重要。

输出结构

请按以下顺序撰写指南，并生成渲染后的文件（.md 文件）。语气应亲切、直接且体现技术自信——避免空话和冗余内容。

---

Section 1 — 概览与概念图

开篇用 2–3 句话介绍这项技术是什么，以及它为何在当今生态中很重要。 然后列出学习者需要掌握的所有关键概念，并分为三个层级：

Tier	Label	What it means
🟢	基础	初学者必须首先学习的概念；无需具备该技术的先验知识
🔵	基础进阶	构成日常工作知识的核心概念
🔴	高级	深层原理、生产环境问题、性能或生态集成

请使用表格或分组列表。每个层级安排 5–8 个概念（总计 15–24 个），但应根据技术范围灵活调整。不要为了凑数而填充内容。

---

Section 2 — 每周学习计划

制定一份切实可行的逐周学习计划。假设每天学习 1–2 小时，每周 5 天。 结构如下：

• 第 N 周：[主题] — 用 2 句话说明本周重点
  • 第 1–5 天：列出具体的每日目标（每项 1–2 句话）

整个计划需覆盖三个层级。先学基础，再学基础进阶，最后学高级。 通常安排 6–10 周，具体取决于技术的广度。请如实说明哪些周需要更多时间（例如：“本周内容较密集——如有需要，请预留额外时间”）。

---

Section 3 — 本地开发环境配置

提供具体、可直接复制粘贴的说明，帮助读者搭建可用的本地环境。 包括：

• 先决条件（操作系统、所需工具及版本）
• 安装步骤（编号步骤，并在代码块中提供 shell 命令）
• 验证是否可用——提供最简的“hello world”命令或代码片段来确认配置成功
• 推荐的 IDE / 编辑器及关键插件或扩展
• 实用开发工具（代码检查工具、格式化工具、调试器、本地测试运行器）

请明确表达你的观点。如果某种方式显然更适合学习，请直接说明。

---

Section 4 — 概念深入解析

为 Section 1 中列出的每个概念编写一个专属小节：

### [Tier emoji] [Concept Name]

**What it is**: 2–3 sentence plain-language explanation.

**Why it matters**: 1–2 sentences on practical relevance.

**How it works**: Explanation with code example(s). For code-heavy concepts, show at least
one realistic example (not just "hello world"). For architectural concepts, use a short
diagram or analogy.

**Common pitfalls**: 1–3 bullet points of mistakes beginners make.

---
#### ✏️ Exercises

1. [Concrete, hands-on exercise — beginner friendly]
2. [Slightly harder exercise that builds on the first]
3. [Challenge exercise that combines this concept with a previous one]

按层级标题对概念分组： ## 🟢 Basics、## 🔵 Foundational、## 🔴 Advanced

---

Section 5 — 常用库与生态

简明梳理生态。针对该技术生态中的每个主要库或工具：

• 名称 + 一句话说明其用途
• 适用场景（2 句话）
• 展示最简单且实用示例的代码片段（适用时）

目标为 6–10 项。如果生态较大，请按类别分组（例如“测试”“HTTP”“ORM”）。不要罗列所有内容——只列出从业者实际会用到的工具。

---

Section 6 — 项目创意

请提供恰好 3 个项目创意，难度逐步提升：

1. [小型] 项目名称 — 1–2 周。说明要构建什么、会练习哪些概念，以及它为何适合作为学习项目。
2. [中型] 项目名称 — 3–5 周。采用相同格式，并引入更多基础进阶概念。
3. [挑战] 项目名称 — 时间不限。融入高级概念和现实问题（身份验证、持久化、部署、性能）。

每个项目都要包含：

• 简要的功能列表（3–5 个项目符号）
• 练习的关键概念
• 可选：建议搭配使用的技术栈

第 7 节——接下来学什么

掌握本指南的所有内容后，学习者接下来该何去何从？请提供：

• 2–3 项值得探索的相关技术（每项用 1 句话说明理由）
• 2–3 个技术本身涉及的进阶主题，且未在本指南中介绍
• 1–2 个有助于了解最新动态的社区资源（会议、简报、论坛）

请将这一部分写成真诚的“毕业寄语”——你已经学会了基础知识，接下来还有这些领域等待探索。

---

第 8 节——资源

精选参考资料列表。按以下类别整理：

• 官方文档——链接 + 1 句话说明
• 书籍——书名、作者、推荐理由
• 在线课程——平台 + 课程名称，适合哪个水平的学习者
• 博客 / 网站——名称 + 发布的内容类型
• YouTube / 视频——频道或具体系列，以及值得观看的原因
• 社区——Discord、Slack、论坛、subreddit

精简为宜——每个类别最多列出 3–5 项。每项资源都应物有所值。

---

质量指南

• 具体明确：不要给出“多多练习”之类的模糊建议。要说明练习什么，以及如何练习。
• 诚实坦率：如果某个概念确实很难，或者经常让人卡住，请直说。
• 示例必须可运行：任何代码片段都应尽可能精简，同时完整到可以实际执行，或能独立理解。
• 根据技术调整深度：Bash 脚本指南与分布式系统指南，在深度和广度上应有所不同。
• 不要杜撰资源：只推荐确信存在的书籍、课程和链接。如果不确定某个网址，请只写资源名称，不要猜测链接。
• 开发者布道师语气：像一位知识渊博的同行交流，而不是像教科书。可以使用第一人称补充说明（例如：“我会先学 X 再学 Y，因为……”）。

---

广泛主题与狭窄主题的处理方式

• 非常广泛的主题（例如“云计算”“Web 开发”）：在引言中缩小范围。告诉用户你会从哪个角度介绍，以及原因。建议他们针对相关领域另行请求指南。
• 非常狭窄的主题（例如单个库方法或小众工具）：相应缩减内容。为 Array.prototype.reduce 制定 10 周学习计划就很荒谬。请酌情判断。
• 版本敏感的技术：在开头说明指南针对的版本。如果旧版本之间存在显著差异，请标明相关部分。

---

参考资料

• references/schedule-templates.md — 不同技术范围（语言、框架、工具、概念）的学习计划示例。需要校准学习计划的时长或密度时，请阅读。
• references/concept-tiers.md — 常见技术类别中如何将概念划分为基础 / 奠基 / 进阶的指南。