# Concept

> 当用户问什么是 API、JWT、中间件、异步等编程概念或术语时使用 — 用大白话解释，适合初学者

- Skill: `lightpointventures/concept` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lightpointventures/concept`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lightpointventures/concept/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: lightpointventures (https://skillmd.com/u/lightpointventures)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lightpointventures/concept

---


# 概念解释

用最简单的语言解释编程概念，让初学者也能理解。

## 与 /explain 的区别

- /explain 解释一段具体的代码在做什么
- /concept 解释一个概念或术语是什么意思

## 步骤

### 1. 确定要解释的概念

如果用户已经提了，直接进入下一步。否则问：

> 你想了解什么概念？比如 API、数据库、JWT、RESTful、异步、中间件等。

### 2. 校准难度

在解释之前，先判断用户的水平（根据对话上下文或直接问）：

- **入门** — 没有编程基础，需要完全用生活类比解释，避免一切术语
- **初级** — 写过一些代码，可以用简单代码示例，但术语需要解释
- **中级** — 有开发经验，可以讨论原理和权衡，给出实际项目中的用法

如果无法判断，默认按初级处理，并在开头问一句：
> 你之前接触过编程吗？我好调整解释的深度。

### 3. 分层解释

**一句话定义**
> xxx 就是 xxx。

**现实世界类比**（必须包含）
> 用一个日常生活中的类比来解释这个概念。类比要具体、准确，点明概念的核心特征。
> 例：API 就像餐厅的菜单 — 你不需要知道厨房怎么做菜，只需要看菜单点菜（发请求），服务员（API）把菜（数据）端给你。

**为什么需要它**
> 如果没有 xxx，你会遇到 xxx 问题。用一个具体场景说明。

**怎么用**
优先用项目中的实际代码举例（如果项目里有用到这个概念）。如果没有，给一个最小可运行的代码示例（不超过 10 行）。

**常见误区**
指出初学者最容易搞混的 1-2 个点，用"xxx 不是 xxx"的句式澄清。

**相关概念（知识图谱）**
用层级关系展示相关概念，而不是简单罗列：
> - **上层概念**：xxx（xxx 是它的一部分）
> - **同层概念**：xxx vs xxx（区别是 xxx）
> - **下层概念**：xxx、xxx（属于 xxx 的具体类型）
> - **常一起用**：xxx + xxx（因为 xxx）

### 4. 追问

> 解释清楚了吗？想深入了解哪个部分？

## 遇到问题

- **用户说"还是不懂"** — 换一个完全不同的类比重新解释；把概念拆成更小的子概念，逐个击破
- **用户搞混了两个相似概念** — 做一个并排对比表，列出相同点和不同点，再用一个例子同时展示两者
- **概念太抽象无法类比** — 用"如果没有它会怎样"的反面例子来解释；或者直接写一段最小代码让用户运行感受
- **用户需要更深入的理解** — 推荐具体的文档页面或教程章节，而不是泛泛地说"去看文档"