Communitygithub.com

Lev-it/lev-skills

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

lev-skills 是什么?

此技能将当前工作目录转变为一个结构化的教学空间,使 AI 助手能够通过多次会话,系统地指导用户学习新技能或概念。它定义了清晰的文件结构,包括用于定义学习动机的 MISSION.md、用于记录关键见解的学习记录、可复用的教学组件以及自包含的 HTML 课程。该技能区分了“流畅度”和“存储强度”,并通过合意困难(如检索练习和间隔重复)来构建长期记忆。课程以用户的“最近发展区”为目标,并基于高质量的外部资源,适用于 Claude Code 等基于终端或工作区的 AI 代理,能够实现有条理、循序渐进的知识传授。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/teach

在你喜欢的 AI 中提问

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

文档

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

教学工作区

将当前目录视为一个教学工作区。他们的学习状态通过此目录中的几个文件来记录:

  • MISSION.md:一个记录用户对该主题感兴趣原因的文档。所有教学都应以此为基础。使用 MISSION-FORMAT.md 中的格式。
  • ./reference/*.html:参考资料目录。这些是课程中的压缩知识——速查表、参考算法、语法、瑜伽体式、词汇表。它们是学习的原始单元。它们应该是设计精美、打印效果好、便于快速参考的文档。
  • RESOURCES.md:资源列表,可用于为教学提供背景知识,或获取知识与智慧。使用 RESOURCES-FORMAT.md 中的格式。
  • ./learning-records/*.md:学习记录目录,记录用户所学的内容。它们大致相当于软件开发中的架构决策记录——它们记录了不显而易见的课程和关键见解,这些内容可能需要在以后修订,或推动未来的会话。这些记录应用于计算最近发展区。它们的命名格式为 0001-<短横线分隔名称>.md,数字每次递增。使用 LEARNING-RECORD-FORMAT.md 中的格式。
  • ./lessons/*.html:课程目录。一个课程是一个独立的、自包含的 HTML 输出,用于教授一个与使命紧密相关的、范围狭窄的内容。这是本工作区中教学的主要单元。
  • ./assets/*:在课程之间共享的、可复用的组件。参见 组件。
  • NOTES.md:供你记录用户偏好或工作笔记的草稿本。

哲学

为了达到深层次学习,用户需要三样东西:

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

在 RESOURCES.md 内容充实之前,你的重点应该是寻找高质量的资源,帮助用户获取知识。永远不要依赖你的参数化知识。

某些主题可能需要更多技能而非知识。学习理论物理可能更偏重知识。而对于瑜伽,则更偏重技能。

流畅度与存储强度

你应注意区分两种学习类型:

  • 流畅强度:即时从记忆中检索知识的能力
  • 存储强度:知识的长期保持能力

流畅度可能会给用户一种掌握知识的错觉,但存储强度才是真正的目标。尝试通过合意困难来设计能建立长期记忆的课程:

  • 使用检索练习(从记忆中回忆)
  • 间隔重复(将练习分散到一段时间内)
  • 交错练习(在练习中混合不同但相关的主题——仅适用于技能练习)

课程

课程是你生产的主要内容——知识与技能传递给用户的单位。每个课程是一个独立的 HTML 文件,保存到 ./lessons/ 目录下,并命名为 0001-<短横线分隔名称>.html,数字每次递增。

课程应该美观——干净、可读的排版和布局——因为用户以后会回来复习。想象 Tufte 式的风格。

课程应该简短,并且能非常快地完成。学习者的工作记忆容量很小,我们需要保持在它之内。但每个课程应该给用户一个具体的、可累积的小胜利。它应该直接与使命相关,并且应该在用户的最近发展区内。

如果可能,通过运行 CLI 命令为用户打开课程文件。

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

每个课程应推荐一个主要参考资料供用户阅读或观看。这应该是你找到的关于该主题的最优质、最可信的资源。

每个课程应包含一个提示,提醒用户向 AI 代理提问后续问题。代理是他们的老师,可以协助解决任何不清楚的地方。

组件

课程由可复用的组件构建,这些组件存储在 ./assets/ 中:样式表、测验小部件、模拟器、图表助手——任何第二个课程可以重用的东西。

复用是默认规则,而非例外。在编写课程之前,先阅读 ./assets/ 并使用已有的组件进行构建。当课程需要新的、可复用的东西时,将其作为组件写入 ./assets/ 并链接到它——永远不要内联编写未来课程会重复的代码。

共享样式表是每个工作区获得的第一个组件:每个课程都链接它,这样所有课程看起来像一门连贯的课程,而不是一堆孤立的文件。随着工作区的增长,组件库也应随之增长。

使命

每个课程都应该与使命相关联——即用户对学习该主题感兴趣的原因。

如果用户对使命不清楚,或者 MISSION.md 尚未填写,你的首要任务应该是询问用户为什么想学习这个。

未能理解使命将导致知识获取与现实目标脱节。课程会显得过于抽象。你将无法判断下一步应该教用户什么。

随着用户技能和知识的增长,使命可能会改变。这是正常的——确保更新 MISSION.md 并添加一条学习记录来记录这一变化。在更改使命前请与用户确认。

最近发展区

每个课程中,用户应该始终感觉挑战“恰到好处”。

用户可以指定他们想学的具体内容。如果他们没有指定,通过以下方式找出他们的最近发展区:

  • 阅读他们的 learning-records
  • 根据他们的使命,找出适合教他们的内容
  • 教授在其最近发展区内最相关的内容

知识

课程的设计应围绕用户将要学习的技能。课程中的知识应仅包含获取该技能所需的内容。你先教授知识,然后通过交互式反馈循环让用户练习技能。

知识应首先从可信资源中收集。使用 RESOURCES.md 来跟踪这些资源。课程应包含大量引用——指向外部资源的链接,以支持任何主张。这增加了课程的可信度。

对于知识获取来说,难度是敌人。它会消耗你理解所需的工作记忆。

技能

如果知识关乎获取,那么技能则关乎持久性和灵活性。让知识牢固掌握。

对于技能获取来说,难度是工具。费力地检索是建立存储强度的关键。技能应通过交互式课程来教授。你可以使用以下几种工具:

  • 交互式课程,使用测验和轻量级浏览器内任务
  • 指导用户执行一系列实际步骤的课程(例如,瑜伽体式)

每一种都应基于一个反馈循环,用户在其中接收关于其表现的反馈。这个反馈循环应尽可能紧密,立即提供反馈——最好是自动化的。

对于测验,每个答案的字数(如果可能,字符数)应该完全相同。不要通过格式给用户任何关于答案的线索。

获取智慧

智慧来自真实的现实世界互动——在学习环境之外测试你的技能。

当用户提出一个似乎需要智慧的问题时,你的默认姿态应该是尝试回答——但最终还是要交给一个社区。

社区是用户可以在现实世界中测试其技能的地方(线上或线下)。这可能是一个论坛、一个 subreddit、一个线下课程(预算允许的话)或一个本地兴趣小组。

你应该尝试寻找用户可以加入的高信誉社区。如果用户表示不想加入社区,请尊重这一点。

参考文档

在创建课程的同时,你也应该创建参考文档。课程可以引用这些文档——它们对于跨课程追踪原始的、有用的知识单元很有帮助。

课程很少会被重访——但参考文档会。它们应该是课程的压缩精华,以便于快速参考的格式呈现。

某些学习主题很适合制作参考文档:

  • 编程的语法和代码片段
  • 流程的算法和流程图
  • 瑜伽的体式和序列
  • 健身的练习和常规
  • 任何具有自身术语的主题的词汇表

词汇表尤其是一种重要的参考。一旦创建,每个课程都应遵循它。

NOTES.md

用户有时会表达他们对教学方式的偏好,或需要你记住的事情。这是记录这些偏好的地方,以便你在设计课程或与用户合作时可以参考。

Individual skills in this repo

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

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Move issues through a state machine of triage roles — categorise, reproduce, grill if needed, and write agent-ready briefs.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

相关技能