前言¶

在 Cursor、Claude Code 里问「讲讲 X」「写一篇 X 教程」，模型往往先给一段概括，结构松散、深浅不均，事实也难追溯。你自己再补大纲、查资料、统一排版，成本不低。

下面介绍 SkillHub 上的 knowledge-teaching：把「系统讲清楚一个主题」收成一条可复用的 Skill 流程——大纲先行、由浅入深，并强调联网核实与引用标注。适合你想把某块知识整理成可长期保存、可导出的 Markdown 教程时使用。

这是什么¶

knowledge-teaching 是面向「学习、教学、深度讲解」请求的 Agent Skill（标准 SKILL.md 包）。官方入口：

• 页面：https://www.skillhub.cn/skills/user_0ee0ec7b/knowledge-teaching
• 线索中的 API 路径：https://api.skillhub.cn/user_0ee0ec7b/knowledge-teaching

SkillHub 分类为 education；公开数据（线索提供，以 SkillHub 展示为准）：评分 98856，下载 525 次。

一句话定位：当用户要「真正学懂」某个主题——不限编程、数学、科学或人文社科——由 Agent 生成系统化、全面、事实尽量准确的深度教学文章或教程；纯执行类任务（写函数、写邮件、翻译、整理纪要）默认不触发，除非用户明确要求讲原理。

核心功能¶

以下能力来自 Skill 简介与触发说明，写作与核对时以官方包内 SKILL.md 为准（当前环境未能成功拉取 ZIP，见文末说明）。

触发边界¶

会触发（含中英文表述，不必出现「教程」二字）：

• 全面、系统、有深度的知识讲解
• 示例意图：「帮我讲讲 X」「写一篇 X 教程」「系统学习 X」「X 入门到精通」「给小白科普 X」「整理 X 的知识体系」
• 关键词线索：教学文章、教程、科普、系统学习、知识讲解、入门到精通、tutorial、teaching article、explain in depth、知识整理

一般不触发：只要结果、不要讲透的执行型请求；若需要「为什么这样设计」，应明确写出讲解/原理需求。

内容结构¶

1. 大纲先行：先搭由浅入深的章节骨架，再展开正文，避免堆砌段落。
2. 事实核实：对关键事实做联网核对；使用编号引用；对不确定处做存疑标注，而不是装作确定。
3. 排版：统一、可读的 Markdown；支持导出 Word / PDF（含大纲导航与页码，便于打印或分发）。

安装与启用¶

Skill 遵循 SkillHub 通用包结构：根目录 SKILL.md 为入口，可选 references/、scripts/、assets/。

SkillHub CLI（推荐）¶

SkillHub 第一方 CLI 为 @astron-team/skillhub，安装坐标支持 namespace/slug 或 slug + --namespace。在终端执行（将 cursor 换成你使用的 Agent，如 codex、claude-code）：

npx @astron-team/skillhub@latest install knowledge-teaching \
  --namespace user_0ee0ec7b \
  --registry https://api.skillhub.cn \
  --agent cursor

等价坐标写法示例：

npx @astron-team/skillhub@latest install user_0ee0ec7b/knowledge-teaching \
  --registry https://api.skillhub.cn \
  --agent cursor

安装完成后，Skill 会落入对应 Agent 的 skills 目录（例如 Cursor 常见为项目或用户级 .cursor/skills/）。若 CLI 提示需登录，按 SkillHub 教程配置 API Token 后再执行安装。

网页安装¶

打开 SkillHub 技能详情页，在安装卡片中复制 SkillHub CLI 或 ClawHub CLI 的单行命令（详情页会带上正确的 --registry 与 namespace）。以页面展示为准：

https://www.skillhub.cn/skills/user_0ee0ec7b/knowledge-teaching

手动启用¶

若你已下载技能包 ZIP，将解压后的文件夹放到当前 Agent 识别的 skills 目录，并确认根目录存在 SKILL.md，重启或刷新 Agent 后即可被模型加载。

说明：撰写本文时，对 api.skillhub.cn 的下载接口与上述 CLI 安装在本环境返回错误（如「Skill not found」或 HTTP 405），未能本地展开 SKILL.md 核对逐步指令。安装与导出细节请以 SkillHub 详情页与包内正文为准。

典型用法¶

在已启用 knowledge-teaching 的对话中，用「主题 + 深度 + 受众」描述需求即可，无需堆砌触发词。下面示例对应用法模式，可按你的领域替换 X。

系统入门（编程）

用系统化教程讲清楚 Go 的 context：先给大纲，从为什么需要 context 讲到 WithCancel/WithTimeout，
每节结尾有小结；关键行为请核实官方文档并编号引用。

跨学科科普

给非专业读者科普 CRISPR：由浅入深，区分事实与常见误解，不确定的标「存疑」，
最后整理成可导出 PDF 的 Markdown。

知识体系整理

整理「线性代数」的知识体系：概念依赖图式的大纲 + 分章讲解，适合复习，
不要做题，但要讲清直觉与定义之间的关系。

明确不要触发的对比

把这个 Python 函数改成异步版本，直接给代码。

若同时需要代码与原理，应拆开或补充一句，例如：「改完后用一小节说明 asyncio 事件循环原理。」

适用场景与注意¶

适合谁

• 需要把某一主题写成可留存教程的学习者或内训作者
• 希望 Agent 输出有目录、有引用、有存疑标注，而不是单次问答
• 需要将成稿导出 Word/PDF 做分享或归档

使用注意

• 深度讲解会拉长上下文与检索时间；主题过大时，建议分卷（如「并发基础」「内存模型」）多次调用。
• 引用与存疑标注依赖模型当时的检索能力；发布前仍建议人工抽查关键事实与链接。
• 与「只改代码、只翻译」类 Skill 分工不同：本 Skill 的价值在教学结构 + 事实纪律，不要用它代替专用执行型 Skill。

结尾¶

knowledge-teaching 把「讲透一个主题」从即兴回答，收敛为大纲驱动、可核实、可导出的教学文稿流程。若你经常在 Agent 里系统学知识或写教程，可以在 SkillHub 安装后，用自然语言说明受众与深度即可。

官方地址：

• https://www.skillhub.cn/skills/user_0ee0ec7b/knowledge-teaching
• https://api.skillhub.cn/user_0ee0ec7b/knowledge-teaching