Concept

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

lightpointventures 64ed187 2.8 KB Updated

File contents

概念解释

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

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

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

遇到问题

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

lightpointventures/claude-code-starter/tree/main/skills/concept commit 64ed187ce0

Frequently asked questions

npx skillmds@latest add lightpointventures/concept