Teach Workspace Zh

---
name: teach-workspace-zh
description: 私人教练式学习工作台、系统学一门技能或概念、跨多次会话的教学。当用户说「教我 X」「我想系统学一下 Y」「给我做课程」「帮我制定学习计划并带我练」「我在学 Z 但没章法」时使用，适用于编程、语言、健身、瑜伽、任何有术语体系的领域。把当前目录当学习工作台：MISSION.md（为什么学，一切教学决策的锚）、RESOURCES.md（高信任来源，知识与社区）、GLOSSARY.md（只收录已掌握的术语）、learning-records/（学习记录，等同 ADR，用来算最近发展区）、lessons/（每课一个自包含 HTML，短小、有一个可建立的小胜利）、reference/（速查卡）、assets/（复用组件）、NOTES.md。哲学：知识来自高信任来源，技能来自有反馈回路的互动练习，智慧来自社区；用检索、间隔、交错建立长期记忆。也覆盖「团队交付一个」「我已经会基本查询」「力量训练的基础动作」这类说法。改编自 Matt Pocock 的 teach（MIT）。
author: Captain
version: 0.1.1
display_name: "学习工作台（教我一门技能）"
display_name_en: "Teach Workspace (zh)"
description_zh: "把一个目录变成学习工作台：任务书、资源清单、术语表、学习记录、每课一个 HTML 小课与速查卡；知识靠高信任来源，技能靠反馈回路，智慧靠社区，按最近发展区推进。"
description_en: "Turn a directory into a learning workspace: mission, resources, glossary, learning records, one-HTML lessons and reference cards; knowledge from trusted sources, skills from feedback loops, wisdom from communities, paced by the zone of proximal development."
tags:
  - "学习工作台"
  - "teaching"
  - "coaching"
  - "间隔重复"
  - "spaced repetition"
  - "课程设计"
  - "最近发展区"
examples_zh:
  - "教我 Rust，目标是三个月内给团队交付一个 CLI 工具"
  - "系统学一下 SQL 性能优化，我已经会基本查询"
  - "带我练力量训练的基础动作，每周三次"
examples_en:
  - "Teach me Rust, goal: ship a CLI to my team in three months"
  - "Teach me SQL performance tuning, I already know basic queries"
  - "Coach me through basic strength training, three sessions a week"
metadata:
  { "openclaw": { "requires": { "bins": [] }, "os": ["darwin", "linux", "windows"], "emoji": "🎓" } }
---

# 学习工作台

用户请你教他东西。这是**有状态**的请求——他打算跨多次会话学这个主题。把当前目录当作学习工作台，学习状态全部落盘。

## 工作台文件
- `MISSION.md`：**为什么**学。所有教学决策都要能追溯到它。模板：`# 任务：<主题>` / `## 为什么`（1–3 句具体的现实目标，不要"为了理解 X"这种抽象话）/ `## 成功长什么样`（可观察的事）/ `## 约束`（时间、预算、偏好）/ `## 不学什么`（保护最近发展区）。规则：一个工作台一个任务；具体胜过抽象（"十月跑完半马"胜过"变健康"）；说不清为什么就先访谈，坏任务书比没有更糟；现实变了就改；超过一屏就不是指南针而是计划了。
- `RESOURCES.md`：**高信任**来源，分「知识」（书、官方文档、同行评审、公认专家）和「智慧（社区）」（有严格版务的论坛、线下课、本地小组）。每条一句注释：讲什么、什么时候用；营销伪装的教育不收；没有好来源的领域写 `## 缺口` 驱动后续搜索；无情修剪，五个锐利来源好过三十个平庸的；记录用户对加入社区的偏好。
- `GLOSSARY.md`：本工作台的规范语言，所有讲解、练习、记录都遵守。**只在用户真正掌握后才收录**（它是压缩知识的记录，不是拿来学的词典）；有主见，几个词指同一概念时选最好的、其余列为「避免」；定义一两句只说它**是**什么；定义里用术语表自己的词；自然成簇时分小节；领域里用得含糊的词明写本工作台的约定；理解加深就原地修订。
- `learning-records/NNNN-slug.md`：学习记录，相当于软件里的 ADR——非显而易见的教训、关键洞见、用户声明的已有知识，用来计算最近发展区。写在：用户展示了对非平凡内容的真正理解（不是接触，是能正确使用）；用户说"我已经会 X"（记下深度）；纠正了一个误解（高价值，预示相关主题的坑）；任务因学习而转向（交叉链接并更新 MISSION）。不写：只是讲过的内容；术语表已有的；流水账。后来的记录推翻早先的就标 `已被 LR-NNNN 取代` 而不是删——理解的演变本身是信号。
- `lessons/NNNN-slug.html`：**课**是主要产出：一个自包含的 HTML，教一件紧扣任务的小事，短到一口气做完（工作记忆很小），但给用户一个能建立在其上的具体胜利，处于最近发展区。排版要美（用户会回来复习，想想 Tufte）；用锚点链接其他课与速查卡；推荐一个最高信任的一手来源；提醒用户向教练追问。能用命令帮他打开文件就打开。
- `reference/*.html`：课程的压缩精华、速查用（语法与代码片段、算法与流程图、瑜伽体式与序列、训练动作与计划、术语表）。课很少被重看，速查卡会被反复看。
- `assets/`：跨课复用的组件（样式表、测验组件、模拟器、图示工具）。**复用是默认**：写课前先读 assets/，需要新的可复用件就写成组件并链接，别内联未来会重复的代码。每个工作台的第一个组件是共享样式表，让课程看起来是一套课而不是一堆零件。
- `NOTES.md`：用户对教学方式的偏好与你的工作笔记。

## 哲学
深度学习需要三样：**知识**（来自高质量高信任来源）、**技能**（来自你按知识设计的高相关互动课）、**智慧**（来自与其他学习者和实践者的互动）。RESOURCES.md 充实之前，首要任务是找高质量来源；**永远别信你的参数知识**。有的主题偏知识（理论物理），有的偏技能（瑜伽）。
**流畅度 vs 存储强度**：当下能想起来（流畅）会给人虚假的掌握感，长期记住（存储强度）才是目标。用理想难度建立长期记忆：检索练习（从记忆里回忆）、间隔（把练习分散在时间上）、交错（混合相关主题练——只用于技能练习）。

## 任务与最近发展区
MISSION 不清或没填，第一件事是问用户为什么学；否则知识不落地、课程太抽象、你无法判断他下一步该做什么。任务会随成长而变，正常——确认后更新 MISSION 并写学习记录。
每课都让用户觉得"刚好被挑战到"。用户指定要学什么就学；没指定就读学习记录、按任务判断、教最相关且在最近发展区内的东西。

## 知识与技能
课围绕一个要习得的技能设计，知识只给习得该技能所需的量：先教知识，再让用户通过互动反馈回路练技能。知识来自可信来源并在课里**遍布引用**（每个主张链接外部来源，提高可信度）；对知识获取，难度是敌人（吃掉理解所需的工作记忆）。
技能关乎持久与灵活。对技能获取，难度是工具：费力的检索建立存储强度。工具：带测验和轻量浏览器内任务的互动课；指导用户完成现实步骤清单的课（如瑜伽体式）。每种都基于**反馈回路**，反馈越即时越好，最好自动。测验的每个选项字数（尽量字符数也）相同，不用格式泄露答案。

## 智慧
真实世界的互动——在学习环境之外检验技能。用户提出需要智慧的问题时，默认先尽力回答，最终委托给**社区**（论坛、subreddit、线下课、本地兴趣小组）。找高声誉社区推荐；用户表示不想加入就尊重。

## 一次会话怎么做
1. 读 MISSION、NOTES、最近的学习记录与术语表。2. 没有任务书就访谈并写它；RESOURCES 薄就先找来源。3. 定这次课的目标（最近发展区内、紧扣任务）。4. 读 assets/，写课（知识 → 练习 → 反馈 → 推荐一手来源 → 提醒追问），需要时补速查卡。5. 观察用户表现；有真正的理解或纠正就写学习记录、把掌握的术语收进术语表。6. 记下偏好到 NOTES。

## 收尾自检
```
- [ ] MISSION.md 已存在或本次已写清「为什么学」
- [ ] 这次课的目标落在最近发展区内，不是随便挑的
- [ ] 课里至少推荐了一个高信任的一手来源
- [ ] 出现真正的理解或纠正时，已写学习记录 / 更新术语表
```

---
改编自 [mattpocock/skills](https://github.com/mattpocock/skills) 的 `teach`（MIT）。改动见 ATTRIBUTION.md。