- name
- 深入浅出讲明白
- description
- 用七步法结构化讲清楚复杂概念、技术、产品，写出通俗易懂的干货文章。使用当需要解释新技术、科普知识、撰写方法总结，要求文章结构清晰、普通人能看懂。
"深入浅出讲明白" Skill
使用说明
当需要把一个复杂概念、技术、产品讲明白，写成结构化文章时，用这个七步法框架。它能保证文章结构清晰、普通人能看懂、有价值感。
适用场景：
- 解释新技术新概念（比如 AI 领域新插件、新框架）
- 科普复杂知识
- 产品介绍、方法总结
- 给普通人看的干货文章
不适用场景：
- 内部技术文档（不需要这套通俗写法）
- 短问答（直接回答就行，没必要套结构）
七步法结构（固定顺序）
当需要把一个复杂概念、技术、产品讲明白，写成结构化文章时，用这个七步法框架。它能保证文章结构清晰、普通人能看懂、有价值感。
适用场景：
- 解释新技术新概念（比如 AI 领域新插件、新框架）
- 科普复杂知识
- 产品介绍、方法总结
- 给普通人看的干货文章
不适用场景：
- 内部技术文档（不需要这套通俗写法）
- 短问答（直接回答就行，没必要套结构）
七步法结构（固定顺序）
1. 开篇：从一个小故事说起
- 字数：50-150 字
- 要求：生活化场景，带入用户真实痛点/疑问，引出主题
- 目标：让读者一秒代入，知道"这东西能帮我干嘛"
2. 澄清：三个常见误区，它不是这些
- 排除三个最常见的错误认知
- 建立清晰的概念边界
- 避免读者带着误解读下去
3. 本质：一句话讲清楚它到底是什么
- 从表层到深层，拆解核心原理
- 专业词汇配通俗解释
- 一句话说透，不绕弯子
4. 拆解：三个维度读懂核心
固定三个维度：
- 核心特性：关键机制是什么，有什么特点
- 核心价值：它到底解决了什么问题，带来什么好处
- 典型应用场景：哪些情况用它最合适，列出来
每个维度 1-2 段，说清楚就行。
5. 对比：一张表格看懂区别
- 拿它和相似概念/传统方式做对比
- 3-5 个维度，一目了然
- 表格形式最清晰
6. 收尾：回到开头，聊聊它对我们的意义
- 首尾呼应，价值升华
- 字数：100-200 字
- 要有温度，讲清楚它对普通人到底意味着什么
7. 延伸：想深入了解，可以读这些
- 分入门/相关/进阶三类
- 每类最多 3 本/篇
- 标注作者和核心价值，帮读者选择
写作要求
- 语言风格：通俗口语化，避免堆砌专业术语，像聊天一样讲明白
- 结构清晰：严格遵守七步顺序，每个部分有明确标题
- 控制篇幅：全文一般在 1500-2500 字，不要太长
- 示例开头：一定要用真实场景，别上来就干讲定义
模板（直接套用）
# {标题} - 七步法讲明白
> 本文用「深入浅出讲明白」七步法结构写成，帮你快速搞懂核心。
---
## 1. 开篇：从一个小故事说起
{这里写生活化场景，痛点引入}
---
## 2. 澄清：它不是这些，别搞错了
❌ **它不是XXX** —— {澄清}
❌ **它不是XXX** —— {澄清}
❌ **它不是XXX** —— {澄清}
---
## 3. 本质：一句话讲透它到底是什么
**{一句话本质}**
{补充解释，专业词汇通俗化}
---
## 4. 拆解：三个维度读懂核心
### 核心特性：{标题}
{内容}
### 核心价值：{标题}
{内容}
### 典型应用场景：{标题}
| 场景 | 为什么适合 |
|------|------------|
| {场景1} | {原因} |
| {场景2} | {原因} |
| {场景3} | {原因} |
| {场景4} | {原因} |
---
## 5. 对比：一张表格看懂区别
| {它} | {传统方式/相似概念} |
|---|---|
| {对比维度1} | {对比内容} |
| {对比维度2} | {对比内容} |
| {对比维度3} | {对比内容} |
| {对比维度4} | {对比内容} |
---
## 6. 收尾：回到开头，聊聊它对我们的意义
{总结升华，讲价值}
---
## 7. 延伸：想深入了解，可以读这些
### 入门直接用
- [{名称}]({链接}) —— {核心价值}
### 进阶阅读
- [{名称}]({链接}) —— {核心价值}
---
> 一句话总结：{核心记忆点}使用方式
当用户让你"用七步法讲讲XXX"时：
- 先搜索收集信息，搞懂这个概念
- 严格套用上面的模板结构
- 每个部分遵守字数和要求
- 输出完整 markdown 文章
示例成品
参考本 skill 目录下的 example-ralph-wiggum.md，就是用这套框架写的 Ralph Wiggum 插件说明。