Communitygithub.com

Lev-it/lev-skills

教導使用者一個新的技能或概念,並在此工作區內進行深入的互動學習。

lev-skills 是什麼?

這個技能將當前目錄轉變為一個結構化的教學工作區,專為跨越多個會話的深度學習而設計。它會建立並維護一系列關鍵文件,包括明確學習目標的MISSION.md、濃縮重點的參考文件、記錄非直觀見解的學習記錄、以及可重複使用的HTML課程。此技能的核心教學哲學是區分「流暢度」(短期記憶提取)與「儲存強度」(長期保留),並透過刻意引入適當難度(如提取練習、間隔練習、交錯練習)來促進真正的長期學習。它主要適用於Claude Code這類以文件與指令為基礎的AI代理工具,透過產生精美的HTML課程與參考文件,引導使用者從知識獲取、技能練習,最終邁向社群互動以獲得智慧,確保每次學習都能緊扣使用者的個人使命,並維持在他們的最近發展區內。

相容平台~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 錨點連結到其他課程和參考文件。

每個課程都應推薦一個主要資源供使用者閱讀或觀看。這應該是您找到的關於該主題最高品質、最高信任度的資源。

每個課程都應包含一個提醒,提示使用者向代理提問。代理是他們的老師,可以協助解答任何不清楚的地方。

元件

課程由可重複使用的元件構成,這些元件儲存在 ./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.

相關技能