"深入浅出讲明白" Skill

使用说明

当需要把一个复杂概念、技术、产品讲明白，写成结构化文章时，用这个七步法框架。它能保证文章结构清晰、普通人能看懂、有价值感。

适用场景：

• 解释新技术新概念（比如 AI 领域新插件、新框架）
• 科普复杂知识
• 产品介绍、方法总结
• 给普通人看的干货文章

不适用场景：

• 内部技术文档（不需要这套通俗写法）
• 短问答（直接回答就行，没必要套结构）

七步法结构（固定顺序）

当需要把一个复杂概念、技术、产品讲明白，写成结构化文章时，用这个七步法框架。它能保证文章结构清晰、普通人能看懂、有价值感。

适用场景：

• 解释新技术新概念（比如 AI 领域新插件、新框架）
• 科普复杂知识
• 产品介绍、方法总结
• 给普通人看的干货文章

不适用场景：

• 内部技术文档（不需要这套通俗写法）
• 短问答（直接回答就行，没必要套结构）

七步法结构（固定顺序）

1. 开篇：从一个小故事说起

• 字数：50-150 字
• 要求：生活化场景，带入用户真实痛点/疑问，引出主题
• 目标：让读者一秒代入，知道"这东西能帮我干嘛"

2. 澄清：三个常见误区，它不是这些

• 排除三个最常见的错误认知
• 建立清晰的概念边界
• 避免读者带着误解读下去

3. 本质：一句话讲清楚它到底是什么

• 从表层到深层，拆解核心原理
• 专业词汇配通俗解释
• 一句话说透，不绕弯子

4. 拆解：三个维度读懂核心

固定三个维度：

1. 核心特性：关键机制是什么，有什么特点
2. 核心价值：它到底解决了什么问题，带来什么好处
3. 典型应用场景：哪些情况用它最合适，列出来

每个维度 1-2 段，说清楚就行。

5. 对比：一张表格看懂区别

• 拿它和相似概念/传统方式做对比
• 3-5 个维度，一目了然
• 表格形式最清晰

6. 收尾：回到开头，聊聊它对我们的意义

• 首尾呼应，价值升华
• 字数：100-200 字
• 要有温度，讲清楚它对普通人到底意味着什么

7. 延伸：想深入了解，可以读这些

• 分入门/相关/进阶三类
• 每类最多 3 本/篇
• 标注作者和核心价值，帮读者选择

写作要求

1. 语言风格：通俗口语化，避免堆砌专业术语，像聊天一样讲明白
2. 结构清晰：严格遵守七步顺序，每个部分有明确标题
3. 控制篇幅：全文一般在 1500-2500 字，不要太长
4. 示例开头：一定要用真实场景，别上来就干讲定义

模板（直接套用）

# {标题} - 七步法讲明白

> 本文用「深入浅出讲明白」七步法结构写成，帮你快速搞懂核心。

---

## 1. 开篇：从一个小故事说起

{这里写生活化场景，痛点引入}

---

## 2. 澄清：它不是这些，别搞错了

❌ **它不是XXX** —— {澄清}
❌ **它不是XXX** —— {澄清}
❌ **它不是XXX** —— {澄清}

---

## 3. 本质：一句话讲透它到底是什么

**{一句话本质}**

{补充解释，专业词汇通俗化}

---

## 4. 拆解：三个维度读懂核心

### 核心特性：{标题}

{内容}

### 核心价值：{标题}

{内容}

### 典型应用场景：{标题}

| 场景 | 为什么适合 |
|------|------------|
| {场景1} | {原因} |
| {场景2} | {原因} |
| {场景3} | {原因} |
| {场景4} | {原因} |

---

## 5. 对比：一张表格看懂区别

| {它} | {传统方式/相似概念} |
|---|---|
| {对比维度1} | {对比内容} |
| {对比维度2} | {对比内容} |
| {对比维度3} | {对比内容} |
| {对比维度4} | {对比内容} |

---

## 6. 收尾：回到开头，聊聊它对我们的意义

{总结升华，讲价值}

---

## 7. 延伸：想深入了解，可以读这些

### 入门直接用
- [{名称}]({链接}) —— {核心价值}

### 进阶阅读
- [{名称}]({链接}) —— {核心价值}

---

> 一句话总结：{核心记忆点}

使用方式

当用户让你"用七步法讲讲XXX"时：

1. 先搜索收集信息，搞懂这个概念
2. 严格套用上面的模板结构
3. 每个部分遵守字数和要求
4. 输出完整 markdown 文章

示例成品

参考本 skill 目录下的 example-ralph-wiggum.md，就是用这套框架写的 Ralph Wiggum 插件说明。