前言¶
向 Agent 提一个偏难的概念或推导题时,常见结果是「一段像百科的概述」:名词堆在一起,公式直接给出,中间缺依赖关系,也分不清哪些是前提、哪些是结论。备课、自学或答疑时,更需要的是按认知顺序拆开、每步可核对、最后能回到原问题的讲解。
下面介绍 SkillHub 上的 Knowledge Explainer。它用 SKILL.md 约束 Agent 的工作流:先把知识点拆成不可再分的原子概念并排好依赖,再逐个做定义、公式、推导与误区辨析,最后沿推导链回答最初的问题。
这是什么¶
Knowledge Explainer 是面向「知识点原子化拆解与专业讲解」的 Agent Skill,遵循通用 SKILL.md 格式。作者为王教成 Wang Jiaocheng(SkillHub 展示名「波动几何」),在 SkillHub 社区发布,当前公开版本为 1.0.0。
SkillHub 将其归入 education 分类,子类为「学习辅导」「知识讲解」。平台安全评估(Keen、叁步)结果为无风险。Skill 标注 requires_api_key 为 false,安装后无需额外 API Key 即可按说明使用。
官方入口:
- SkillHub 详情页:https://skillhub.cn/skills/user_e02e04b8/knowledge-explainer
- 用户提供的 API 地址:https://api.skillhub.cn/user_e02e04b8/knowledge-explainer
核心功能¶
Skill 正文把讲解过程固定为五步,输出为结构化 Markdown。
-
确定知识点与边界
明确要讲什么、所属学科,以及深度(入门 / 大学 / 研究生 / 专业);如需前置知识,先简要交代。 -
原子概念拆解
拆成满足「不可再分、含义独立、缺一不可」的最小单元,用表格列出编号、概念名与一句话定义,并画出依赖链(例如 ① → ② → ③)。 -
逐个原子概念讲解
每个概念按统一结构展开:形式化定义与适用边界;LaTeX 公式、变量表与从更基础原理出发的推导;直觉或类比及量级估算;2~3 条常见误区及正误对比。 -
概念间关联
说明推导、并列或因果关系,用公式链连接相邻概念,并标注可推广方向。 -
串联回原始问题
从第一个原子概念沿依赖链推导,给出完整、不跳步的结论与总结;可选补充更高阶延伸。
输出骨架(Skill 内规定的 Markdown 结构)包括:原子概念拆解、逐个讲解、串联推导、可选延伸四部分。
跨领域适配:物理侧重公式与极端情况,数学侧重证明与反例,化学侧重机制与方程,经济侧重假设与均衡,计算机侧重复杂度与正确性,生物侧重机制与证据等,由 Agent 按领域调整侧重点。
触发词(写在 Skill 描述中):讲解、解释、拆解概念、原子概念、知识体系、知识点分析、explain this、break down、teach、knowledge。
明确不适用:纯观点讨论、超出学科共识的前沿争议、依赖实时数据或实验当场验证的问题。
安装与启用¶
Skill 包仅包含 SKILL.md,可通过 SkillHub CLI 或 Zip 安装到各 Agent 的 skills 目录。
1. 安装 SkillHub CLI(若尚未安装)¶
按 SkillHub 官方安装文档检查与安装:
command -v skillhub && skillhub --version
未安装时可执行(完整安装含 CLI 与默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明文档:https://skillhub.cn/install/skillhub.md
2. 用 CLI 安装 Knowledge Explainer¶
SkillHub 元数据中的规范坐标为 @indiv-wangjiaocheng/knowledge-explainer。安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能无法被识别。
Cursor 示例:
skillhub install @indiv-wangjiaocheng/knowledge-explainer --dir ~/.cursor/skills/
Claude Code 可将 --dir 改为 ~/.claude/skills/;Codex 可使用 ~/.codex/skills/ 或项目下的 .agents/skills/(以你当前客户端文档为准)。
3. Zip 包手动安装¶
从 SkillHub 下载 API 拉取当前版本压缩包(1.0.0 仅含 SKILL.md):
curl -fsSL "https://api.skillhub.cn/api/v1/download?slug=knowledge-explainer&owner=user_e02e04b8" -o knowledge-explainer.zip
unzip knowledge-explainer.zip -d ~/.cursor/skills/knowledge-explainer
解压后目录内应有 SKILL.md。将 skills 目录配置好后,按所用 Agent 要求刷新或重启会话,使 Skill 被加载。
典型用法¶
安装并启用后,在对话中用触发词或直接说明需求即可,无需额外配置文件。下面示例对 Skill 工作流可复现,实际学科与深度可按需要替换。
示例 1:概念拆解 + 大学深度
用 Knowledge Explainer 讲解:麦克斯韦方程组如何从库仑定律与法拉第定律推导出来。深度:大学物理。请先列原子概念表和依赖链,再逐个讲,最后串联回答。
Agent 应按 Skill 输出带「原子概念拆解」「逐个讲解」「串联」等章节的 Markdown,公式使用 LaTeX,并包含误区小节。
示例 2:自学梳理
拆解概念:动态规划里的「最优子结构」和「重叠子问题」。入门级别,面向有编程基础但没系统学过 DP 的人。
示例 3:英文触发
explain this: Bayes' theorem. break down into atomic concepts, teach with formulas and common misconceptions, then answer how it applies to medical testing.
讲解前可在对话里补充:学科、希望深度、是否跳过已知前置,以对应 Skill 第一步「确定知识点与边界」。
适用场景与注意¶
适合谁
- 教师备课:需要可检查的推导链与误区清单
- 学生自学:把厚章节拆成可顺序学习的原子概念
- 技术写作者:梳理计算机、数学等概念的定义与边界
使用注意
- 输出质量依赖底层模型与上下文长度;极长推导可能需要分多轮或限定范围。
- Skill 自述不覆盖实时数据、实验复现或纯观点辩论;这类问题应换工具或补充资料。
- 数理内容务必自行核对公式与单位;Agent 讲解不能替代教材或阅卷标准。
- SkillHub 上的下载量、评分等统计会更新,以详情页为准。
结尾¶
Knowledge Explainer 的价值在于把「讲清楚一个知识点」拆成可执行流程:原子化、按依赖讲解、再回到原问题,而不是一次性生成笼统段落。若你在 Cursor、Claude Code 等环境做教学或自学,可从 SkillHub 安装该 Skill 后,用触发词直接发起讲解任务。
官方地址:https://api.skillhub.cn/user_e02e04b8/knowledge-explainer
SkillHub 详情:https://skillhub.cn/skills/user_e02e04b8/knowledge-explainer