Communitygithub.com

AlemTuzlak/skills

当用户想要从零开始深入学习一个新主题时使用。运行预面试(当前知识、最终目标水平、深度、练习量、背景、范围),在线研究(文章、小众博主博客、权威文档、子主题全景),然后制作一个结构化的 Markdown 课程,其中包含强制性的视觉图表、基于证据的学习科学功能(检索练习、间隔回访、工作示例淡出、概念账本、术语门、类比卫生),以及一个自包含的交互式 HTML 迷你课程。通过 /teach-me、“教我关于 X”、“我想学习 X”、“深入探讨 X”、“创建关于 X 的课程”、“和我一起学习 X” 触发。

skills 是什么?

AlemTuzlak/skills 是一个 AI 助手技能,旨在通过生成结构化的 Markdown 课程和自包含的交互式 HTML 迷你课程,促进基于证据的深度学习。它从一次全面的预面试开始,评估用户当前的知识、期望的熟练程度、所需深度、练习偏好和已熟悉领域,以进行个性化类比映射。然后,该技能并行运行四个研究代理(权威内容、小众影响者、权威参考、子主题分类),以全面覆盖主题。输出遵循严格的认知原则(如检索练习、间隔回放、工作示例淡出和概念账本),以确保有效学习。该技能以开发者工具平台(如 Claude Code、Cursor、Codex)为目标,通过一个多阶段流程运行:主题解析、输出位置配置、预面试、研究、大纲创建、用户章节选择、编写指南生成、并行章节写作、一致性检查以及最终的 HTML 构建。它支持多种调用方式,如“教我关于 X”、“深入探讨 X”或“和我一起学习 X”,并自动在浏览器中打开完成的课程。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/teach-me

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

/teach-me — 基于证据的课程生成器

为任何用户想要学习的主题生成自定进度的 Markdown 课程 + 自包含的 HTML 迷你课程。专为成人学习者设计(CEFR B1 阅读水平,无需先验知识),基于认知心理学和教学设计研究。

何时使用

  • 用户调用 /teach-me <topic>(或无参数 — 询问主题)
  • 用户说“教我关于 X”、“我想学习 X”、“深入探讨 X”、“创建关于 X 的课程”、“和我一起学习 X”
  • 跳过以下情况:快速事实性问题(“X 是什么” — 直接回答)、代码帮助、调试、文档查找、库 API 问题(改用 context7)

教学法基础(开始工作前阅读)

该技能基于经过充分验证的学习科学。以下规则不是可协商的默认值 — 它们是用户付费所获得的:

  1. 具体先于抽象(Goldstone, Fyfe 等)。每章在提出任何抽象定义之前,先以一个具体的可观察实例开头。
  2. 检索练习优于重读(Roediger & Karpicke; Rowland 2014 年元分析)。每章以 3-5 个自由回忆提示 + 1 个跨章节回访结束。
  3. 通过有意的回访实现间隔接触(Cepeda 等,2006 年)。每个主要概念在后续 ≥2 章中被使用(而非重新定义)。
  4. 工作示例 + 后向淡出(Sweller, Renkl & Atkinson)。早期章节:完整的工作示例。中期:逐步留空的步骤。后期:仅提示。
  5. 认知负荷理论(Sweller, Mayer)。每章最多约 4 个新命名概念。一次只增加一个难度维度。
  6. 分块/卡片(Mayer & Pilegard)。章节是 250-500 字的卡片组,每张卡片一个概念,每张卡片一个图表。
  7. 图表优先的视觉连贯性(Mayer 多媒体原则)。关系性概念必须使用图表。无装饰性图像。标签内联在图表上,而非单独图例。
  8. 类比卫生(Gentner 结构映射)。每个类比在 2 个句子内附上明确的“此处在何处失效”声明。
  9. 术语门(Nathan/Koedinger 专家盲点研究)。每个技术术语在首次使用时定义,或链接到来自早期章节的词条条目。没有例外,即使是“常见”术语。
  10. 受限的自我解释提示(Chi 等; Bisra 等,2018 年,g≈0.55)。在卡片之间:“完成这个句子:X 之所以有效是因为 ___”,并提供带切换按钮的模型答案。
  11. 面向 B1 读者的简单语言。平均句子 ≤18 个词,最多 25 个。每个句子 ≤1 个从句。被动语态 ≤10%。主动语态。第二人称。无习语。
  12. 建立在学习者已知的内容上(Ausubel)。预面试捕获用户已知领域;写作指南将其转化为类比库。
  13. 展示状态变化,而非叙述它们(Larkin & Simon 1987; Tversky & Morrison 2002 理解原则; Wong/Leahy/Marcus/Sweller 2012 瞬时信息效应; Tufte 小倍数; Mayer 的分块原则)。当行文需要逐步描述连续状态时(“首先发生这个,然后发生那个,碰撞之后……”),使用一个 2-5 面板的 <div class="state-sequence"> 代替。每个面板具有相同形状,标注差异,标题 = 触发条件 + 不变特征。读者看到演变过程;他们不会读一个故事。

已被反驳 — 切勿使用: 学习风格(VAK)、一万小时定律框架、游戏化连续打卡/徽章、用于“提高参与度”的装饰性图像、“右脑/左脑”、“数字原住民”。

流程

digraph teach_me {
  rankdir=TB;
  "解析调用" [shape=box];
  "已存在文件夹?" [shape=diamond];
  "输出位置" [shape=box];
  "预面试" [shape=box];
  "研究(4 个并行代理)" [shape=box];
  "综合并撰写 OUTLINE.md" [shape=box];
  "用户选择章节" [shape=box];
  "撰写 WRITING_GUIDE.md" [shape=box];
  "章节生成(并行批次)" [shape=box];
  "一致性检查" [shape=box];
  "构建 index.html" [shape=box];
  "打开文件夹和浏览器" [shape=doublecircle];

  "解析调用" -> "已存在文件夹?";
  "已存在文件夹?" -> "输出位置" [label="否"];
  "已存在文件夹?" -> "输出位置" [label="扩展 / 重新开始 / 取消"];
  "输出位置" -> "预面试";
  "预面试" -> "研究(4 个并行代理)";
  "研究(4 个并行代理)" -> "综合并撰写 OUTLINE.md";
  "综合并撰写 OUTLINE.md" -> "用户选择章节";
  "用户选择章节" -> "撰写 WRITING_GUIDE.md";
  "撰写 WRITING_GUIDE.md" -> "章节生成(并行批次)";
  "章节生成(并行批次)" -> "一致性检查";
  "一致性检查" -> "构建 index.html";
  "构建 index.html" -> "打开文件夹和浏览器";
}

不要跳过任何阶段。 使用 TaskCreate 跟踪进度,以便用户了解您所处位置。


阶段 0 — 解析调用

  1. 从参数中获取主题。如果没有参数,回复:“你想学习什么主题?可以是技术性的(库、语言、概念)或非技术性的(哲学、领域、技能)。” 然后等待。
  2. 主题验证防护:
    • 如果主题是有害的(武器合成、恶意黑客攻击目标、非法行为)— 简要拒绝并停止。不进行说教。
    • 如果主题过于宽泛(编程、科学、一切)— 要求用户通过 2-3 个具体示例来缩小范围:“这太宽泛了。是否要缩小到像‘TypeScript 中的异步编程模式’或‘编译器如何工作’这样的范围?” 等待一个更窄的答案。
    • 如果主题模糊但可处理(AI、数据库)— 继续;面试中的自由格式范围问题将进一步缩小。
  3. 计算 slug:小写,将非字母数字字符替换为 -,折叠重复的 -,修剪。示例:Asynchronous Programming → asynchronous-programming。

阶段 1 — 检查已存在的文件夹

  1. 从记忆中读取输出位置(有关如何存储,请参见阶段 2)。如果记忆中还没有位置,则将此检查推迟到阶段 2 收集位置之后。
  2. 检查 <output-location>/learn-<slug>/ 是否已存在。
  3. 如果存在,通过 AskUserQuestion 提供三个选项:
    • 扩展 — 添加新章节、使用新的样式注释重新生成特定章节、或刷新研究并重新选择。
    • 重新开始 — 将现有文件夹重命名为 learn-<slug>-archived-YYYY-MM-DD/ 并继续新课程。
    • 取消 — 停止。
  4. 如果选择 扩展:子选项 — (a) 添加关于新子主题的章节(跳过研究,使用先前的 OUTLINE.md 作为上下文),(b) 使用新的注释重新生成特定章节编号(跳过这些章节的写作阶段),(c) 刷新研究并重新选择章节(完整重新运行,合并先前的 OUTLINE.md)。
  5. 切勿破坏性地覆盖先前课程。

阶段 2 — 输出位置

  1. 在记忆中搜索标记为 teach-me-output-location 或类似的条目。使用 Glob 搜索 C:/Users/AlemTuzlak/.claude/projects/F--projects/memory/*.md 并使用 Grep 搜索 teach-me。
  2. 如果找到且路径仍然存在,则使用它。简要说明:“正在写入 <path>。”
  3. 如果未找到,通过 AskUserQuestion 询问:
    • 使用 F:/projects/learning/ (如果缺失则创建文件夹)— 推荐。
    • 使用当前工作目录(./)。
    • 指定其他路径 — 用户通过“其他”提供。
  4. 在用户回答后,询问:“保存此位置以用于未来的 /teach-me 运行吗?” — 通过 AskUserQuestion 回答是/否。
  5. 如果是,写入一个记忆文件 teach_me_output_location.md,包含前导数据 type: user 和正文中的路径。在 MEMORY.md 中添加一行。
  6. 现在使用解析后的位置重试阶段 1 的已存在文件夹检查。

阶段 3 — 预面试

分两轮询问:

第一轮 — 单个 AskUserQuestion,包含 4 个结构化问题

Q1 [当前知识]:您对 <topic> 已经了解多少?
  - 从未听说过
  - 知道术语,无实践经验
  - 已经构建过基本的东西
  - 中级从业者

Q2 [最终目标熟练程度]:您希望达到什么水平?
  - 仅概念性概述
  - 能够构建基本的东西
  - 能够构建生产级的东西
  - 能够教导他人

Q3 [深度预算]:您想要多少内容?
  - 快速入门(约 3-5 章)
  - 标准(约 6-10 章)
  - 深入探索(所有研究内容,10-15+ 章)

Q4 [练习量]:想要多少动手练习?
  - 轻量(以阅读为主)
  - 标准(阅读 + 检索 + 偶尔练习)
  - 繁重(每章都有工作示例和练习)

第二轮 — 单个纯文本消息回复

发送此确切消息(替换 <topic>):

在我开始研究之前,还有两件事:

1. 您已经精通什么? 列出您投入过大量时间的所有语言、框架、领域、爱好 — 例如“TypeScript, React, 音乐理论, 烹饪, 国际象棋”。我会将这些用作类比来源,将新概念锚定在您已知的内容上。

2. 在 内是否有特定角度,还是我应该广泛覆盖?说“让我惊喜”以获得全面覆盖。

等待一个包含两者的单一回复。宽松解析 — 接受逗号分隔列表、项目符号列表或自由格式。

将答案持久化到一个工作结构中(稍后您会将其写入 OUTLINE.md 和 WRITING_GUIDE.md 中)。

阶段 4 — 研究(4 个并行代理)

分派一个批处理 Agent 调用,包含 4 个 general-purpose 子代理。它们并行运行。每个代理获得一个自包含的简要说明,并报告一个结构化的报告。

通道 A — 权威内容。 查找关于 <topic> 的最佳文章、教程、会议演讲和论文。使用 WebSearch + WebFetch 获取信号最强的结果。返回 8-15 个结果,每个附上一行“阅读原因”,标记为 [article|tutorial|talk|paper]。

通道 B — 小众影响者和从业者。 查找在 <topic> 领域知名的特定人物 — 不是技术名人,而是拥有个人博客/新闻通讯/Twitter、在该小众领域深入钻研的从业者。返回 4-8 个结果,包含:姓名、个人渠道(博客 URL)、代表性文章 URL、以及一行说明他们为何值得关注。跳过任何产出仅为公司营销的人。

通道 C — 权威参考。 官方文档、规范、参考实现、权威教科书。如果 <topic> 是一个库/框架/CLI 工具,使用 context7 MCP(resolve-library-id 然后 query-docs)获取当前权威文档。返回 3-8 个来源,包含版本信息。

通道 D — 子主题全景和规范语言。 调研主题以生成一个子主题树,每个子主题附有一行描述(通常 8-15 个子主题)。建议一个教学顺序(先决条件优先,高级内容最后)。如果主题是技术性的,确定官方文档使用/生产中最常见的规范语言(例如 Temporal → TypeScript 或 Go;LangGraph → Python)。明确说明:“规范语言:X,因为 Y。”

每个代理的报告限制在 800 字以内,并结构化。所有 4 个代理返回后,进行综合分析。

阶段 5 — 大纲和章节选择

  1. 编写 <output-location>/learn-<slug>/OUTLINE.md,结构如下:
# 学习 <Topic>

## 您的目标(已记录)
- **当前水平**:<来自 Q1 的答案>
- **目标熟练程度**:<来自 Q2 的答案>
- **深度**:<来自 Q3 的答案>
- **练习量**:<来自 Q4 的答案>
- **已知领域(类比库)**:<来自第二轮的逗号分隔列表>
- **范围/角度**:<来自第二轮的答案>

## 子主题全景(来自研究)
1. <子主题 1> — <一行描述>
2. <子主题 2> — <一行描述>
...

## 建议顺序
一个尊重先决条件的顺序,并为每一步提供理由。

## 推荐章节(约 N 章,基于您的深度预算)
编号列表形式的建议章节。每个条目:简短标题 + 覆盖内容的一行说明 + 估计的卡片数(每章 5-9 张)。

## 规范语言(仅限技术主题)
<语言和一行理由>

## 推荐来源
- [来源 1](url) — [类型] — 阅读原因
...

## 值得关注的小众影响者
- **姓名** — [博客 url] — 代表性文章:[文章 url] — 一行说明为何值得关注
...
  1. 自动打开文件:Bash code --new-window "<absolute-path-to-OUTLINE.md>"。
  2. 回复用户,使用此确切消息(适当替换):

我已将大纲写入 <绝对路径> 并为您打开。

回复要编写的章节:

  • all — 编写所有推荐的章节
  • 1,3,5-7 — 特定章节或范围
  • 自由格式 — 用您自己的语言描述要关注的内容
  • reshape — 在提交前告诉我添加、删除、合并或重新排序的内容

如果您选择 reshape,我将采纳您的注释,修改 OUTLINE.md,保存,重新打开,并再次询问。循环直到确认。

  1. 如果用户说 reshape,采纳他们的注释,修改 OUTLINE.md,保存,重新打开,再次询问。循环直到确认。
  2. 将选择解析为最终的排序章节列表 picks = [...]。

阶段 6 — 编写 WRITING_GUIDE.md

编写 <output-location>/learn-<slug>/WRITING_GUIDE.md。此文件是所有章节编写代理和一致性检查代理的共享简要说明。它必须全面且具体。

使用 <skill-dir>/assets/templates/WRITING_GUIDE.template.md 处的模板作为起点 — 将用户记录的面试答案替换到占位符中({{TOPIC}}、{{CURRENT_LEVEL}}、{{TARGET_PROFICIENCY}}、{{PRACTICE_LOAD}}、{{KNOWN_DOMAINS}}、{{SCOPE}}、{{CANONICAL_LANGUAGE}})。

同时指向章节编写者在 <skill-dir>/assets/COMPONENTS.md 处的组件库参考 — 他们应在编写前浏览。提示卡片、图表卡片、比较块、选项卡、统计卡片、平台标签和步骤列表都可用;有些是从 Markdown 约定自动生成的,其余的是 Markdown 内部的显式 HTML。

验证生成的文件强制实施了此 SKILL.md 顶部“教学法基础”部分中列出的所有 12 条教学法规则。如果指南中缺少任何规则,请在继续之前添加。

阶段 7 — 章节生成(并行批次)

以 每轮 3-5 个编写子代理的并行批次 生成选定的章节,跨顺序轮次进行。

每轮:

  1. ...

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants to write a video script for a product demo, feature walkthrough, launch video, or social media video about a feature or product change

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

相关技能