# 初学者文档
## 触发规则
检测到用户输入关键词「初学者文档」时，输出标准Markdown格式学习文档，成品可直接保存为`.md`文件；文档面向零基础新手，整体定位轻量化快速学习，文字精简无冗余废话，全程干货导向。

## 视觉美观强制要求
1. 全文高量使用适配板块主题的emoji图标、装饰符号，每一级标题、分点、区块都搭配专属图案标识，大幅提升视觉丰富度；
2. 多用分割线、空白换行、色块区分逻辑区块，表格采用规整排版，有序/无序列表搭配符号装饰，层次分明；
3. 重点文字使用加粗、标记突出，整体排版精致清爽，阅读视觉舒适度高，适配本地MD编辑器预览效果。

## 文档固定结构，顺序不可更改
### 一、文档顶部置顶板块：核心概念速览
围绕本次【目标学习主题】整理全部高频、日常刚需核心内容速查表；举例：npm主题汇总全部常用指令+短句释义、Excel汇总高频函数语法、软件工具汇总核心功能清单。
采用表格或极简列表展示，每条内容附带一句极简解释，仅作快速查阅，不做长篇拓展讲解。

### 二、第二板块：完整概念详解 + 同类内容对比
1. 核心概念解析：通俗完整讲清主题定义、核心作用、基础特性、适用场景、适配人群、前置学习门槛；
2. 同类横向对比：选取2-5个极易混淆的同类工具/知识点，制作美化对比表格，对比维度：学习门槛、核心优势、缺陷短板、适用场景、新手推荐星级，清晰区分内容差异。

### 三、第三板块：五阶段递进学习路线
固定学习顺序：认知启蒙→基础实操→综合练习→独立实战→查漏巩固
**完全删除课后实操练习、作业相关内容**，每个阶段仅包含3部分：
1. 阶段定位：一句话点明本阶段学习重心与核心意义；
2. 细分核心知识点精简清单；
3. 阶段通关自测标准：明确掌握程度阈值，达到标准即可进入下一阶段，贴合快速学习定位。

### 四、第四板块：新手配套辅助干货
1. ⚠️新手高频误区汇总：罗列典型错误认知，附带正确纠正思路；
2. 🧰必备工具与免费学习资源清单；
3. ⏱️分阶段速成参考学习时长；
4. 💡零基础快速吃透主题的高效学习技巧。

## 输出硬性约束
1. 仅输出纯标准Markdown文本，严格使用#、##、###划分标题层级；
2. 行文通俗直白，减少晦涩专业术语，适配零基础理解水平；
3. 全文主打速成学习，删减冗长拓展理论，只保留核心干货；
4. 自动替换全文【目标学习主题】占位符，无需用户手动修改；用户未说明具体学习主题时，主动询问需要制作文档的内容。

---
name: beginner-doc-generator
description: >-
  面向零基础新手生成标准化 Markdown 学习速成文档。当用户输入关键词「初学者文档」、或要求生成入门学习指南、新手教程、速成文档、快速学习路线图时触发。
  自动将用户指定的学习主题替换进文档模板，输出可直接保存为 .md 文件的高质量学习文档。
  文档定位：轻量、速成、纯干货、视觉丰富、适配本地 MD 编辑器预览。
---

# 初学者文档生成器

## 触发条件

当检测到以下任一情况时自动激活本 Skill：

- 用户输入关键词 **「初学者文档」**
- 用户要求生成入门 / 新手 / 零基础学习指南
- 用户要求制作速成学习路线、快速上手文档

## 核心行为流程

1. **识别学习主题**：从用户消息中提取目标学习主题。若用户未明确说明具体主题，**主动询问**用户需要制作什么内容的文档，给出示例提示（如 npm、Git、Excel、Docker、Python 等）。
2. **替换占位符**：将文档模板中所有 `【目标学习主题】` 占位符自动替换为用户指定的主题。
3. **输出纯 Markdown**：仅输出标准 Markdown 文本，可直接保存为 `.md` 文件。不输出任何额外解释性对话文本。
4. **遵循固定结构**：按下方规定的四板块顺序输出，**不可调换顺序、不可增删板块**。

---

## 文档输出规范

### 整体定位

| 维度 | 要求 |
|------|------|
| 目标读者 | 零基础新手 |
| 内容定位 | 轻量化快速学习，文字精简无冗余，全程干货 |
| 语言风格 | 通俗直白，减少晦涩专业术语 |
| 输出格式 | 纯标准 Markdown，严格使用 `#`、`##`、`###` 划分标题层级 |
| 预览适配 | 排版精致清爽，适配本地 MD 编辑器预览效果 |

### 视觉美观强制要求

- 🎨 **Emoji 图标**：全文大量使用适配各板块主题的 emoji 图标和装饰符号，每一级标题、分点、区块都搭配专属图案标识
- 📏 **分割线**：多用 `---` 分割线、空白换行区分逻辑区块
- 📊 **表格**：采用规整排版，列对齐
- 📝 **列表**：有序 / 无序列表搭配符号装饰，层次分明
- 🔆 **重点标记**：重点文字使用 **加粗** 突出
- ✨ **整体风格**：视觉丰富度高，阅读舒适

---

## 固定文档结构（顺序不可更改）

### 一、文档顶部：核心概念速览

```
# 📚 【目标学习主题】零基础速成指南

> 一句话描述本文档用途

---

## 🚀 核心概念速览
```

**内容要求：**

- 围绕【目标学习主题】整理**全部高频、日常刚需核心内容速查表**
- 举例参考：
  - npm 主题 → 汇总全部常用指令 + 短句释义
  - Excel 主题 → 汇总高频函数语法
  - 软件工具主题 → 汇总核心功能清单
- 采用**表格或极简列表**展示
- 每条内容附带**一句极简解释**，仅作快速查阅
- **不做长篇拓展讲解**

---

### 二、完整概念详解 + 同类内容对比

```
---

## 📖 概念详解与横向对比

### 🧠 核心概念解析
```

**内容要求（两部分）：**

#### 2.1 核心概念解析

通俗完整讲清以下维度：
- 📌 主题定义
- 🎯 核心作用
- ⚙️ 基础特性
- 📍 适用场景
- 👥 适配人群
- 🔰 前置学习门槛

#### 2.2 同类横向对比

- 选取 **2-5 个**极易混淆的同类工具 / 知识点
- 制作**美化对比表格**
- 对比维度（固定 5 列）：

| 对比维度 | 内容 |
|----------|------|
| 学习门槛 | ... |
| 核心优势 | ... |
| 缺陷短板 | ... |
| 适用场景 | ... |
| 新手推荐星级 | ⭐ ~ ⭐⭐⭐⭐⭐ |

---

### 三、五阶段递进学习路线

```
---

## 🗺️ 五阶段递进学习路线
```

**固定学习顺序（不可更改）：**

1. 🌱 认知启蒙
2. 🔧 基础实操
3. 🧩 综合练习
4. 🚀 独立实战
5. 🔍 查漏巩固

**每个阶段仅包含 3 部分（严格禁止课后实操练习 / 作业内容）：**

#### 每阶段格式模板：

```
### 阶段 X：🌱 认知启蒙

> **阶段定位**：一句话点明本阶段学习重心与核心意义

#### 📋 核心知识点

- 知识点 1：极简描述
- 知识点 2：极简描述
- 知识点 3：极简描述

#### ✅ 通关自测标准

> 明确掌握程度阈值，达到标准即可进入下一阶段
- [ ] 自测项 1
- [ ] 自测项 2
- [ ] 自测项 3
```

---

### 四、新手配套辅助干货

```
---

## 🎒 新手配套辅助干货
```

**固定 4 个子板块（顺序不可更改）：**

#### 4.1 ⚠️ 新手高频误区汇总

- 罗列典型错误认知
- 每条附带**正确纠正思路**

格式：
```
| ❌ 常见误区 | ✅ 正确认知 |
|------------|-----------|
| ...        | ...       |
```

#### 4.2 🧰 必备工具与免费学习资源清单

- 推荐工具（免费优先）
- 推荐学习资源（官方文档、教程、社区等）
- 用表格或分类列表展示

#### 4.3 ⏱️ 分阶段速成参考学习时长

- 为五阶段学习路线分别给出参考学习时长
- 表格展示，标注"仅供参考"

#### 4.4 💡 零基础快速吃透主题的高效学习技巧

- 3-5 条实用学习技巧
- 简洁有力，直接可操作

---

## 输出硬性约束清单

- [x] 仅输出纯标准 Markdown 文本
- [x] 严格使用 `#`、`##`、`###` 划分标题层级
- [x] 行文通俗直白，适配零基础理解水平
- [x] 全文主打速成学习，删减冗长拓展理论，只保留核心干货
- [x] 自动替换全文 `【目标学习主题】` 占位符为实际主题
- [x] 用户未说明具体学习主题时，主动询问需要制作文档的内容
- [x] 四板块顺序固定不可更改
- [x] 五阶段学习路线顺序固定不可更改
- [x] 删除一切课后实操练习 / 作业相关内容
- [x] 每个阶段仅含 3 部分：阶段定位、核心知识点、通关自测标准
- [x] 全文大量使用 emoji 与装饰符号
- [x] 多用分割线、空白换行、表格区分逻辑区块
- [x] 重点文字使用加粗突出

---

## 示例输出片段

以下为「npm」主题的文档开头片段示例，展示视觉风格与结构：

```markdown
# 📚 npm 零基础速成指南

> 🎯 一份面向零基础新手的 npm 速成学习文档，精简干货，快速上手

---

## 🚀 核心概念速览

| 📝 指令 | 💬 释义 |
|---------|---------|
| `npm init` | 初始化项目，生成 package.json |
| `npm install` | 安装项目依赖包 |
| `npm install -g <pkg>` | 全局安装包 |
| `npm uninstall <pkg>` | 卸载指定包 |
| `npm update` | 更新所有依赖包 |
| `npm run <script>` | 执行 package.json 中的脚本 |
| `npm list` | 查看已安装的依赖树 |
| `npm audit` | 安全漏洞检查 |

---

## 📖 概念详解与横向对比

### 🧠 核心概念解析

- 📌 **定义**：npm（Node Package Manager）是 Node.js 的默认包管理工具...
- 🎯 **核心作用**：管理 JavaScript 项目的第三方依赖包...
- ⚙️ **基础特性**：...
- 📍 **适用场景**：...
- 👥 **适配人群**：...
- 🔰 **前置门槛**：...
```

## 注意事项

- 生成文档时不要在 Markdown 前后添加额外对话文本（如"这是您的文档："等）
- 直接以 `# 📚` 开头输出文档正文
- 如果用户消息中包含具体主题，立即生成文档；如果未包含，仅回复一条询问消息
- 文档篇幅适中，速成导向，避免过度冗长