Course Note for Codex

中文 | English

中文说明

course-note 是一个 Codex skill：将课程、讲座或教程的逐字稿整理为一对可追溯的中英文 Markdown 学习笔记。两份笔记共用同一证据地图，因此章节、时间戳、代码、公式、数字、待核对项及课程行政提醒保持一致。

适用范围

• 输入：用户提供的 .txt 或 .md 逐字稿。
• 输出：一份中文说明笔记和一份自然学术英文笔记。
• 证据边界：只使用逐字稿和用户明确提供的课程材料；不会静默联网补充或修正课程事实。

不适用于普通会议纪要、一般性摘要或仅有音视频的请求。音视频需要先转写；本技能不会上传音视频。

Tip

**音频转逐字稿建议：**可先在 Google AI Studio 中处理音频并生成逐字稿，推荐模型 gemini-3.6-flash。将得到的 .txt 或 .md 逐字稿交给 course-note 前，请人工核对专有名词、数字和时间戳。

安装

要求：Codex，Python 3.9 或更高版本。随附工具仅使用 Python 标准库。

克隆仓库后，将仓库内的 course-note/ 目录复制到 Codex 的用户技能目录：

git clone https://github.com/y10reo/course-note.git
Copy-Item .\course-note\course-note "$env:USERPROFILE\.codex\skills\course-note" -Recurse

若目标目录已存在，请先备份或确认要更新的版本，不要直接覆盖未检查的本地修改。

使用

提供逐字稿，并请求 Codex 使用 $course-note 生成配对笔记。例如：

Use $course-note to turn this transcript into paired Chinese and English study notes with source timestamps.

两个独立工具也可以在命令行运行：

python course-note/scripts/transcript_inventory.py lecture.md --format json
python course-note/scripts/validate_bilingual_notes.py --transcript lecture.md --zh lecture.zh-CN.md --en lecture.en.md

隐私与时效信息

不要把未获授权的课程录音、逐字稿或个人信息提交到工具或仓库。涉及测验、作业、教室、补课、答疑或截止日期时，笔记会标注其为录制当时信息；请始终以 LMS/Moodle 的最新公告为准。

English

course-note is a Codex skill that turns a course, lecture, tutorial, or class transcript into paired, source-grounded Chinese and English Markdown study notes. Both notes are derived from one evidence map, keeping their sections, timestamps, code, formulas, numbers, uncertainties, and administrative warnings aligned.

Scope

• Input: a user-provided .txt or .md transcript.
• Output: one Chinese explanatory note and one natural academic-English note.
• Evidence boundary: use only the transcript and course materials explicitly supplied by the user; do not silently browse, correct, or add course facts.

It is not for ordinary meeting notes, general summaries, or audio/video-only requests. Audio or video must be transcribed first; this skill does not upload media.

Tip

Audio-to-transcript recommendation: Process audio in Google AI Studio before using this skill; the recommended model is gemini-3.6-flash. Before passing the resulting .txt or .md transcript to course-note, manually check proper nouns, numbers, and timestamps.

Install

Requirements: Codex and Python 3.9+. The bundled utilities use only the Python standard library.

Clone this repository, then copy the repository's course-note/ directory into the Codex user skill directory:

git clone https://github.com/y10reo/course-note.git
Copy-Item .\course-note\course-note "$env:USERPROFILE\.codex\skills\course-note" -Recurse

If the destination already exists, back it up or confirm the intended update first; do not overwrite unreviewed local changes.

Use

Provide a transcript and ask Codex to invoke $course-note, for example:

Use $course-note to turn this transcript into paired Chinese and English study notes with source timestamps.

The included command-line tools can also be run directly:

python course-note/scripts/transcript_inventory.py lecture.md --format json
python course-note/scripts/validate_bilingual_notes.py --transcript lecture.md --zh lecture.zh-CN.md --en lecture.en.md

Privacy and time-sensitive information

Do not submit unauthorized course recordings, transcripts, or personal information to the tool or this repository. When a transcript mentions assessments, rooms, replacement classes, consultation hours, or deadlines, the notes label them as information recorded at lecture time; always check the latest LMS/Moodle announcement.

Repository layout

course-note/       # Installable Codex skill
tests/             # Synthetic, non-course test data only
README.md
LICENSE

License

MIT. See LICENSE.