AGENT SKILL

teach

在本工作区内教用户一项新技能或概念。

License 许可
MIT
所属仓库
luestr/skills
最近更新
2026-11-14
Stars
★ 94
Forks
1

01 前言 Front Matter

name
teach
metadata
{ "language": "zh-CN", "argument-hint": "你想学习什么?", "disable-model-invocation": true }
description
在本工作区内教用户一项新技能或概念。

02 资源文件 5

03 SKILL.md 正文

用户要求你教他们一些东西。这是一个有状态的请求——他们打算跨多个会话学习这个主题。

教学工作区

把当前目录当作教学工作区。工作区路径(./lessons/ 等)从运行 /teach 时所在的目录开始解析;只有 *-FORMAT.md 链接从本技能的文件夹解析。他们的学习状态由这个目录下的若干文件记录:

  • MISSION.md:记录用户对这个主题感兴趣的_原因_的文档。所有教学都应以它为依据。使用 MISSION-FORMAT.md 中的格式。
  • ./reference/*.html:存放参考资料的目录。这些是从课程中压缩出来的学习成果——速查表、参考算法、语法、瑜伽体式、术语表。它们是学习的原始单元。它们应当是美观的文档,打印效果好,并且为快速查阅而设计。
  • RESOURCES.md:一份资源清单,可用于把你的教学扎根在带语境的知识里,或用于获取知识与智慧。使用 RESOURCES-FORMAT.md 中的格式。
  • ./learning-records/*.md:存放学习记录的目录,记录用户学到了什么。它们大致相当于软件开发中的架构决策记录(ADR)——记录那些不明显、日后可能需要修订、或会驱动未来会话的经验教训与关键洞见。应依据它们计算最近发展区。它们按 0001-<dash-case-name>.md 命名,编号每次递增。使用 LEARNING-RECORD-FORMAT.md 中的格式。
  • ./lessons/*.html:存放课程的目录。课程是一份自包含的 HTML 产出,只教一件与使命紧密挂钩、范围收得很窄的事。它是这个教学工作区里主要的教学单元。
  • ./assets/*:跨课程复用的组件。见资产。
  • NOTES.md:给你随手记下用户偏好或工作笔记的草稿本。

理念

要在深层学习,用户需要三样东西:

  • 知识,来自高质量、高可信度的资源
  • 技能,通过你基于这些知识设计的、高度相关的互动课程习得
  • 智慧,来自与其他学习者和实践者的互动

在 RESOURCES.md 充实起来之前,你的重点应该是找到能帮助用户获取知识的高质量资源。永远不要相信你的参数化知识。

有些主题需要的技能多于知识。深入学习理论物理可能更偏知识;瑜伽则更偏技能。

流畅强度与存储强度

你要小心区分两类学习:

  • 流畅强度:当下对知识的提取
  • 存储强度:知识的长期保持

流畅强度会给用户一种虚假的精通感,而存储强度才是真正的目标。设计课程时,要通过合意困难来建立长期保持:

  • 使用提取练习(凭记忆回想)
  • 间隔练习(把练习分散到不同时间)
  • 交错练习(在练习中混着练不同但相关的主题——仅用于技能练习)

课程

课程是你最主要的产品:知识与技能借由它抵达用户。每节课是一个自包含的 HTML 文件,保存到 ./lessons/,按 0001-<dash-case-name>.html 命名,编号每次递增。

课程应当美观,排版和布局干净易读,因为用户之后会回来复习它们。想想 Tufte。

课程要短,能很快完成。学习者的工作记忆很小,我们必须待在它的容量之内。但每节课都应给用户一个实实在在、可以在此基础上继续积累的收获。课程应直接与使命挂钩,并落在用户的最近发展区内。

如果可能,运行一条 CLI 命令替用户打开课程文件。

每节课都应通过 HTML 锚点链接到其他课程和参考文档。

每节课都应推荐一份供用户阅读或观看的一手资料。它应该是你在该主题上找到的质量最高、可信度最高的资源。

每节课都应包含一句提醒:可以向 Agent 追问。Agent 是他们的老师,任何不清楚的地方都可以帮忙。

资产

课程由可复用的组件搭建而成,组件存放在 ./assets/:样式表、测验组件、模拟器、图示辅助工具,以及其他任何第二节课能复用的东西。

复用是默认做法,而不是例外。写课程之前,先读 ./assets/,用已有的组件来搭。当某节课需要新的、可复用的东西时,把它写成 ./assets/ 里的组件并链接过去;绝不要把代码内联,让未来的课程重复一遍。

共享样式表是每个工作区最先挣来的组件:每节课都链接它,于是课程看起来像一门前后一致的课程,而不是一堆各写各的成品。工作区成长,组件库也应一同成长。

使命

每节课都应与使命挂钩——用户对学习这个主题感兴趣的原因。

如果用户对使命不清楚,或 MISSION.md 还没填,你的第一项工作就是追问用户为什么想学这个。

不理解使命,知识获取就不会扎根于现实目标。课程会显得过于抽象。你将无从判断用户接下来该做什么。

随着用户技能和知识的增长,使命可能改变。这很正常——务必更新 MISSION.md,并新增一条学习记录来记下这次变化。改动使命之前先与用户确认。

最近发展区

每节课上,用户都应始终感觉自己受到的挑战“刚刚好”。

用户可能明确说出想学的东西。如果没有,就通过以下方式确定他们的最近发展区:

  • 阅读他们的 learning-records
  • 根据他们的使命判断该教什么
  • 教最相关、又落在其最近发展区内的事

知识

课程应围绕用户将要学习的一项技能来设计。课程里的知识应只包含习得该技能所必需的部分。你先教知识,然后通过互动反馈回路让用户练习技能。

知识应首先从可信资源中收集。用 RESOURCES.md 跟踪这些资源。课程里应布满引用——用外部资源链接为提出的每个论断背书。这能提高课程的可信度。

获取知识时,困难是敌人。它会吃掉你理解所需的工作记忆。

技能

如果说知识的重点是获取,那么技能的重点就是耐久与灵活。让知识留下来。

习得技能时,困难是工具。费力的提取才能建立存储强度。技能应通过互动课程来教。你有若干工具可用:

  • 互动课程,使用测验和轻量的浏览器内任务
  • 引导用户依次完成一串现实步骤的课程(例如瑜伽体式)

这些都应以反馈回路为基础,让用户得到关于自己表现的反馈。反馈回路应尽可能紧凑,立即给出反馈——最好还能自动给出。

对于测验,每个选项的字数(如果可能,还包括字符数)应完全相同。让正确答案的位置在各题之间变化。不要通过格式或顺序给用户任何关于答案的暗示。

获取智慧

智慧来自真正的现实互动——在学习环境之外检验你的技能。

当用户提出一个看起来需要智慧的问题时,你的默认姿态应是尝试回答——但最终把它交给社群。

社群是一个场所(线上或线下),用户可以在那里把自己的技能拿到真实世界里检验。它可能是论坛、subreddit、线下课程(预算允许的话),或本地兴趣小组。

你应尝试寻找声誉高的社群,供用户加入。如果用户表示不想加入任何社群,尊重这一点。

参考文档

创建课程的同时,你也应创建参考文档。课程可以引用这些文档——它们便于跟踪那些跨课程都有用的原始知识单元。

课程日后很少会被重看——参考文档则会被。它们应是课程的压缩精华,采用便于快速查阅的格式。

有些学习主题适合做成参考:

  • 编程的语法与代码片段
  • 流程的算法与流程图
  • 瑜伽的体式与序列
  • 健身的练习与训练计划
  • 任何有自己一套命名体系的主题的术语表

术语表尤其重要,是必不可少的参考。一旦建立,每节课都应遵循它。

NOTES.md

用户有时会表达他们希望被怎样教,或有哪些事你要记在心里。这个文件就是记录这些偏好的地方,这样你在设计课程或与用户协作时可以回头查阅。

04 同仓库更多 Skills

luestr
luestr/skills

write-ublock-origin-filters

完整的 uBlock Origin (uBO) 静态过滤语法参考。编写 uBlock Origin 自定义过滤规则时使用此技能,涵盖广告拦截、隐私保护或内容过滤。包含基础网络过滤模式(||、*、^、|)、所有网络过滤选项($domain、$third-party、$important、$redirect、$removeparam、$csp、$replace、$header、$method、$denyallow、$badfilter、$all 等)、内容类型选项($script、$image、$stylesheet、$font、$media、$xhr、$popup、$document、$frame 等)、元素隐藏规则(## 选择器、实体匹配、主机名正则)、过程式元素隐藏过滤器(:has、:has-text、:matches-css、:upward、:xpath、:matches-path、:watch-attr 等)、动作操作符(:remove、:style、:remove-attr、:remove-class)、HTML 过滤器(##^)、响应头过滤(##^responseheader)、脚本注入(##+js())以及预处理指令(!#include、!#if)。当用户提到 uBlock Origin 过滤规则、uBO 语法、广告拦截规则、元素隐藏规则、过程式选择器、脚本注入或希望编写/调试任何 uBO 兼容过滤列表时触发。即使用户只是在编写或调试 uBlock Origin 过滤规则、创建自定义过滤列表或从 AdBlock Plus/AdGuard 迁移过滤规则到 uBO,也应使用此技能。

★ 94
luestr
luestr/skills

write-ublock-origin-filters

Complete uBlock Origin (uBO) static filter reference. Use this skill when writing or debugging uBO custom filters or filter lists for ad blocking, privacy or content filtering, or when migrating filters from AdBlock Plus/AdGuard. Covers network patterns (||, *, ^, |) and options ($domain, $third-party, $important, $redirect, $removeparam, $csp, $replace, $header, $method, $badfilter, $all), content-type options ($script, $image, $stylesheet, $font, $media, $xhr, $popup, $document, $frame), cosmetic filters (##, CSS selectors, entity matching), procedural filters (:has, :has-text, :matches-css, :upward, :xpath, :matches-path, :watch-attr), action operators (:remove, :style, :remove-attr), HTML filters (##^), response-header filtering (##^responseheader), scriptlet injection (##+js()), and pre-parsing directives (!#include, !#if). Trigger whenever the user mentions uBO syntax, ad blocking rules, element hiding, procedural selectors, scriptlet injection, or a uBO-compatible filter list.

★ 94
luestr
luestr/skills

write-tampermonkey-scripts

引导 AI 代理规划、编写、调试、测试和维护 Tampermonkey 用户脚本。当用户请求用户脚本、浏览器页面自动化、DOM 增强、Tampermonkey 元数据、GM_* API、@match、@grant、@run-at、@connect、跨源请求、SPA 页面集成或脚本注入任务时使用此技能,即使用户没有明确提及 Tampermonkey。

★ 94
luestr
luestr/skills

write-tampermonkey-scripts

Guide an AI agent through planning, writing, debugging, testing, and maintaining Tampermonkey userscripts. Use this skill whenever a user asks for a userscript, browser-page automation, DOM enhancement, Tampermonkey metadata, GM_* API, @match, @grant, @run-at, @connect, cross-origin request, SPA page integration, or script injection task, even when Tampermonkey is not named explicitly.

★ 94
luestr
luestr/skills

write-adguard-filters

编写 AdGuard 自定义过滤规则时使用此技能。涵盖基本规则语法、所有修饰符($domain/$third-party/$important/$redirect/$replace/$removeparam/$cookie/$csp 等)、外观规则(元素隐藏/CSS/Extended CSS 选择器)、HTML 过滤、JavaScript/脚本片段规则、非基本规则修饰符、预处理器指令和调试技巧。当用户提及 AdGuard 过滤规则、广告拦截规则语法、过滤器列表编写、ABP 语法兼容、元素隐藏规则、Extended CSS 选择器(:has/:contains/:matches-css 等)时触发。即使用户只是在编写或调试任何类型的广告过滤规则,也应使用此技能。

★ 94
luestr
luestr/skills

write-adguard-filters

Complete AdGuard filtering rules syntax reference. Use this skill when writing AdGuard custom filters. Covers basic rule syntax, all modifiers ($domain/$third-party/$important/$redirect/$replace/$removeparam/$cookie/$csp etc.), cosmetic rules (element hiding/CSS/Extended CSS selectors), HTML filtering, JavaScript/scriptlet rules, non-basic rule modifiers, preprocessor directives, and debugging. Trigger when user mentions AdGuard filtering rules, ad blocking rule syntax, filter list authoring, ABP syntax compatibility, element hiding rules, Extended CSS selectors (:has/:contains/:matches-css etc.). Use this skill even when the user is just writing or debugging any type of ad filtering rules.

★ 94