用途
该技能适用于用户希望在 Obsidian 中建立和长期维护一学期课程笔记的场景。它围绕课程笔记库的构建与维护，覆盖课程概览、课时笔记、概念页、图谱枢纽、回放同步跟踪器等结构，并针对 BUAA 课程回放提供同步与语义重建流程。
主要能力
技能将工作分为脚本侧与智能体侧两部分：
- 脚本负责笔记库结构、回放同步、回放诊断、缓存刷新、跟踪器维护和文件写入。
- 智能体负责课程对齐、概念确认、术语纠正、图谱解读和最终笔记正文撰写。
核心命令包括：
初始化笔记库：
python scripts\init_obsidian_course_vault.py --obsidian-dir "<obsidian-install-dir>" --vault-dir "<vault-dir>"
添加课程：
python scripts\add_course.py --vault-dir "<vault-dir>" --course-name "<course-name>"
维护课程或同步 BUAA 回放状态：
python scripts\maintain_obsidian_course.py --vault-dir "<vault-dir>" --course-name "<course-name>" --course-page-url "<coursedetail-url>" --replay-output-dir "<replay-output-dir>"
构建或重建单条回放笔记：
python scripts\maintain_obsidian_course.py --vault-dir "<vault-dir>" --course-name "<course-name>" --draft-replay-sub-ids "<sub-id>" --replay-note-mode "final-explained"
技能还包含回放诊断路由、语义重建模式（如 final-lite、final-explained）、笔记校验、评审包生成、批量工作流、课程事务维护以及最终笔记质量门禁等机制。
使用方式
技能假定命令从技能根目录运行，否则需使用 scripts/ 的绝对路径。添加或维护 BUAA 课程时，需要先解析课程名作为课程身份；若标题已存在于笔记库中，则复用该课程文件夹。回放笔记构建前必须计算回放诊断，并归入 waiting_transcript、partial_transcript 或 transcript_only 之一。语义模式下脚本仅写入 semantic_rebuild_input.json 与 semantic_rebuild_prompt.md，智能体读取该包后才生成首个用户可见的课时笔记。笔记需通过 validate_final_note.py 校验，并生成评审包由独立评审通过后，才能计为正式课时页。
正式的 Obsidian 回放笔记 frontmatter 至少需包含：
type: lesson
course
title
date
replay_sub_id
source: buaa-replay-semantic-rebuild
replay_diagnosis
has_semantic_rebuild_packet: true
semantic_rebuild_completed: true
semantic_rebuild_status: completed
concepts
适用场景
适用于需要长期维护的课程笔记体系，尤其是 BUAA 课程回放的整理与同步；支持数学与统计、工程与计算机、人文社科、思政、语言写作、实验设计等不同课程领域的语义重建指引。也支持课程事务（作业、考试、课程安排、通知）的汇总维护。
限制
不得让种子笔记冒充完成的课程笔记；不得将仅装饰过的转写片段列表作为完成笔记；数学类课程若无法从转写中重建具体数学对象，应写为受评审约束的草稿而非正式课时页。仅当转写覆盖和基于转写的摘要覆盖均通过时，才允许正式课时页。若笔记在任一评审门禁后发生变化，两项门禁结果均失效并需重跑。不得从等待转写、部分转写、质量被拒或仍待语义重建的笔记中汇总事务。评审包目录必须在 Obsidian 笔记库之外。
部分实现细节与具体效果在提供的资料中暂未完整给出。