Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

TeachMe 技能

不只给定义,要给血肉。

将冰冷的计算机科学与网络安全专业知识,转化为有血有肉、可感知、可理解的教学内容。


简介

TeachMe 是一个面向支持 SKILL 机制的 Agent 的教学技能,专注于四大技术教学场景:

  1. 专业知识讲解 — 将抽象概念(协议、架构、安全机制等)转化为直觉+形式化的完整理解
  2. 算法与数据结构讲授 — 从问题出发,展示从朴素到优雅的演进路径
  3. 技术方案选型分析 — 多维度对比候选方案,给出有理有据的决策建议
  4. 关键技术决策点评 — 客观评审技术决策质量,提取可复用的决策原则

核心设计哲学:"有血有肉"教学七要素 — 每个知识点都覆盖动机→直觉→弯路→形式化→实例→误区→延伸。


目录结构

├── SKILL.md                              # 技能主文件:核心工作流与使用指南
├── @README.md                            # 本文件
└── references/                           # 场景特化参考文档
    ├── algorithm-teaching.md             # 算法讲解特化指南
    ├── architecture-review.md            # 技术方案选型分析框架 (STAR-R)
    ├── decision-analysis.md              # 决策点评维度 (DECIDE)
    ├── knowledge-explainer.md            # 专业知识讲解模板
    ├── socratic-questions.md             # 反向提问问题库(四大场景分类)
    └── teaching-structures.md            # 教学结构模板库(四种结构)

核心工作流:三阶段教学法

Stage 1 — 反向提问(对齐需求)

以"教学设计顾问"身份,先不直接生成内容,而是向用户提出 3-5 个关键问题

  • 通用必问:目标受众、核心目标、输出形式与时间约束
  • 场景特问:根据识别到的四大场景,从 references/socratic-questions.md 中选择 2-3 个针对性问题

场景识别规则

关键词 场景
算法、数据结构、怎么实现、时间复杂度 算法讲授
选型、对比、选哪个、方案优劣 方案选型
决策、评审、设计问题、建议 决策点评
概念、原理、机制、协议 专业知识讲解

Stage 2 — 内容生成(有血有肉的讲解)

根据对齐结果,动态选择教学结构并生成内容。

四种教学结构(来自 references/teaching-structures.md):

结构 适用场景
问题导向式 算法讲解、概念引入
认知负荷分层式 复杂系统、分布式协议
对比分析式 方案选型、算法选择
演进式 技术史、架构演进

"血肉"七要素(必须全部覆盖):

  1. 动机/历史背景 — 这个概念当初是为了解决什么问题?
  2. 直觉/大图景 — 最直观的理解方式是什么?
  3. 探索过程/弯路 — 从朴素尝试到最终方案的演进路径
  4. 形式化定义 — 在直觉建立后给出精确描述
  5. 实际应用/代码实例 — 结合仓库上下文中的真实代码
  6. 常见误区/陷阱 — 最容易掉进的坑及避坑方法
  7. 总结与延伸 — 核心 takeaway + 进一步学习方向

场景特化参考

  • 算法场景 → references/algorithm-teaching.md
  • 方案选型 → references/architecture-review.md
  • 决策点评 → references/decision-analysis.md
  • 专业知识 → references/knowledge-explainer.md

Stage 3 — 幻灯片提炼(多形态输出)

如需幻灯片,先生成完整 Markdown 文档,再提炼为幻灯片页大纲,并按优先级调用现有 skill:

  1. huashu-design(高保真 HTML 原型)
  2. ppt-master(AI 原生可编辑 PPTX)
  3. pptx(标准 PowerPoint)

触发条件

以下关键词或场景会自动激活 TeachMe 技能:

  • 讲解类:"讲解"、"讲授"、"教一下"、"怎么理解" + 专业概念/算法/技术
  • 选型类:"分析一下这个方案的优劣"、"技术选型"、"选 A 还是 B"
  • 决策类:"评审这个技术决策"、"这个设计有什么问题"、"决策建议"
  • 分享类:"帮我准备一次技术分享"、"写个技术博客"、"团队内部分享"
  • 通用:任何需要将抽象技术概念转化为可理解教学内容的场景

使用示例

示例 1:讲解算法

用户:给我讲一下 Dijkstra 算法

Stage 1(反向提问)

  • 目标受众是谁?(初学者 / 进阶开发者)
  • 是否需要手写实现,还是理解原理即可?
  • 有没有具体的性能约束场景需要覆盖?

Stage 2(内容生成)

  • 问题导向式结构
  • 从"水漫延"直觉 → 优先队列形式化 → 代码实例 → 负权边误区

示例 2:技术方案选型

用户:Kafka 和 RabbitMQ 应该怎么选?

Stage 1(反向提问)

  • 约束条件是什么?(吞吐量、延迟、一致性、运维复杂度)
  • 选型的 stakes 多高?(原型验证 / 核心系统 / 基础设施)
  • 团队现有技术栈熟悉度如何?

Stage 2(内容生成)

  • 对比分析式结构(STAR-R 框架)
  • 多维度对比矩阵 → 决策树 → 风险与建议

示例 3:决策点评

用户:评审一下我们之前用 Redis 做消息队列的决策

Stage 1(反向提问)

  • 当时的约束和信息条件是什么?
  • 决策的 stakes 和影响范围?
  • 希望得到复盘分析还是改进建议?

Stage 2(内容生成)

  • DECIDE 点评框架
  • 决策背景还原 → 预期 vs 实际 → 影响分析 → 改进建议 → 原则提取

输出质量检查清单

生成内容后自动自检:

  • 是否解释了"为什么需要这个"(动机)?
  • 是否提供了直觉性理解方式(类比/图像/大图景)?
  • 是否展示了从朴素到成熟的演进过程?
  • 形式化定义是否建立在直觉之上?
  • 是否有真实代码/数据支撑?
  • 是否列出了常见误区和避坑方法?
  • 语言是否适合目标受众的水平?
  • 篇幅是否符合时间/深度约束?

关联技能

技能 用途 仓库
huashu-design 高保真 HTML 幻灯片/交互演示 alchaincyf/huashu-design
ppt-master AI 生成原生可编辑 PPTX,支持任意文档输入 hugohe3/ppt-master
pptx 标准 PowerPoint 生成 anthropics 官方推荐技能

贡献与迭代

本技能遵循通用的 Agent Skill 规范,可适配任意支持 SKILL 机制的 Agent 平台。如需调整教学策略或添加新的场景特化指南,请修改 SKILL.mdreferences/ 下的对应文件,并确保核心工作流(三阶段教学法)与"血肉七要素"保持一致。

About

将冰冷的计算机科学与网络安全专业知识转化为"有血有肉"的教学内容。

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors