深入浅出讲明白

用七步法结构化讲清楚复杂概念、技术、产品，写出通俗易懂的干货文章。使用当需要解释新技术、科普知识、撰写方法总结，要求文章结构清晰、普通人能看懂。

Security Scan

This is an instruction-only writing/template skill whose requirements and runtime instructions are consistent with its stated purpose of producing seven-step explanatory articles.

Purpose & Capability

Name/description (produce clear, structured explanatory articles) matches the SKILL.md template and example. The skill requests no binaries, env vars, installs, or unusual privileges — everything is proportional to a writing/template helper.

Instruction Scope

SKILL.md is a strict template with detailed formatting and length rules, which is appropriate. It also tells the agent to "先搜索收集信息，搞懂这个概念" (search/collect information) before writing — this is expected for a summarization/explanation skill, but is an open-ended web-data step the user should be aware of (citations/accuracy/privacy considerations).

Install Mechanism

No install spec and no code files — instruction-only skill. This is low-risk: nothing is written to disk or downloaded at install time.

Credentials

No environment variables, credentials, or config paths are requested. The skill does not ask for any secrets or unrelated access.

Persistence & Privilege

always is false and the skill does not request persistent/system-level changes or elevated privileges. Autonomous invocation is allowed by platform default but is not combined with other red flags here.

Scan Findings in Context

[no-findings] expected: The static scanner had no code to analyze because this is an instruction-only skill. That is expected for a template/writing helper.

Assessment

This skill appears coherent and low-risk. Before installing, consider: (1) the skill instructs the agent to search the web — verify citations and source accuracy in outputs; (2) avoid asking it to fetch or summarize private/internal documents unless you trust the agent's browsing/data-access settings; (3) review any external links it recommends before clicking; (4) if you need internal-technical documentation rather than public-friendly explainers, this template may not be appropriate. Overall assessment is benign with high confidence.

"深入浅出讲明白" 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 插件说明。