Communitygithub.com

教材升級

重新整理現有的教科書、講義和課程教材。可用於診斷章節、組織課程、編輯學生教材、設計活動或從教師的素材庫中準備可錄製的腳本。

教材升級 是什麼?

Textbook Upgrade 是一個專為教育者與內容創作者設計的 AI 代理技能,協助診斷、重構與升級現有的教學材料。此技能支援多種平台(包括 Claude Code、Cursor、Codex 等),並提供完整的教材開發流程:從簡報訪談以確定方向,到教材編輯、版面設計、活動設計、錄製腳本,以及最終的交付審查。它會自動識別材料中的問題點(如章節結構、學習瓶頸),並提出具體改善建議,同時尊重教師原有術語與案例。對於掃描版 PDF,它會評估 OCR 品質、進行人工校對,並在必要時請求更高品質的原始檔案。此技能的獨特之處在於,它不僅處理文字編輯,還涵蓋版面布局、視覺設計及錄影腳本的產出,並提供版本控管與核准機制,確保每項修改都有跡可循。總體而言,它是一個全方位的課程設計助手,適合用於大規模教材翻新或單元調整。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/j-c-fstk-dev/TextbookUpgradeSkill/tree/main/skills/textbook-upgrade

在你喜歡的 AI 中提問

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

說明文件

教材升級 是做什麼的?

識別目標受眾、要求的交付項目以及可用的材料。採用課程的語言。僅執行必要的步驟。如果要求是編輯一個章節或為已確定的課程撰寫腳本,就從那部分開始。當受眾不明確時,明確說明假設,並在可逆的決策上繼續推進。

對於像「改善這份材料」這類廣泛的要求,假設從頭到尾的產出。從訪談與方向選擇開始。使用附檔中已有的回覆。當有歧義時確認成品為何:講義、腳本或兩者兼具。未來錄製課程的意圖可提供背景資訊。當被要求時,才產生腳本。對於單點要求,將訪談範圍限制在會影響該交付項目的決策上。

對於講義,在進行版面設計之前,先套用視覺方向與圖片指南。當有腳本要求時,套用錄製指南。在交付任何成品之前,務必執行審查與回饋。將簡報與決策保存在專案的私人資料夾中,以便後續接續使用。

當 PDF 由圖片組成時

在私人副本中進行作業。測試每頁的文字提取功能,並目視檢查代表性的頁面,包括一個密集頁面和另一個包含圖片或圖說的頁面。對於掃描頁面,若該語言可用,則使用 OCR,否則對可讀部分進行視覺轉錄。DOCX、PPTX 或原始專案檔案可以節省工作量,但非必要。如果缺少閱讀工具,請識別具體的障礙,並要求提供該必要頁面的可讀截圖。

當收到保留內容的格式化要求時,維持原文、順序、表格、圖說以及圖文之間的關係。帶有 OCR 層的 PDF 仍需要進行版面設計才能改變佈局。重建可編輯的區塊,並將結果與原始圖片進行比較,包含數字、技術名詞、重音符號以及閱讀順序。將不確定的段落記錄下來,附上來源頁碼以供確認。以最終尺寸評估每張圖片。只有在解析度影響必要細節時,才要求提供更好的圖片。對於影片課程,分別評估文字對腳本的用處以及圖片對顯示的品質。

使用樣本來估算恢復情況,並為初步訪談提供依據。對於大量材料的版面設計,在複製佈局之前,按照以下流程交付一份樣稿。根據批准的範圍繼續進行,記錄哪些頁面已恢復、已校對或仍需要更好的原始檔案。

診斷

將每個發現關聯到頁面、章節、圖片或錄製分鐘數。對於每個影響學習的問題,解釋學生在哪裡卡住,並提出具體的修改建議。區分編輯修正與技術疑問。保留教師自己的術語、範例和敘述。當來源之間有衝突時,記錄兩者,並提出能解決衝突的問題。

組織課程

定義學生在課程結束時應能達成的目標。按照完成下一項任務所需的知識來排序課程。如果一節課有兩個獨立的目標,考慮將其拆分。對於每一課,記錄可觀察的目標、先備知識、來源、教師範例、練習以及學習證據。當交付項目超過一個或用戶要求規劃時,使用課程表。

編輯講義

以學生能識別的問題作為章節開頭。按照使用順序呈現概念。在要求學生獨立應用之前,先展示一個範例。明確說明圖像所能觀察到的內容,並在存在圖像時撰寫可理解的圖說與描述。使用列表來表示動作順序,使用表格來進行實際比較。對於局部調整,保留其他章節不變。

測試版面設計

選擇能涵蓋材料中不同決策的頁面(例如,密集的解釋、表格和圖解序列)。接受用戶的選擇,用一句話說明樣本的理由,並閱讀相鄰頁面以恢復參考資料和後續內容。對於僅限於某個段落的請求,以約定的格式交付該段落本身。

導出一個版本化的樣稿,開啟檔案並逐頁瀏覽。對於手機,從 PDF 中按約定的閱讀寬度生成每頁一張的圖片。如果寬度未指定,選擇一個具有代表性的並告知用戶。在不放大的情況下檢查每張圖片。確認學生能否跟隨表格中的一行到其來源、閱讀圖說、區分細節以及識別替代方案的開頭。如果空間不足,重新分配內容。修正後再次檢查匯出結果。

交付樣稿、預覽圖以及實際的待辦事項。將樣稿頁面對應到原始頁面,保留之前的版本,並告知如何回覆:「通過,請套用到其餘部分」或「請修改第 X 頁」。等待視覺批准後再將版面設計擴展到其他部分。跟進技術疑問,直到由負責人驗證後再發佈。

建立活動

選擇一個能產生目標證據的任務。如果目標是觀察,提供可供檢視的內容;如果目標是決策,提供足夠的背景資訊以供證明選擇。交付題目、預期答案、驗收標準以及關於一個常見錯誤的評論。當答案依賴於缺失的資訊時,向教師發出提示。

撰寫錄製腳本

確定哪些內容需要演示以及有哪些可用資源。根據指示的課程表或章節進行。使用腳本模板。撰寫自然的台詞,將每個解釋與可見的細節同步,並包含讓學生觀察或回應的機會。識別可以一起錄製的鏡頭。指出缺少的資源,並在可能的情況下提出可行的替代方案。

檢查交付項目

確認每個宣布的目標都出現在活動中,並且學生擁有解決問題所需的資訊。根據可用來源核對數字、術語和條件。將給作者的疑問與給學生的文字分開。在審查一個具有多個輸出的課程時,追蹤講義、腳本和答案中每個事實性的更改。如果有匯出檔案,檢查最終檔案中的圖片裁切、圖說閱讀和標題順序。僅交付要求的格式。

相關技能