507 explain
Workflow-oriented Agent Skills for writing, coding, research, and decision alignment.
npx -y skills add ssdiwu/507-skills --skill 507-explainAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 24 days oldThe repository was created 24 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
概念解释：把用户不理解的一个概念、术语、技术名词或相近概念差异讲清楚。先给最短白话定义，再按用户已知切换比喻、例子、反例与对比；当顺序、状态、层级或多方关系不易用纯文字理解时，优先选用表格、流程图、Mermaid 或 ASCII 示意。默认不落盘，不负责定位项目未知。Use when user mentions X 是什么意思, 这个概念是什么, 帮我理解一下, 用大白话讲讲, 我不懂这个词, 解释一下这个术语, X 和 Y 有什么区别, explain concept, explain in plain words, what is X, ELI5, break down a concept.
SKILL.md
5.6 KB, as published. Nobody here has run it
概念解释（explain）
把一个用户不理解的概念讲到真正理解。目标不是罗列完整知识，而是用最短定义和最合适的示意建立正确心智模型。
507-explain 做的是：不懂的概念 → 清晰、可复述的理解。
覆盖什么
- 技术概念、方法论、行业术语、缩写与框架名词；
- 两个或少量相近概念的差异与边界；
- 需要通过流程、状态变化、层级、映射或组件关系才能讲清的概念；
- 代码、写作或日常对话中出现的通用理解障碍。
不覆盖什么
- 定位项目里的问题、代码机制、证据与未知 → 用
507-explore； - 系统调研一个外部项目、文章或参考实现 → 用
507-research； - 对齐一个方案中的用户决策 → 用
507-grill； - 系统学习整个主题、建立学习计划或长期知识工作区 → 不在本技能范围。
核心纪律
- 讲懂，不讲全：成功标准是用户能够形成正确心智模型或用自己的话复述核心，不是覆盖概念的全部历史、分支和进阶用法。
- 先短后深：先用一句白话定义建立锚点；仍有理解缺口时，再逐步增加比喻、场景、反例、相近概念对照或技术细节。
- 从用户已知出发：能从上下文判断背景时直接适配；背景差异会实质改变解释方式时，才一次询问一个简短问题。
- 一次一个承重概念：相关概念只在解释当前核心所必需时引入，不把回答扩成术语瀑布。
- 示意服务理解：存在三项以上映射、依赖步骤、状态变化、分支、层级或多方交互时，优先使用一个最小可用视觉；简单事实或一步关系不机械画图。
- 区分事实与类比：明确哪些是概念本身，哪些只是帮助理解的比喻；不能让类比反过来制造错误规则。
- 默认不落盘：解释完成即结束。只有用户明确要求，或该词已经成为项目稳定术语时，才按项目规则写入术语表。
选择示意方式
只选择最能降低理解成本的一种，不同时堆叠多种重复图：
| 关系形状 | 首选形式 |
|---|---|
| 精确字段映射、少量概念对比 | 表格 |
| 三步以上流程、状态变化、分支或多方交互 | Mermaid（图表语法） 流程图、状态图或时序图 |
| 小型层级、终端环境或纯文本更清楚的结构 | ASCII（字符图） |
| 单一事实、一步动作、一个定义 | 简短文字说明，不画图 |
图后用一两句指出读图重点；不把图中所有文字再完整复述一遍。当前界面不能可靠渲染 Mermaid（图表语法） 时，使用等价的 ASCII（字符图） 示意。
工作流程
- 识别承重概念：确认用户真正卡住的是哪个词、关系或差异；能从上下文确定时不反问。项目特有术语先读项目术语表与相关权威定义，通用概念不为形式完整漫扫项目。
- 给最短定义：一句话说明“它是什么”，避免用更多未解释术语定义它。
- 选择解释路径：根据概念形状与用户背景，在场景、比喻、反例、对比或最小视觉中选择最有帮助的一种。
- 压测边界：说明一个最容易混淆的“不是什么”或相近概念差异，防止只记住表面比喻。
- 按反馈迭代：用户仍未理解时换一种解释方式，不重复同一套措辞；理解成立就停止。
输出形态
简单概念可以只有两三段。复杂概念按需使用：
## 一句话
<最短白话定义>
## 示意
<一个表格、流程图或字符图；确有必要时才用>
## 放进场景
<一个具体例子>
## 容易混淆
<它不是什么，或和相近概念的关键差异>
与相邻技能的边界
| 技能 | 分工 |
|---|---|
507-explain | 用户不理解一个概念 → 讲懂 |
507-explore | 项目问题尚未看清 → 读取证据，确定认知边界与下一步 |
507-research | 外部参照物 → 核实机制并判断借鉴意义 |
507-grill | 已知前提下的用户决策 → 追问并收束 |
红线
- 不用更多未定义术语解释当前术语；
- 不为展示完整而扩成系统课程；
- 不把类比当成事实边界；
- 不用无助于理解的装饰性图表；
- 不替项目探索、外部调研或决策对齐执行。
完成与接力
- 完成信号：用户当前卡住的概念已有可复述的最小心智模型，关键边界和最易混淆点已说明。
- 产物：对话中的解释与最多一种必要示意；默认不落盘。
- 候选出口：理解成立后返回调用它的原任务；发现项目事实未知时进入
507-explore；需要外部证据时进入507-research；真正问题是用户取舍时进入507-grill；只需解释时直接结束。 - 回退条件：用户仍不理解时换解释路径，不重复堆同义措辞或继续扩大课程范围。