buaa-course-skills

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

buaa-course-skills

★ 48 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# BUAA Course Skills

把 BUAA 课堂回放、课程转写和课次元信息，整理成**可检索、可回看、可复用**的课程学习资料。  
它既可以生成单次课程纪要，也可以继续沉淀到 Obsidian，形成长期维护的课程知识库。
如果你属于下面这类人，这个仓库大概率会有用：

- 想系统复盘一门课，而不是只看单节回放
- 上课跟得不稳定，但又不想完全掉队
- 教室里听不进去，回放里也不太听得进去，但又不想彻底放掉这门课
- 想快速知道老师这节课讲了什么、强调了什么、布置了什么
- 希望把一门课长期整理成自己的知识库
- 已经在用 Obsidian，想把课程笔记、概念页和图谱结构一起长出来

这套 skill 想做的不是“替你听课”，而是把课堂内容整理成一种更容易进入的学习资料。很多用户并不缺课堂回放，而是缺一个比“再听一遍课”更容易吸收的入口。这个仓库的目标，就是先让你通过整理好的文档知道这节课讲了什么、强调了什么、课上发生了什么，再决定要不要回去看完整回放。

## 这个仓库解决什么问题

课堂回放通常能播放，但不容易真正用于复习：

- 过几周后，很难快速回忆某一节课到底讲了什么
- 想回看某个知识点时，不知道应该从哪一段开始
- 老师提到的作业、考试、练习和提醒，分散在整节课里
- 一学期结束后，留下的往往是一堆零散转写，而不是结构化课程资料

这个仓库的目标，是把“能播放的课堂回放”变成“可以长期复用的学习资料”。

## 仓库包含两个 skill

### `buaa-classroom-summarizer`

从 BUAA `livingroom` 或 `coursedetail` 页面提取结构化回放原料，并生成单次课程纪要。

适合你想要：

- 枚举可回放课次
- 提取课程转写和元信息
- 导出独立 Markdown 纪要
- 快速知道这节课讲了什么、强调了什么、布置了什么

### `obsidian-course-vault`

把课程原料和课次纪要整理进 Obsidian，维护课程总览、课次页、概念页和图谱 hub。

适合你想要：

- 持续维护一门课的知识库
- 把单节课笔记逐渐长成课程体系
- 在 Obsidian 中建立概念页、图谱入口和课程总览

## 典型工作流

1. 从 BUAA 课堂页面提取回放、转写和课次元信息  
2. 生成单次课程纪要或语义重建 packet  
3. 将结果同步到 Obsidian  
4. 持续维护课次页、概念页、图谱 hub 和课程总览

两个 skill 可以单独使用，也可以串联使用。

## 你最终会得到什么

使用 `buaa-classroom-summarizer` 时，典型输出包括：

- 一份按课次组织的 Markdown 纪要
- 本节主线总结
- 带时间戳的内容时间轴
- 关键概念整理
- 课程事务 / 作业 / 待核对信息
- 面向复习的回看建议

如果再配合 `obsidian-course-vault`，还可以继续维护：

- 课程总览页
- 单次课次页
- 概念页
- 课程图谱 hub
- 回放同步页

## 正式支持的输入入口

当前正式支持：

- `classroom.msa.buaa.edu.cn/livingroom`
- `classroom.msa.buaa.edu.cn/coursedetail`

## 快速开始

第一次使用，建议先安装 `buaa-classroom-summarizer`。  
只有当你希望长期维护 Obsidian 课程库时，再加装 `obsidian-course-vault`。

安装 `buaa-classroom-summarizer`：

```bash
npx skills add https://github.com/1xiaoooo/buaa-course-skills --skill buaa-classroom-summarizer --yes --global
```

安装 `obsidian-course-vault`：

```bash
npx skills add https://github.com/1xiaoooo/buaa-course-skills --skill obsidian-course-vault --yes --global
```

如果只想安装到当前项目，可以去掉 `--global`：

```bash
npx skills add https://github.com/1xiaoooo/buaa-course-skills --skill buaa-classroom-summarizer --yes
npx skills add https://github.com/1xiaoooo/buaa-course-skills --skill obsidian-course-vault --yes
```

安装完成后，请分别补充依赖，并阅读各自的 `SKILL.md`。详细说明见 [INSTALL.md](INSTALL.md)。

注意：

- `npx skills add ...` 安装的是 skill 副本，不是直接在这个仓库目录里运行
- 安装完成后，需要到“安装后的 skill 目录”里补 `requirements.txt`
- 如果你用的是 Codex，全局安装后通常在 `%USERPROFILE%\\.codex\\skills\\...`

## 推荐用法

### 方案 A：只做回放抽取

使用 `skills/buaa-classroom-summarizer`

适合你想要：

- 枚举可回放课次
- 导出课程转写和元信息
- 生成独立 Markdown 课次纪要或语义重建 packet
- 先把一门课安全地做成“可继续整理的原料和单节输出”

### 方案 B：做完整课程知识库

两个 skill 一起用。

适合你想要：

- 持续维护的 Obsidian 课程库
- 能点开的概念页
- 可读的图谱 hub 和课程总览
- 一学期持续同步和整理回放

## 适合的使用场景

- 想系统复盘一门课，而不是只看单节回放
- 想快速了解某节课课堂上发生了什么
- 想把课程资料逐渐沉淀为自己的知识体系
- 已经在使用 Obsidian，希望把课程资料结构化维护起来

## 当前不太适合的场景

- 希望完全零介入、一键得到完美课堂笔记
- 希望在任何课程、任何平台上直接无适配使用
- 希望在转写质量较差的情况下仍然稳定得到高质量结果

## 当前状态

当前仓库处于 `public beta` 阶段，已经比较稳的部分包括：

- BUAA 课堂回放抽取
- 转写优先的结构化诊断
- 独立 Markdown 纪要导出
- Obsidian 课程库、课次页、概念页与图谱入口维护
- 整门课先枚举、分流、排队，再逐节进入正式重建

仍需持续验证和打磨的部分包括：

- 更多的跨平台实机验证
- 非 Windows 环境下的认证与运行细节
- 最终纪要质量仍会受到课程转写质量和课程结构影响

## 首次使用建议

第一次使用时，建议不要一上来就整学期全量落库。

更稳的顺序是：

1. 先安装 `buaa-classroom-summarizer`
2. 先拿一节课或一门课的 `coursedetail` 跑通抽取
3. 确认登录态、输出目录、转写状态都正常
4. 再接 `obsidian-course-vault`

## 仓库结构

```text
skills/
  buaa-classroom-summarizer/
  obsidian-course-vault/
INSTALL.md
RELEASE_CHECKLIST.md
```

## 发布说明

- License: `MIT`
- 当前推荐以 `public beta` 的预期使用，而不是视为完全无监督的稳定产品
- 用户可以通过上面的 `npx skills add ...` 命令直接安装

buaa-course-skills

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README