技能：Codex Academic Notes Engine 🎓
此技能讓 AI 代理能夠處理學術課堂錄影（影片或音訊），分析視覺與語音素材，並為 Obsidian 生成高效能的結構化大學筆記。
何時使用此技能
當使用者要求你處理課堂錄影（例如：「請處理用 OBS 錄製的作業系統課程，並生成筆記」）。 當你想要從包含投影片的影片或音訊檔案中綜合整理或結構化筆記。 當你想要驗證並將整潔的筆記直接匯出到使用者的 Obsidian 保管庫。
代理工作流程（逐步說明）
步驟 1：使用 Codex 準備會話套件
執行 Codex CLI 來檢查媒體、提取最佳化的音軌（16kHz 單聲道）並偵測投影片變換：
codex prepare "<影片或音訊路徑>" --subject <科目名稱或代碼> [--date YYYY-MM-DD]
Codex 生成的結果：
在 .codex_bundles/<工作階段ID>/ 中建立一個工作套件，包含：
manifest.json：技術元資料、時長、科目及附時間戳記的投影片清單。agent_context.md：整合的指示及課程範本。audio/lecture.opus：最佳化的音軌，供聆聽與轉錄。slides/slide_HHMMSS.png：對應每個投影片變換的去重複螢幕截圖。
步驟 2：檢查素材
- 讀取套件資料夾中的
manifest.json和agent_context.md，了解科目元資料及已擷取的投影片清單。 - 檢視
slides/中的圖片（分析圖表、螢幕上的程式碼、公式及投影片標題）。 - 分析音軌或其中的語音內容，以轉錄和綜合教師的講解。
步驟 3：綜合 Obsidian 筆記
嚴格遵循以下學術規範，以 Markdown 撰寫內容：
- YAML 前置資料：
---
materia: "<科目名稱>"
codigo: "<科目代碼>"
fecha: YYYY-MM-DD
docente: "<教師姓名>"
estado: 已處理
tags: [<科目標籤>]
---
-
主要標題：
# <科目名稱>：<課程核心主題> -
📌 任務、待辦事項與行政公告：
提取考試公告、作業、截止日期及特殊條件：
- [ ] [HH:MM:SS] 作業描述（截止日期：...）
- 🧠 核心概念與考試提示：
使用 Obsidian 原生 callouts：
> [!tip] 關鍵概念：[概念]定義與理論重要性。> [!warning] 考試提示：[強調的重點]當教師指出關鍵面向或常見錯誤時。> [!example] 實作示範範例、示範或案例。
- 📝 課程按時間順序與概念發展：
按時間戳記組織的區塊：
### [HH:MM:SS] [處理的子主題]
- 強制性視覺連結： 在教師引入或解釋已擷取投影片的準確分鐘處，使用 Obsidian 語法插入圖片：
![[slide_HHMMSS.png]]。 - 描述投影片上可見的圖表或程式碼，並與口頭講解相對應。
- 使用 LaTeX (KaTeX) 撰寫數學公式：行內
$公式$或區塊$$公式$$。 - 使用對應的程式碼區塊（
python、c、sql等）突顯程式碼片段。
- 📜 按區間索引的逐字稿：
每 2-3 分鐘的逐字引用或忠實摘要：
> [HH:MM:SS] 轉錄的文字或相關引用...
步驟 4：匯出至 Obsidian
將生成的草稿儲存至 <bundle_dir>/notes.md，然後執行：
codex export "<bundle_dir>" "<bundle_dir>/notes.md"
Codex 將：
- 驗證文件。
- 自動將所有投影片圖片複製到 Obsidian 的附件資料夾 (
attachments/Codex/)。 - 將筆記放置在保管庫中對應科目的資料夾 (
Clases/<科目名稱>/YYYY-MM-DD - <主題>.md)。 - 將
manifest.json中的狀態更新為exported。
步驟 5：向使用者確認
通知完成，指出在 Obsidian 中生成的筆記路徑、所涵蓋主題的簡短摘要以及已偵測到的任務。