Community程式設計與開發github.com

MiralonMa/interpret-course-subtitles

解讀任意學科課程的語音辨識字幕,在答疑、總結、教學或筆記任務中,結合課程資料、前後文與必要的公開檢索,辨認誤識別的專業術語、縮寫與符號。預設僅在閱讀時校驗,不產生完整校訂稿;每門新課程會詢問是否建立專屬專案術語表。

interpret-course-subtitles 是什麼?

此技能專為 AI 代理設計,用於精確解讀自動語音辨識(ASR)產生的課程字幕,顯著提升後續回答的品質。它適用於 TXT、SRT、VTT 等多種字幕格式,並支援理工、人文、社科等所有學科。技能的核心精神在於「以課程本身為中心」:它會優先辨識當前課程,並嘗試從專案目錄中尋找現有教材、講義與課件作為參考,避免使用外部通用詞典。對於影響理解的疑點,技能會基於語音學、上下文、學科知識與必要的公開檢索,提出少量具有區分度的候選修正方案,並根據證據強度為每個術語標註「已核對」、「高把握解讀」、「待核驗」或「無法辨認」的狀態。其獨特之處在於尊重原始字幕,不進行全域性取代;僅在使用者明確要求時才產生校訂副本。技能還支援每門新課程建立獨立的術語表,用於累積已驗證的術語,並透過嚴謹的證據分級與反饋機制,避免確認偏誤與過度自信的推論。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add MiralonMa/interpret-course-subtitles

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

課程字幕準確解讀

目標是讓後續回答建立在可靠的課程含義上。適用於理工、人文、社科等課程,不預裝特定學科的固定替換字典。預設直接完成使用者要求的答疑、總結或教學,在閱讀字幕時辨認術語;只有使用者要求校訂檔案時才產生副本。保留原檔案與定位資訊。

先識別課程與現有資料

  1. 閱讀專案約定及使用者已提供的上下文,在使用者指定專案中查詢字幕、課程目錄、教材、講義、課件、課程術語表和已有課程選擇。優先按檔案清單與目錄定位,不掃描無關磁碟。支援使用者僅提供字幕片段的情況,不強求專案或檔案。
  2. 區分同一課程的新課次與新的課程。同名但教師、課程層次或內容體系不同且會影響解讀時,再核實課程身分;不要僅因章次變化重複初始化課程。
  3. 每門新課程詢問是否在專案目錄建立獨立術語表。若使用者已經對該課程作出選擇,或明確提供該課程已有術語表,沿用選擇,不重複詢問。通用 skill 的安裝不等於使用者已同意為所有課程建表。可問: 「是否在專案目錄為《課程名》建立獨立術語表,用於複用已核驗的術語和記錄待核驗候選?」 肯定答覆後才建立,位置和結構見 術語表約定。拒絕或尚未答覆時,在當前分析中維護臨時映射,繼續可完成的閱讀工作;不把等待當作同意。未提供專案目錄時,在無關位置建立術語表。
  4. 先檢查,再決定是否詢問參考資料。已找到與該課程相關且可用的教材、講義或課件,就先使用,不再泛泛詢問是否添加。只有沒有可用參考資料時才問一次: 「專案中暫未找到這門課可用的教材、講義或課件,是否要新增參考資料,或先依據字幕上下文與公開資料繼續?」 與術語表問題合併詢問,避免多輪打斷。使用者已表示不新增的,在沒有新情況時不重複詢問。資料存在但打不開、損壞或全部不可辨認,應說明具體情況,再詢問可用版本;不能把它說成專案裡沒有資料。
  5. 等待答覆時可繼續識別主題、整理疑點和閱讀已有材料。使用者要求等待資料時,暫停依賴這些資料的結論。只在影響當前任務結果的疑點上進一步提問;不為每個錯字提問。

建立能夠回查的上下文

  • 保留檔案名稱、課次、原始時間戳或字幕序號;無時間戳用行號或段落號,不偽造時間。SRT/VTT 保留原 cue 標識,TXT 不擅自新增結束時間。
  • 先把握相關章節的主題與論證順序,再解讀疑點。短文通讀;長課分主題閱讀,塊間保留交疊,並維護課程主題、候選術語、來源和未決問題的簡短記錄。只讀到部分內容時明確覆蓋範圍,不能宣稱全文已校驗。
  • 從疑點前後完整論證段開始,必要時擴展到同章、更早的定義和後文的複習。鄰近幾句仍有歧義時才擴大範圍,不機械地對每句話反覆全文檢索。
  • 搜尋同一概念的重複出現、近音錯詞、中英混合片段、縮寫和符號。重複 ASR 錯誤是線索,不是多個獨立證據;別把先前的猜測當作後續核驗來源。
  • 跨句拼接只用於理解,不改動原始順序。區分老師陳述、學生回答、引文、反例、提問和隨後自我糾正。口語重複、噪音和自動插入的英文不能一律變成專業術語。

為疑點提出候選並核驗

對影響理解的疑點,保留原文並提出少量有區分度的候選。結合以下證據篩選,而非按讀音或搜尋熱度直接替換:

  • 讀音或字形能否解釋識別錯誤;中英文名稱、縮寫讀法是否對應。
  • 候選是否符合本段主題、語法和前後指代;課程是否確實引入該概念。
  • 後續定義、例題、公式、圖示或複習是否支援;能否解釋同一課程裡的其他出現位置。
  • 候選在當前學科、模型、時代或理論體系中是否成立;有哪些證據反對它。

證據用途要分清:

要回答的問題優先依據不能據此聲稱
課程使用何種定義、符號和約定使用者指定的課程來源順序;否則參考課程正式資料及清晰上下文外部常見定義必然適用於本課程
這個術語存在嗎、通常是什麼意思教材、大學課程資料、官方標準、原始論文等可靠來源老師在這一時刻一定說了這個詞
此處最合理的解讀是什麼多處上下文與課程資料的相互印證,且排除主要競爭候選已核對原始音訊或逐字恢復原話
老師確切說了什麼實際可聽的對應錄音、清晰可定位的課程原始材料或使用者確認僅憑學科常識就能確認原話

課程材料優先決定課程語境,不代表材料不會有筆誤。出現衝突時報告差異及依據,不暗中把課程改成其他教材體系。掃描 PDF、課件圖、公式和電路拓撲應檢視可辨認的原圖;OCR 僅提供線索,不能從糊圖補造關係。

需要時進行公開檢索

在術語生僻、候選仍衝突、準確事實不確定或使用者要求核驗時,檢索候選術語、英文名稱、學科和定義中的關鍵特徵。先提出候選再搜證據,避免只搜一個候選造成確認偏誤。

  • 優先課程官方資料、大學課程頁面、指定教材的合法公開內容、標準釋出機構、原始論文;按實際學科選來源。醫學、法律等還需區分年代和適用範圍。
  • 開啟並讀取支援判斷的正文,記錄標題、連結和相關章節/頁碼。摘要、搜尋片段、多個轉載和 AI 生成釋義不能充當獨立定論。
  • 只搜尋必要的概念,不傳送完整非公開字幕、課程登入資訊或個人資料。不為核驗自動上傳整份檔案到線上 OCR、ASR 或其他轉換服務。
  • 找不到可靠資料或無法聯網時,降低結論強度,說明證據缺口。若一輪擴充套件上下文和有針對性的來源核驗仍不能區分候選,保留歧義;只有找到新的有區分力的證據才繼續迴圈。

單獨檢查高影響內容

否定詞、比較方向、條件、數值、小數點、單位、正負號、上下標、大小寫、公式、專名和年代不能只按「常識上應該如此」修正。區別教師口誤、課堂反例、學生錯誤與 ASR 錯誤。若原文與理論衝突,標明衝突,分開解釋「字幕所述」和「通常理論」,不替教師重寫觀點。

術語可用下列狀態表達;這些是證據等級,不是測量過的機率:

  • 原話/課程用詞已核對:明確記錄實際聽取的位置、對應清晰材料或使用者確認。不要把教材含有該詞寫成已經聽清。
  • 高把握解讀:上下文和課程/專業資料相互印證,主要候選已排除。可以據此繼續回答,但不包裝為逐字引文。
  • 待核驗:仍有影響含義的候選衝突;給出候選、區分理由和缺失證據,結論採取條件式。
  • 無法辨認:資訊不足,不補造句;指出原位置。

局部術語可靠並不意味著整句、整條公式可靠。用新證據回查先前的解讀及受影響結論;遇到反證要降級、撤回或改判。沒有新增證據的反覆閱讀不能使信心度升級。不承諾「95% 識別準確率」。

預設輸出與按需交付

預設輸出使用者所需的回答。高把握、低風險的識別修正可自然用於解釋;對首次出現且影響含義的明顯錯詞,簡短說明「此處按……理解」,附時間戳或行號。只展開與本次結論有關的關鍵修正、來源和未決疑點,不強制輸出逐條糾錯日誌或整份新字幕。

對待核驗內容,給出最有區分力的候選及影響;不把不確定前提寫入確定結論。公開來源在相應判斷旁給出直接連結,本地資料註明檔案和可核對位置。教師原話、推定解讀、外部知識和 agent 補充解釋應能區分。

若使用者同意維護術語表,僅記錄可回查的課程證據與有價值的疑點,按 術語表約定 更新。不將單門課的資料寫入 skill 本體、全域字典或全域記憶。

只有明確要求時,才匯出校訂副本、修改對照或校訂報告。保留原字幕與時間/序號,按原格式產生新檔案;不覆蓋原文、不進行全域近音詞替換,不在「逐字校訂」中刪口語、重排論證或加入教材內容。要求「通順講義」時單獨標明屬於整理文字。

額外手段與完成檢查

最值得補充的依據通常是清晰原課件、指定教材術語索引、同課後續解釋,以及關鍵位置的短錄音複聽。已獲授權且工具可用時,可以區域性複聽或用課程術語提示二次 ASR;第二份識別結果仍只是線索。不預設啟動批量轉寫、收費服務、軟體下載或整課上傳,也不強求使用者提供音影片。

交付前檢查:是否遺漏候選反證、否定和條件,是否把模型推測變成引文,是否保留疑點定位,是否讓全文一致性檢查變成無條件替換,是否無意建立了未獲同意的術語表。複雜歧義的示例見 判斷示例,僅在需要時讀取。

相關技能