Communitygithub.com

Firepanda415/research-and-scientific-lib-skills

規劃、腳本、動畫與審查研究論文、程式碼倉庫或科學方法的解說影片,含旁白與內嵌字幕。適用於論文解說影片、動畫摘要、程式生成動畫(如 Manim)以及這類影片的修訂。單一靜態圖表請使用 figure-designer。

research-and-scientific-lib-skills 是什麼?

這個技能旨在幫助開發者或研究人員建立高品質的科研解說影片,從原始論文或程式碼庫中提取關鍵資訊,並將其轉化為結構化的敘述腳本、動畫與最終影片。它支援完整的生產管線,包括腳本撰寫、動畫生成、語音合成、字幕嵌入,以及嚴格的交付前檢查。使用者可以指定現有的動畫管線與風格模組,以確保與專案既有風格一致。若無現有管線,則會依照參考文件中的生產管線架構建立新管線。該技能還包含數據追溯與驗證機制,要求所有數字、方程式與繪圖都必須回溯至原始來源,並強制執行旁白與字幕的同步與風格一致性。交付前需要進行多項檢查,例如幀畫面檢視、字幕與旁白對齊、數字與聲明地圖比對,以及響應式頁面測試。最終交付影片時,技能會提供摘要、數據來源與需要使用者手動檢查的項目,並在需要時間戳記評論時進行全域缺陷搜尋與修正。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Firepanda415/research-and-scientific-lib-skills/tree/HEAD/plugins/research-skills/skills/research-explainer-animation

在你喜歡的 AI 中提問

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

說明文件

科研解說動畫

製作一段簡短的有旁白影片,向一位尚未閱讀該研究但具備科學素養的觀眾解釋一項研究工作。將影片視為關於該工作的出版物。每個聲明、數字、方程式與繪製曲線都必須可追溯至來源,且渲染後的影片必須在交付前檢查。

從來源準備

  1. 閱讀完整來源。對於論文,包含表格、圖說以及引用的數字背後的附錄。對於沒有論文的倉庫,閱讀其 README、文件、範例與測試,並僅解釋程式碼支援的行為。
  2. 在腳本前撰寫聲明地圖。涵蓋問題、困難之處、核心想法、相較於引用的先前工作有何新意、方法如何逐區塊運作、結果及其條件,以及已說明的限制。記錄每個數字背後的表格、章節或檔案,並將衍生數字(例如從兩個表格條目計算出的百分比)標記為衍生。
  3. 繪製真實數據。尋找作者的數據與程式碼,包括論文中命名的倉庫以及使用者的本機副本。在使用繪製的量之前,將其追溯至數據,並從該數據重新計算任何衍生值或擬合。將重新追蹤或計算的值與報告的值進行比較。僅在使用者批准後才重新執行昂貴的模擬或實驗。將示意性輸入標記為說明性質。
  4. 尋找目標專案的現有動畫管線與樣式模組,並重複使用它們,以便新影片與先前的影片匹配。如果沒有現有管線,則按照生產管線中的架構建立一個,並將其函式名稱視為建議。根據專案的指導,接收路徑、環境與建置命令,以及影片如何附加到頁面上的資訊。使用專案宣告的環境。當專案未宣告環境時,使用已安裝的工具以滿足管線需求,記錄其路徑與版本以及影片的來源,並告知使用者還需要安裝哪些東西,包括語音合成權重的首次使用下載。

編寫旁白腳本

  • 目標是製作傳達問題、想法、方法、證據與範圍的最短影片。完整的論文解說影片通常需要三分半到四分半鐘,約 450 到 600 個英文口語單字。動畫摘要或場地長度限制會設定較短的目標。
  • 遵循聲明地圖:問題、障礙、想法、機制、證據、比較與權衡,然後是總結。在方法基於先前工作時給予其引用,並以論文自身的術語陳述貢獻。將論文的保留條件與限制條件納入旁白。
  • 旁白與螢幕上的文字應為耐用的散文。在合成前套用 research-writing-style,包含其強制審查。
  • 將腳本分割成一到四個句子的段落。每個句子有字幕文字,並且在需要時附帶單獨的口語文字,以拼出縮寫、讀出符號或覆蓋發音。
  • 使用使用者為先前影片選擇的聲音。如果沒有記錄的選擇,則用幾個候選聲音合成一小段,將範例寫入音訊檔案,提供使用者這些檔案的路徑,並讓使用者選擇。將該選擇記錄在旁白設定或專案的筆記中,以便後續影片重複使用。

閱讀生產管線以了解合成、時間、渲染、字幕與編碼架構及其已知失效模式。閱讀房風格以了解預設的視覺與音訊風格。

動畫

  • 為每個句子提供一個視覺想法,並在該句子開始時啟動其動畫,使用從合成音訊測量出的時間。
  • 保持顏色角色、排版、章節標籤、標題卡、結束卡與字幕條在影片間一致。
  • 使用數學排版器排版方程式,並從數據繪製圖表。顯示單位、不確定性及其統計數據,以及正確的減號。
  • 建立一個獨立的海報靜態圖片,其中包含較大的元素,使其在縮圖寬度下仍可閱讀。

交付前檢查

這些檢查是必要的。有旁白的影片可能以成功渲染未揭露的方式悄悄失效。

  • 以接觸印相方式檢查整個渲染,例如每四到五秒一幀,並以全尺寸檢查密集幀。尋找裁剪或重疊的文字、覆蓋在軸上的標籤、不完整的公式(例如缺少分數線),以及在運動過程中與其代表的數據分離的物件。
  • 確認每個字幕行下方都有旁白,並且字幕開始時間與語音起點對齊。
  • 將螢幕上與旁白中的每個數字與聲明地圖進行比較。
  • 當影片嵌入網站時,建置該網站,執行其測試,並使用主機提供的瀏覽器工具檢查頁面與播放器在桌面與手機寬度下的顯示,例如在兩種寬度下進行無頭螢幕截圖。如果沒有此類工具,請要求使用者檢查這些寬度。
  • 除非主機允許代理監聽音訊,否則要求使用者聽取發音與節奏,並指出最可能有風險的單詞。

交付與修訂

交付完成的影片及其路徑與長度,總結其內容與數據來源,並列出使用者仍應透過耳朵或眼睛檢查的項目。對於帶有時間戳記的評論,定位影格,修復其原因而非單一影格,並搜尋影片的其餘部分以及使用相同管線建置的其他影片,以查找相同的缺陷。

相關技能