Skip to content
Back to search

handout-remake

把上課教材變成 iPad 上好讀、可手寫的深色講義|Agent Skill for Claude & Codex

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/xamjiang--handout-remake/badge.svg)](/listings/xamjiang--handout-remake)

HTML

<a href="/listings/xamjiang--handout-remake"><img src="/api/listings/xamjiang--handout-remake/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**點選你使用的平台**,直接跳到對應的教學:

<table> <tr> <td align="center" width="20%"><a href="#install-claude"><img src="docs/images/logos/claude.svg" width="40" alt=""><br><b>Claude</b></a><br>Cowork・Claude.ai</td> <td align="center" width="20%"><a href="#install-gemini"><img src="docs/images/logos/gemini.svg" width="40" alt=""><br><b>Gemini</b></a><br>Gemini Spark</td> <td align="center" width="20%"><a href="#install-chatgpt"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/logos/openai-dark.svg"><img src="docs/images/logos/openai-light.svg" width="40" alt=""></picture><br><b>ChatGPT</b></a><br>ChatGPT Work</td> <td align="center" width="20%"><a href="#install-claude-code"><img src="docs/images/logos/claude-code.svg" width="40" alt=""><br><b>Claude Code</b></a><br>終端機</td> <td align="center" width="20%"><a href="#install-codex"><img src="docs/images/logos/codex.svg" width="40" alt=""><br><b>Codex</b></a><br>終端機</td> </tr> </table>

Claude、Gemini 與 ChatGPT 需要從 [Releases](../../releases) 頁面下載封包,請下載對應的那一個:

| 檔案 | 適用平台 | | --------------------------- | --------------------------------- | | `handout-remake.zip` | Claude Cowork、Claude.ai、ChatGPT | | `handout-remake-gemini.zip` | Google Gemini(含 Gemini Spark) |

<a id="install-claude"></a>

<img src="docs/images/logos/claude.svg" width="24" alt=""> Claude Cowork 與 Claude.ai

1. 到 [Releases](../../releases) 頁面下載最新的 `handout-remake.zip`。 2. 開啟 Claude 的**設定**,在 **Capabilities** 裡確認**程式碼執行**(Code execution)已開啟。 3. 在 **Skills** 區塊選擇 **Upload skill**,上傳剛剛下載的 zip 檔。 4. 確認清單中出現 `handout-remake`,並且是開啟狀態。

> [!NOTE] > Cowork 需要付費方案。設定頁面的名稱可能隨 Claude 更新而調整,以官方說明為準。

📖 官方說明:[Use Skills in Claude](https://support.claude.com/en/articles/12512180)、[Getting started with Cowork](https://support.claude.com/en/articles/13345190)

<a id="install-gemini"></a>

<img src="docs/images/logos/gemini.svg" width="24" alt=""> Google Gemini Spark

Gemini 的 skill 統一在 Gemini 網頁版的設定裡管理,裝好之後,一般對話與 Gemini Spark 都能使用。

**開始之前**,請確認你符合 Gemini Spark 的使用條件:

- 訂閱 **Google AI Pro 或 Ultra**。 - 用**個人 Google 帳號**登入。 - 年滿 **18 歲**,並且開啟了「**保留活動記錄**」(Keep Activity)。

**安裝 skill**

1. 到 [Releases](../../releases) 頁面下載最新的 **`handout-remake-gemini.zip`**。 2. 用電腦瀏覽器開啟 [gemini.google.com](https://gemini.google.com)(或 Mac 版 Gemini App),進入**設定 → 技能**(Skills)。 3. 選擇上傳檔案,上傳剛剛下載的 zip 檔。 4. 確認清單中出現 `handout-remake`,並且是啟用狀態。

> [!IMPORTANT] > 請上傳 **`handout-remake-gemini.zip`**,不要用 Claude 版的 `handout-remake.zip`。Gemini 規定 `SKILL.md` 必須放在 zip 的最外層,也不接受 `.css`、`.html`、`.mjs` 這類副檔名,Claude 版的封包會上傳失敗。Gemini 版已經把這些檔案改成 `.txt`,AI 使用時會自動改回來。

**在 Gemini Spark 中使用**

1. 在 Gemini Spark 開一個新任務,上傳你的投影片或 PDF。 2. 在輸入框輸入 `/`,從清單中選擇 `handout-remake`。 3. 接著說明你要什麼,例如「幫我把第 2 章 p.37–46 做成講義」(也可以什麼都不說)。

> [!WARNING] > 根據 Google 的官方說明,skill 裡的腳本不能連上網路,所以 Gemini Spark 可能無法安裝建置 PDF 所需的套件。目前實測的結果是**講義內容可以產出**,但不一定能得到排好版的 PDF。這時可以請 Gemini 把排好的 HTML 檔交給你,再參考〈[在自己的電腦上建置 PDF](#在自己的電腦上建置-pdf)〉轉成 PDF。

📖 官方說明:[建立及管理技能](https://support.google.com/gemini/answer/17094296)、[使用 Gemini Spark](https://support.google.com/gemini/answer/17094507)

<a id="install-claude-code"></a>

<img src="docs/images/logos/claude-code.svg" width="24" alt=""> Claude Code

把 skill 資料夾複製到個人的 skills 目錄:

git clone https://github.com/xamjiang/handout-remake.git
cp -R handout-remake/skills/handout-remake ~/.claude/skills/

只想在某個專案裡使用的話,改為複製到該專案的 `.claude/skills/`。

📖 官方說明:[Skills – Claude Code Docs](https://code.claude.com/docs/en/skills)

<a id="install-codex"></a>

<img src="docs/images/logos/codex.svg" width="24" alt=""> Codex

複製到 Codex 的 skills 目錄:

git clone https://github.com/xamjiang/handout-remake.git
cp -R handout-remake/skills/handout-remake ~/.codex/skills/

只想在某個專案裡使用的話,改為複製到該專案的 `.agents/skills/`。

📖 官方說明:[Agent Skills – Codex](https://developers.openai.com/codex/skills)

<a id="install-chatgpt"></a>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 437 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="docs/images/hero.webp" alt="四頁講義範例:節首頁、概念頁、例題頁、練習頁" width="100%">
  3. </p>
  4. # 深色講義
  5. 把上課的投影片、PDF 或筆記交給 AI,製作適合在平板裝置長時間閱讀、理解的教學講義。
  6. > **English** — An Agent Skill that turns lecture slides into dark-mode, pen-ready study handouts for the 11-inch iPad. It re-teaches each topic from scratch with diagrams, worked examples and practice pages, then builds a fully vector PDF. Output language: Traditional Chinese (Taiwan).
  7. ---
  8. ## 概覽
  9. 老師的投影片重點很密、步驟常常省略、公式和圖只存在圖片裡。這個 skill 讓 AI 先讀懂教材,再**依照初學者需要的順序重新教一次**,最後排成固定格式的講義。
  10. <p align="center">
  11. <img src="docs/images/workflow.webp" alt="流程:丟入教材 → AI 重新教一次 → 排版與自動檢查 → 在 iPad 上讀寫" width="100%">
  12. </p>
  13. 每一份講義都有這些特點:
  14. - **從零講起**:每個概念依「生活情境 → 白話定義 → 圖解 → 公式 → 例題」的順序展開,術語附英文對照,方便對照課本與考卷。
  15. - **為 iPad 設計**:頁面尺寸就是 11 吋 iPad 直向的螢幕大小,不用縮放;深色底色適合長時間閱讀。
  16. - **可以直接作答**:練習題附點陣書寫區,解答固定在下一頁,寫完翻頁就能對答案。
  17. - **品質有把關**:建置時自動檢查每頁有沒有內容超出版面;例題與解答的數字會用程式重算一次。
  18. - **全向量 PDF**:文字、公式、圖解都是向量,放到最大也不會糊。
  19. ---
  20. ## 支援平台
  21. 這個 skill 使用 [Agent Skills](https://agentskills.io) 開放格式,理論上支援所有能讀取 `SKILL.md` 的 AI 工具。製作過程需要執行 Node.js 與無頭瀏覽器,所以平台必須能執行程式碼,才能輸出 PDF。
  22. | 平台 | 狀態 | 說明 |
  23. | --- | --- | --- |
  24. | <img src="docs/images/logos/claude.svg" width="16" alt=""> Claude Cowork | ✅ 已實測(Cowork 功能已與 Chat 合併) | 範例截圖都是用 Cowork 製作的,實測 Opus 5.5 mediu、Sonnet 5.5 high 效果都很好。 |
  25. | <img src="docs/images/logos/claude.svg" width="16" alt=""> Claude.ai | ✅ 已實測 | 需要開啟程式碼執行功能 |
  26. | <img src="docs/images/logos/claude-code.svg" width="16" alt=""> Claude Code | 🧪 待測試 | 在你的電腦上執行,需要先安裝相依工具 |
  27. | <img src="docs/images/logos/codex.svg" width="16" alt=""> Codex | 🧪 待測試 | 在你的電腦上執行,需要先安裝相依工具 |
  28. | <img src="docs/images/logos/gemini.svg" width="16" alt=""> Gemini Spark | ⚠️ 部分可用 | 內容可以正常產出,但受限於 Gemini 模型,效果堪用但不多。 |
  29. | <img src="docs/images/logos/gemini.svg" width="16" alt=""> Gemini 聊天室 | ✋ 先不要 ❌ | 內容無法正常產出,效果相當炸裂,可愛龍還是可愛龍。 |
  30. | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/logos/openai-dark.svg"><img src="docs/images/logos/openai-light.svg" width="16" alt=""></picture> ChatGPT Work | ✅ 已實測 | 使用 GPT-6 Astra high 可做到 Opus 5.5 八成效果,會有圖表文字些微跑版的問題。 |
  31. > [!NOTE]
  32. > 如果在各個平台上成功或失敗,歡迎開 [Issue](../../issues) 告訴我。
  33. ---
  34. ## 安裝 skill
  35. **點選你使用的平台**,直接跳到對應的教學:
  36. <table>
  37. <tr>
  38. <td align="center" width="20%"><a href="#install-claude"><img src="docs/images/logos/claude.svg" width="40" alt=""><br><b>Claude</b></a><br>Cowork・Claude.ai</td>
  39. <td align="center" width="20%"><a href="#install-gemini"><img src="docs/images/logos/gemini.svg" width="40" alt=""><br><b>Gemini</b></a><br>Gemini Spark</td>
  40. <td align="center" width="20%"><a href="#install-chatgpt"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/logos/openai-dark.svg"><img src="docs/images/logos/openai-light.svg" width="40" alt=""></picture><br><b>ChatGPT</b></a><br>ChatGPT Work</td>
  41. <td align="center" width="20%"><a href="#install-claude-code"><img src="docs/images/logos/claude-code.svg" width="40" alt=""><br><b>Claude Code</b></a><br>終端機</td>
  42. <td align="center" width="20%"><a href="#install-codex"><img src="docs/images/logos/codex.svg" width="40" alt=""><br><b>Codex</b></a><br>終端機</td>
  43. </tr>
  44. </table>
  45. Claude、Gemini 與 ChatGPT 需要從 [Releases](../../releases) 頁面下載封包,請下載對應的那一個:
  46. | 檔案 | 適用平台 |
  47. | --------------------------- | --------------------------------- |
  48. | `handout-remake.zip` | Claude Cowork、Claude.ai、ChatGPT |
  49. | `handout-remake-gemini.zip` | Google Gemini(含 Gemini Spark) |
  50. <a id="install-claude"></a>
  51. ### <img src="docs/images/logos/claude.svg" width="24" alt=""> Claude Cowork 與 Claude.ai
  52. 1. 到 [Releases](../../releases) 頁面下載最新的 `handout-remake.zip`。
  53. 2. 開啟 Claude 的**設定**,在 **Capabilities** 裡確認**程式碼執行**(Code execution)已開啟。
  54. 3. 在 **Skills** 區塊選擇 **Upload skill**,上傳剛剛下載的 zip 檔。
  55. 4. 確認清單中出現 `handout-remake`,並且是開啟狀態。
  56. > [!NOTE]
  57. > Cowork 需要付費方案。設定頁面的名稱可能隨 Claude 更新而調整,以官方說明為準。
  58. 📖 官方說明:[Use Skills in Claude](https://support.claude.com/en/articles/12512180)、[Getting started with Cowork](https://support.claude.com/en/articles/13345190)
  59. <a id="install-gemini"></a>
  60. ### <img src="docs/images/logos/gemini.svg" width="24" alt=""> Google Gemini Spark
  61. Gemini 的 skill 統一在 Gemini 網頁版的設定裡管理,裝好之後,一般對話與 Gemini Spark 都能使用。
  62. **開始之前**,請確認你符合 Gemini Spark 的使用條件:
  63. - 訂閱 **Google AI Pro 或 Ultra**。
  64. - 用**個人 Google 帳號**登入。
  65. - 年滿 **18 歲**,並且開啟了「**保留活動記錄**」(Keep Activity)。
  66. **安裝 skill**
  67. 1. 到 [Releases](../../releases) 頁面下載最新的 **`handout-remake-gemini.zip`**。
  68. 2. 用電腦瀏覽器開啟 [gemini.google.com](https://gemini.google.com)(或 Mac 版 Gemini App),進入**設定 → 技能**(Skills)。
  69. 3. 選擇上傳檔案,上傳剛剛下載的 zip 檔。
  70. 4. 確認清單中出現 `handout-remake`,並且是啟用狀態。
  71. > [!IMPORTANT]
  72. > 請上傳 **`handout-remake-gemini.zip`**,不要用 Claude 版的 `handout-remake.zip`。Gemini 規定 `SKILL.md` 必須放在 zip 的最外層,也不接受 `.css`、`.html`、`.mjs` 這類副檔名,Claude 版的封包會上傳失敗。Gemini 版已經把這些檔案改成 `.txt`,AI 使用時會自動改回來。
  73. **在 Gemini Spark 中使用**
  74. 1. 在 Gemini Spark 開一個新任務,上傳你的投影片或 PDF。
  75. 2. 在輸入框輸入 `/`,從清單中選擇 `handout-remake`。
  76. 3. 接著說明你要什麼,例如「幫我把第 2 章 p.37–46 做成講義」(也可以什麼都不說)。
  77. > [!WARNING]
  78. > 根據 Google 的官方說明,skill 裡的腳本不能連上網路,所以 Gemini Spark 可能無法安裝建置 PDF 所需的套件。目前實測的結果是**講義內容可以產出**,但不一定能得到排好版的 PDF。這時可以請 Gemini 把排好的 HTML 檔交給你,再參考〈[在自己的電腦上建置 PDF](#在自己的電腦上建置-pdf)〉轉成 PDF。
  79. 📖 官方說明:[建立及管理技能](https://support.google.com/gemini/answer/17094296)、[使用 Gemini Spark](https://support.google.com/gemini/answer/17094507)
  80. <a id="install-claude-code"></a>
  81. ### <img src="docs/images/logos/claude-code.svg" width="24" alt=""> Claude Code
  82. 把 skill 資料夾複製到個人的 skills 目錄:
  83. ```bash
  84. git clone https://github.com/xamjiang/handout-remake.git
  85. cp -R handout-remake/skills/handout-remake ~/.claude/skills/
  86. ```
  87. 只想在某個專案裡使用的話,改為複製到該專案的 `.claude/skills/`。
  88. 📖 官方說明:[Skills – Claude Code Docs](https://code.claude.com/docs/en/skills)
  89. <a id="install-codex"></a>
  90. ### <img src="docs/images/logos/codex.svg" width="24" alt=""> Codex
  91. 複製到 Codex 的 skills 目錄:
  92. ```bash
  93. git clone https://github.com/xamjiang/handout-remake.git
  94. cp -R handout-remake/skills/handout-remake ~/.codex/skills/
  95. ```
  96. 只想在某個專案裡使用的話,改為複製到該專案的 `.agents/skills/`。
  97. 📖 官方說明:[Agent Skills – Codex](https://developers.openai.com/codex/skills)
  98. <a id="install-chatgpt"></a>
  99. ### <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/logos/openai-dark.svg"><img src="docs/images/logos/openai-light.svg" width="24" alt=""></picture> ChatGPT
  100. ChatGPT 的 skill 在側邊欄的 **Plugins → Skills** 分頁管理。這個平台還沒實測,可以先試著上傳 `handout-remake.zip`,詳細的安裝方式請以官方說明為準。
  101. 📖 官方說明:[Skills in ChatGPT](https://help.openai.com/en/articles/20001066-skills-in-chatgpt)
  102. ### 在自己的電腦上執行時:安裝相依工具
  103. Claude Code 與 Codex 會在你的電腦上建置 PDF,所以要先安裝下列工具。Cowork 與 Claude.ai 在雲端沙箱執行,可以跳過這一步。
  104. | 工具 | 用途 | 必要性 |
  105. | ------------------------------------- | ------------------------------- | ------------------- |
  106. | [Node.js](https://nodejs.org) 18 以上 | 執行建置腳本 | 必要 |
  107. | Playwright 與 Chromium | 把 HTML 轉成 PDF | 必要 |
  108. | poppler | 讀取 PDF 文字、轉縮圖、檢查字型 | 必要 |
  109. | LibreOffice | 把 PPT 轉成 PDF | 教材是 PPT 時才需要 |
  110. macOS 可以用 [Homebrew](https://brew.sh) 安裝:
  111. ```bash
  112. brew install node poppler
  113. brew install --cask libreoffice # 教材是 PPT 時才需要
  114. npx playwright install chromium # 下載 Playwright 使用的瀏覽器
  115. ```
  116. > [!TIP]
  117. > 不想安裝 LibreOffice 的話,可以先在 PowerPoint 或 Keynote 裡把投影片匯出成 PDF,再交給 AI。
  118. ### 在自己的電腦上建置 PDF
  119. 如果平台只能給你 HTML 檔(例如 Gemini Spark),可以在自己的電腦上轉成 PDF。需要先安裝 [Node.js](https://nodejs.org) 18 以上。
  120. ```bash
  121. git clone https://github.com/xamjiang/handout-remake.git
  122. mkdir handout && cd handout
  123. cp ../handout-remake/skills/handout-remake/assets/* ../handout-remake/skills/handout-remake/scripts/build.mjs .
  124. npm install && npm i playwright && npx playwright install chromium
  125. ```
  126. 把 AI 給你的 HTML 檔放進 `handout` 資料夾,然後執行:
  127. ```bash
  128. node build.mjs 講義.html 講義.pdf
  129. ```
  130. 畫面上會列出每一頁的剩餘空間。如果出現「溢出」,代表那一頁內容太多,請 AI 重新分頁後再建置一次。
  131. ---
  132. ## 製作第一份講義
  133. ### 步驟 1:準備教材
  134. 把投影片、PDF 或筆記準備好。一份講義只教**一個小節**,大約對應 6–12 張投影片,成品約 12–20 頁。
  135. > [!TIP]
  136. > 教材很長的話,直接指定頁碼範圍,例如「第 47–60 頁」。章節太長時,AI 也會自動拆成「上」「下」兩份,並告訴你這份涵蓋到哪裡。
  137. ### 步驟 2:交給 AI
  138. 上傳教材,然後用一句話說出你要什麼。不需要特別提到 skill 的名稱,AI 會自己判斷要不要使用。
  139. ```text
  140. 幫我把這份投影片的 1.10 節做成講義
  141. ```
  142. ```text
  143. 把第 2 章 p.37–46 整理成好讀版,我下週要小考
  144. ```
  145. ```text
  146. 這是計算機組織第 1 章,幫我整理 Amdahl 定律那一段
  147. ```
  148. ### 步驟 3:等待製作完成
  149. AI 會依序完成這些事,過程中不需要你介入:
  150. 1. 把每一頁教材轉成文字與縮圖,並實際看過每一頁(公式和圖常常只存在圖片裡)。
  151. 2. 決定範圍,把內容切成 3–6 個段落,每段只講一個概念。
  152. 3. 撰寫內容、繪製圖解、排版。
  153. 4. 建置 PDF,並修正所有超出版面的頁面。
  154. 5. 逐頁檢查成品,並用程式驗算每一題的數字。
  155. ### 步驟 4:閱讀 AI 的回覆
  156. 完成後,AI 會附上 PDF,並用一兩句話說明:
  157. - 這份講義**涵蓋投影片的哪些頁**。
  158. - 有沒有**不確定或自行補充**的地方,例如投影片疑似有錯、或為了說清楚而加入的例子。
  159. > [!IMPORTANT]
  160. > 請留意 AI 標出的不確定之處,有疑問時以課本和老師的說法為準。
  161. ### 步驟 5:傳到 iPad
  162. 用 AirDrop 或 iCloud 雲碟把 PDF 傳到 iPad,再用 GoodNotes、Notability 或內建的「檔案」App 開啟,就可以直接在書寫區作答。
  163. ---
  164. ## 了解講義的結構
  165. 每份講義都由幾種固定的頁面組成,順序也固定,讀過一份之後,之後的每一份都知道去哪裡找什麼。
  166. ### 節首頁與概念頁
  167. <table>
  168. <tr>
  169. <td width="50%"><img src="docs/images/page-opener.webp" alt="節首頁"></td>
  170. <td width="50%"><img src="docs/images/page-concept.webp" alt="概念頁"></td>
  171. </tr>
  172. <tr>
  173. <td><b>節首頁</b>:一句話說出這節在問什麼,列出讀完之後能做到的事,以及對應的投影片頁碼、閱讀時間與先備知識。</td>
  174. <td><b>概念頁</b>:從生活情境開始,帶出術語與中英對照,再用圖解和公式說明。整頁最關鍵的一句話會用螢光標出。</td>
  175. </tr>
  176. </table>
  177. ### 例題頁
  178. <table>
  179. <tr>
  180. <td width="50%"><img src="docs/images/page-example.webp" alt="例題頁"></td>
  181. <td width="50%">
  182. <p>每一題都先列出<b>已知、要求、想法</b>,再用編號步驟一步一步解,每一步都有一句小標說明在做什麼。</p>
  183. <p>最後一步固定是<b>檢查答案合不合理</b>,養成驗算的習慣。</p>
  184. <p>投影片上原有的例題會優先採用,並標明出處頁碼。</p>
  185. </td>
  186. </tr>
  187. </table>
  188. ### 練習頁與解答頁
  189. <p align="center">
  190. <img src="docs/images/practice-answer.webp" alt="左邊是練習頁,右邊是解答頁" width="100%">
  191. </p>
  192. 練習題分成**基本、觀念、變化、綜合**四種層次,每頁最多三題,每題都有點陣書寫區。**解答一定在練習的下一頁**:先給出最終答案,再給完整步驟,頁尾的「寫錯了?回頭看這裡」會告訴你該回去看哪一頁。
  193. ### 圖解
  194. <table>
  195. <tr>
  196. <td width="50%"><img src="docs/images/page-figure.webp" alt="函數曲線圖與動手做區塊"></td>
  197. <td width="50%"><img src="docs/images/page-stack.webp" alt="記憶體 stack 變化圖"></td>
  198. </tr>
  199. <tr>
  200. <td>函數曲線與「動手做」:附上可以自己執行的程式碼,親眼看到概念的結果。</td>
  201. <td>結構與流程圖:把每一步的變化並排畫出來,比文字說明更容易追蹤。</td>
  202. </tr>
  203. </table>
  204. 所有圖解都使用同一套色盤,**同一個顏色在整份講義裡只代表一件事**,而且和公式裡的色塊對應。圖解是向量繪製,放大後依然清晰:
  205. <p align="center">
  206. <img src="docs/images/detail-figure.webp" alt="圖解放大後的細節" width="100%">
  207. </p>
  208. ### 複習頁
  209. <table>
  210. <tr>
  211. <td width="50%"><img src="docs/images/page-review.webp" alt="複習頁"></td>
  212. <td width="50%">
  213. <p>每份講義的最後依序是:</p>
  214. <ol>
  215. <li><b>本節重點</b>:每個段落濃縮成一句話</li>
  216. <li><b>公式一覽</b>:考前快速複習用</li>
  217. <li><b>自我檢查</b>:可以勾選的能力清單</li>
  218. <li><b>術語對照</b>:中文、英文與一句話解釋</li>
  219. <li><b>下一節預告</b></li>
  220. </ol>
  221. </td>
  222. </tr>
  223. </table>
  224. ---
  225. ## 自訂講義
  226. ### 在對話中調整
  227. 最簡單的方式是直接在對話中告訴 AI,例如:
  228. ```text
  229. 練習題多一點,每個段落後面都放一頁
  230. ```
  231. ```text
  232. 這份不需要「動手做」的段落
  233. ```
  234. ```text
  235. 我已經學過微積分,基礎的部分可以講快一點
  236. ```
  237. ### 修改 skill 的預設值
  238. 想讓每一份講義都套用你的偏好,可以直接修改 skill 的檔案:
  239. | 想改的東西 | 修改的位置 |
  240. | -------------------- | --------------------------------------------------------------------------------------------- |
  241. | 讀者程度、語言、偏好 | `SKILL.md` 開頭的「讀者設定」 |
  242. | 教學順序、練習數量 | `SKILL.md` 的〈教學規則〉 |
  243. | 顏色、字級、間距 | `assets/handout.css` 開頭的 CSS 變數 |
  244. | iPad 尺寸 | `assets/handout.css` 的 `--page-w`、`--page-h`、`@page`,以及 `scripts/build.mjs` 的 viewport |
  245. > [!NOTE]
  246. > 修改後,Cowork、Claude.ai 與 Gemini 需要重新打包再上傳一次。在 repo 根目錄執行 `tools/package.sh`,就會在 `dist/` 產生兩種封包(只會打包已 commit 的內容)。
  247. ---
  248. ## 疑難排解
  249. <details>
  250. <summary><b>出現「找不到 playwright」</b></summary>
  251. 在講義的工作資料夾裡安裝 Playwright 與它使用的瀏覽器:
  252. ```bash
  253. npm i playwright
  254. npx playwright install chromium
  255. ```
  256. </details>
  257. <details>
  258. <summary><b>PPT 檔讀不進去</b></summary>
  259. 轉換 PPT 需要 LibreOffice。可以安裝 LibreOffice,或先在 PowerPoint、Keynote 裡把投影片匯出成 PDF 再上傳。
  260. </details>
  261. <details>
  262. <summary><b>PDF 有內容被截掉</b></summary>
  263. 建置腳本會回報每一頁的剩餘空間,AI 應該在交付前修正所有溢出。如果成品仍有被截掉的地方,請告訴 AI 是第幾頁,請它重新分頁。
  264. </details>
  265. <details>
  266. <summary><b>PDF 裡的字變成方框或模糊</b></summary>
  267. 字型必須使用 `@fontsource` 的靜態字重版本。請確認工作資料夾是用 skill 附的 `package.json` 安裝套件,不要改用 variable 版本的字型。
  268. </details>
  269. ---
  270. ## 使用須知
  271. - **AI 可能出錯**:skill 會要求 AI 驗算所有數字並標出不確定的地方,但請仍以課本與老師的說法為準。
  272. - **尊重著作權**:上課教材的著作權屬於老師或出版社。用這個 skill 製作的講義請只供個人學習使用,不要公開散布。
  273. ---
  274. ## 專案結構
  275. ```text
  276. .
  277. ├── README.md
  278. ├── LICENSE
  279. ├── docs/images/ README 使用的圖片
  280. ├── tools/package.sh 打包 Claude 版與 Gemini 版的 zip
  281. └── skills/handout-remake/ skill 本體
  282. ├── SKILL.md 流程與規則
  283. ├── assets/
  284. │ ├── handout.css 樣式與色盤
  285. │ ├── template.html 每種頁面的範本
  286. │ └── package.json 字型與 KaTeX 的版本
  287. └── scripts/
  288. └── build.mjs 建置、溢出檢查、輸出 PDF
  289. ```
  290. ## 參與貢獻
  291. 歡迎開 Issue 回報問題或分享你的使用結果。送出 Pull Request 時,commit 訊息請遵守 [Conventional Commits](https://www.conventionalcommits.org/zh-hant/v1.0.0/),例如:
  292. ```text
  293. feat(skill): 新增 13 吋 iPad 的版面
  294. fix(build): 修正 KaTeX 巨集的顏色
  295. docs: 補充 Codex 的安裝步驟
  296. ```
  297. ## 授權
  298. 本專案以 [MIT License](LICENSE) 授權。README 中的範例截圖取自作者自己的課程講義,僅供展示。
  299. 平台 logo 取自 [Lobe Icons](https://github.com/lobehub/lobe-icons)(MIT License),商標權屬於各自的公司,在此僅用來標示相容的平台。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.