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. 追问

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

遇到问题

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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: lightpointventures
• Source: lightpointventures/claude-code-starter
• License: MIT
• Homepage: https://github.com/lighthouse-strategy/claude-code-starter

Install and usage instructions live in the source repository linked above.