1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | teach-mattpocock-skills |
| 项目自述名称 | teach（作者仓库内子技能，无独立品牌名） |
| 作者/维护者 | Matt Pocock（个人开发者） |
| 来源链接 | https://github.com/mattpocock/skills/tree/main/skills/productivity/teach |
| 许可证 | MIT（GitHub API 获取） |
| GitHub Stars / Forks | 220,826 / 19,029（GitHub API；数字属整个 skills 合集仓库，不代表本技能自身热度） |
| 该技能自身安装量 | skills.sh 市场页面显示安装 474.1K 次（网页抓取，专属本技能，非合集口径） |
| 最新版本 | 仓库最新 release v1.2.3；teach 子目录本身最近一次功能提交 2026-06-17，2026-07-13 随全仓库批量更新补充 Codex 元数据 |
| 安装方式 | Claude Code 官方插件市场一条命令；或通用安装器 npx skills@latest add 选装 |
2. 功能介绍与亮点
把当前工作目录变成一个持久化的教学工作区，供用户就某个主题跨多个会话持续学习：
- MISSION.md：记录用户学这个主题的真实动机，作为后续所有教学内容的锚点
- lessons/：每次教学产出一个独立、可打印、排版精美的 HTML 课程文件（编号命名），聚焦一个小到能被工作记忆消化的知识点，并链接到权威一手资料
- learning-records/：仿照架构决策记录（ADR）的写法，记录用户已掌握的非显而易见的知识点，用于计算“最近发展区”（Zone of Proximal Development），决定下一课该教什么
- reference/：课程之外沉淀的速查表、术语表、参考算法等压缩知识，供长期反复查阅
- assets/：跨课程复用的样式与交互组件，保证整套课程视觉与交互一致
设计上区分“流畅度”（当下能不能答对）与“存储强度”（长期记不记得），刻意用间隔重复、检索练习等有科学依据的记忆策略出题，而不是让用户看完就以为学会了。
3. 适用场景
固定分类：内容创作与知识管理
适用于希望系统性学习某个新领域或新技能、且愿意跨多次会话持续跟进进度的用户——编程语言、新框架、某项运动技巧、考试科目等均可。尤其适合已经用 Claude Code / Codex 等 agent 做日常工作、想把同一个 agent 顺手改造成私人教练或家教的初中级用户；对只想问一次性问题的用户价值有限。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 收录于官方插件市场，/plugin install mattpocock-skills 一条命令安装，随作者更新自动同步 |
| Codex | ✅ 原生支持 | 该技能目录内自带 agents/openai.yaml 元数据文件，专为 Codex 适配；官方 README 亦确认通用安装器 npx skills@latest add 覆盖 Codex |
| OpenClaw | ⚠️ 需适配 | SKILL.md 遵循标准 Agent Skills 规范（YAML front matter + Markdown 正文），OpenClaw 有独立技能安装通道可处理此类标准格式技能，但未见该技能专门在 OpenClaw 上的验证记录 |
| Hermes Agent | ❓ 未验证 | 未找到该技能在 Hermes Agent 上的专门验证记录 |
5. 推荐理由
多数“学习类”技能只是把一次性问答包装得更好看，这个技能把学习本身当作一个跨会话的持续项目来管理——用文件系统固化学习动机、已掌握的知识、待学的知识点与可复用的课程组件，让 agent 每次都清楚“用户现在在哪、该学什么”，而不是每次从零开始。自身安装量在同仓库 51 个技能中排名前列，且有大量独立用户在仓库 issue 区就这个具体技能提反馈和改进建议，说明确有持续真实使用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | skills.sh 市场显示该技能自身安装 47.41 万次，高于同仓库多数子技能；GitHub 仓库 issue 区以“teach”为标题关键词的独立用户反馈达 25 条，涉及至少 10 个不同用户账号，均是具体功能建议与缺陷报告，非泛泛好评 |
| 可用性 | 9 | 无需任何外部服务或凭据配置，首次调用即自动生成完整工作区目录结构；MIT 开源；仓库整体近期（2026-08-17）仍有提交，维护活跃；核心流程不依赖同仓库其他技能即可独立工作 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① Shell 命令：仅在需要时执行打开本地课程文件的 CLI 命令（如 open lesson.html），无写入仓库代码、无破坏性操作
② 联网外发：不主动外发用户数据；提示词要求“优先查找权威一手资料”，可能借助 agent 自带的网页检索能力，行为透明
③ 凭据处理：不要求任何 API key 或凭据
④ 可疑指令：通读 SKILL.md 全文未发现夹带无关推广或隐蔽指令
⑤ 作者信誉：Matt Pocock 为公开身份的 TypeScript 教育者与工具作者，无造假迹象
⑥ License：MIT，明确
⑦ 最近维护：所属仓库近期仍有提交，本技能子目录最近一次功能性更新距今约两个月，尚在合理窗口内
综合评分 = 三项均值 = 9.0
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| writing-for-agents-mattpocock-skills（同仓库） | 教人如何给 agent 写文档/技能的元技能 | 面向“教 agent”而非“教用户”，服务对象与产出物完全不同 |
| triage-mattpocock-skills（同仓库，工程效率类） | 面向项目维护者的 issue/PR 分诊状态机 | 解决的是团队协作流程问题，不涉及个人知识学习 |
| 通用问答式技能（如各类“解释代码”类技能） | 单次会话内回答具体问题 | 不追踪学习进度、不跨会话累积知识、不产出可复用课程资料 |
本技能的差异化在于把“教”这件事当作一个有状态、可持续跟进的项目来管理，而不是把每次提问当成独立事件——这是当前索引内少见的、专门针对个人化持续学习场景设计的技能。
8. 用户评价
- GitHub 用户 FlorianPydde（仓库 issue #725）：反馈该技能目前依赖用户自我评估已有知识水平，建议在生成课程前先用几个针对性问题测出用户真实水平（例如有训练营经历但缺少底层基础的情况），并提交了一份在自己 fork 上验证过的实现方案。
- GitHub 用户 ayv4zyan（仓库 issue #864）：建议课程语言应更清晰、更“人性化”，提出可以结合该仓库另外两个技能（writing-for-agents、wait-what）的写作原则来改进课程文本质量。
- GitHub 用户 aleksandr-ovchinnikov（仓库 issue #668）：报告在同一工作区内多次调用该技能时，新会话未能正确读取此前
/teach会话留下的学习记录，属已知的跨会话状态衔接问题。
9. 其他补充
该技能是 Claude Code 官方插件市场 mattpocock-skills 插件包的一部分；作者同时维护一份技术 newsletter 持续更新该系列技能。
10. 安装使用方式
- Claude Code：
claude plugins install mattpocock-skills，或会话内/plugin install mattpocock-skills（官方插件市场只读订阅，随作者更新自动同步） - Codex / 其他通用 Agent：
npx skills@latest add mattpocock/skills，安装器会让你勾选需要的具体技能，只选teach即可独立使用 - 安装后：在对话中说“教我学 XXX”或“/teach“之类指令即可触发，技能会在当前目录下自动创建
MISSION.md、lessons/、learning-records/等文件；若目录中已有这些文件，会自动读取接续教学
11. 注意事项
- 已有用户报告跨会话学习记录衔接不完全可靠的情况（见第 8 章 issue #668），连续多次学习同一主题时建议自行核对
learning-records/是否完整 - 课程知识默认要求“优先查找权威一手资料、不信任参数化知识”，但实际检索质量取决于所用 agent 自带的网页检索能力，未内置独立的检索工具
- 在 OpenClaw 上未见专门验证，Hermes Agent 上未找到任何验证记录