菜单
Stateful multi-session teaching: 把当前目录当作 teaching workspace（MISSION / GLOSSARY / RESOURCES / learning-records），按 Knowledge-Skills-Wisdom 三要素 + zone of proximal development 教用户一门技能或概念。Use when 用户说「教我 X」「我想系统学 X」「teach me」「继续上次的学习」, or 在已有 teaching workspace 目录中继续学习。一次性技术答疑不触发——直接回答即可。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when 用户调用 /design-plan, or 需要为复杂跨服务需求(多服务改动 / 数据库 DDL / 新增对外接口 / 架构调整)产出可评审的技术方案文档,典型用户是技术主管 / 资深研发。简单单服务改动走 /workflow-spec,Bug 修复走 /fix-bug。
Use when asked to review a diff, do a pre-commit code review, or review staged/branch changes. Supports staged diffs, branch diffs, and session mode that reviews only files edited in the current conversation context.
Use when 用户调用 /plan-archive, or 三阶段研发流程的阶段三:在所有模块研发上线后,根据实际代码改动回写阶段一技术方案 + 项目级架构文档(docs/architecture / docs/contracts / docs/assets/概要设计 等)。
Use when 用户说「快速规划」「轻规划」「不走 workflow」「plan 一下」「quick plan」, or 需求清晰、作用域明确、可一次性规划完成的简单到中等任务。复杂项目(跨 module / 新子系统 / 需追溯)或需要正式需求文档 / PRD 请用 /workflow-spec。
Use when 用户调用 /spec-bootstrap, or 项目尚未建立 .claude/code-specs/ 骨架且需要初始化 code-specs 体系。
Use when 用户调用 /spec-update, or 工作中沉淀出新 convention / 接口 contract / 模式需要落到 .claude/code-specs/, or execute 末尾终审（workflow-execute Step 7）建议沉淀 code-spec。
| name | teach |
| description | Stateful multi-session teaching: 把当前目录当作 teaching workspace（MISSION / GLOSSARY / RESOURCES / learning-records），按 Knowledge-Skills-Wisdom 三要素 + zone of proximal development 教用户一门技能或概念。Use when 用户说「教我 X」「我想系统学 X」「teach me」「继续上次的学习」, or 在已有 teaching workspace 目录中继续学习。一次性技术答疑不触发——直接回答即可。 |
| argument-hint | <想学什么> |
| disable-model-invocation | true |
有状态的多 session 教学——用户打算跨多个 session 学完这个主题。当前目录 = teaching workspace。
学习状态全部落在这几个文件:
MISSION.md — 用户学这个主题的 原因。所有教学决策的锚点。格式见 references/MISSION-FORMAT.md。GLOSSARY.md — 主题 glossary。workspace 所有文件遵守其术语。格式见 references/GLOSSARY-FORMAT.md。RESOURCES.md — 可信资源清单,explainer 的知识来源,wisdom 的社区来源。格式见 references/RESOURCES-FORMAT.md。learning-records/*.md — 学习记录,教学版 ADR:记录非显然的 lesson 和关键 insight,用于推算 zone of proximal development。编号 0001-<dash-case-name>.md 递增。格式见 references/LEARNING-RECORD-FORMAT.md。./assets/* — 可复用组件库(样式表 / quiz 组件 / 模拟器 / 图表助手等)。跨多节课复用,见下方 ## Assets。课程从 ./assets/ 里的可复用组件构建,不是每节课各自内联。
./assets/,从已有组件搭。遇到新的可复用东西,抽成组件放回 ./assets/ 而不是内联进单节课./assets/深度学习需要三要素:
RESOURCES.md 未充实前,首要任务是找高质量资源。绝不信任参数化知识。
主题决定配比:理论物理偏 knowledge,瑜伽偏 skills。
每次教学都挂到 mission——用户学这个主题的原因。
用户讲不清 mission 或 MISSION.md 未填 → 第一件事是访谈用户为什么学。
不懂 mission → 知识获取脱离现实目标、练习太抽象、无法判断用户下一步该学什么。
用户应始终感到被"刚好够"地挑战。教学范围要极紧,直连 mission。
用户可能指定要学的确切内容。没指定时,推算 ZPD:
learning-records/用户说"这个我已经会了" → 记入 learning-records/。
知识和技能通常打 1-2 连击:先教知识,再用练习巩固技能。
知识先从可信资源收集,再通过 HTML explainer 教给用户:
用户读完后答疑:直接回答,需要时修订 explainer(或另出一篇)。
确认用户理解某术语后 → 更新 glossary。
技能走交互练习,可用工具:
每个练习围绕反馈回路设计,反馈越即时越好。
wisdom 来自真实世界互动——在学习环境之外检验技能。
用户的问题看起来需要 wisdom 时:默认姿态是先尽力回答,但最终委托给社区。
社区 = 用户能在真实世界检验技能的地方(线上或线下):论坛、subreddit、线下课(预算允许)、本地兴趣小组。找高声誉社区;用户明确不想加入 → 尊重并记录在 RESOURCES.md。