$npx -y skills add lightpointventures/claude-code-starter --skill concept当用户问什么是 API、JWT、中间件、异步等编程概念或术语时使用 — 用大白话解释,适合初学者
| 1 | # 概念解释 |
| 2 | |
| 3 | 用最简单的语言解释编程概念,让初学者也能理解。 |
| 4 | |
| 5 | ## 与 /explain 的区别 |
| 6 | |
| 7 | - /explain 解释一段具体的代码在做什么 |
| 8 | - /concept 解释一个概念或术语是什么意思 |
| 9 | |
| 10 | ## 步骤 |
| 11 | |
| 12 | ### 1. 确定要解释的概念 |
| 13 | |
| 14 | 如果用户已经提了,直接进入下一步。否则问: |
| 15 | |
| 16 | > 你想了解什么概念?比如 API、数据库、JWT、RESTful、异步、中间件等。 |
| 17 | |
| 18 | ### 2. 校准难度 |
| 19 | |
| 20 | 在解释之前,先判断用户的水平(根据对话上下文或直接问): |
| 21 | |
| 22 | - **入门** — 没有编程基础,需要完全用生活类比解释,避免一切术语 |
| 23 | - **初级** — 写过一些代码,可以用简单代码示例,但术语需要解释 |
| 24 | - **中级** — 有开发经验,可以讨论原理和权衡,给出实际项目中的用法 |
| 25 | |
| 26 | 如果无法判断,默认按初级处理,并在开头问一句: |
| 27 | > 你之前接触过编程吗?我好调整解释的深度。 |
| 28 | |
| 29 | ### 3. 分层解释 |
| 30 | |
| 31 | **一句话定义** |
| 32 | > xxx 就是 xxx。 |
| 33 | |
| 34 | **现实世界类比**(必须包含) |
| 35 | > 用一个日常生活中的类比来解释这个概念。类比要具体、准确,点明概念的核心特征。 |
| 36 | > 例:API 就像餐厅的菜单 — 你不需要知道厨房怎么做菜,只需要看菜单点菜(发请求),服务员(API)把菜(数据)端给你。 |
| 37 | |
| 38 | **为什么需要它** |
| 39 | > 如果没有 xxx,你会遇到 xxx 问题。用一个具体场景说明。 |
| 40 | |
| 41 | **怎么用** |
| 42 | 优先用项目中的实际代码举例(如果项目里有用到这个概念)。如果没有,给一个最小可运行的代码示例(不超过 10 行)。 |
| 43 | |
| 44 | **常见误区** |
| 45 | 指出初学者最容易搞混的 1-2 个点,用"xxx 不是 xxx"的句式澄清。 |
| 46 | |
| 47 | **相关概念(知识图谱)** |
| 48 | 用层级关系展示相关概念,而不是简单罗列: |
| 49 | > - **上层概念**:xxx(xxx 是它的一部分) |
| 50 | > - **同层概念**:xxx vs xxx(区别是 xxx) |
| 51 | > - **下层概念**:xxx、xxx(属于 xxx 的具体类型) |
| 52 | > - **常一起用**:xxx + xxx(因为 xxx) |
| 53 | |
| 54 | ### 4. 追问 |
| 55 | |
| 56 | > 解释清楚了吗?想深入了解哪个部分? |
| 57 | |
| 58 | ## 遇到问题 |
| 59 | |
| 60 | - **用户说"还是不懂"** — 换一个完全不同的类比重新解释;把概念拆成更小的子概念,逐个击破 |
| 61 | - **用户搞混了两个相似概念** — 做一个并排对比表,列出相同点和不同点,再用一个例子同时展示两者 |
| 62 | - **概念太抽象无法类比** — 用"如果没有它会怎样"的反面例子来解释;或者直接写一段最小代码让用户运行感受 |
| 63 | - **用户需要更深入的理解** — 推荐具体的文档页面或教程章节,而不是泛泛地说"去看文档" |