Communitygithub.com

study-site

用於建立學習頁面、章節筆記頁面、複習或考試準備成品,以及課程學習索引——從簡報、PDF、考古題、練習卷或僅一個主題名稱開始。

study-site 是什麼?

這是一個為 AI 代理(如 Claude Code、Cursor 或 Codex)設計的技能(skill),專門用於建立互動式、單一檔案的 HTML 學習頁面,並將其發佈為成品(artifact)或 `.html` 檔案。它從 `assets/template.html` 模板開始,確保所有標準功能(如明暗主題切換、進度追蹤、搜尋、圖片複製)都不會被遺漏。該技能適用於任何課程或主題的學習材料。它能根據使用者的要求自動適應不同學科(如理論、系統、數學、語言學或描述性學科),並為課程頁面添加「考試模式」(含計時器與評分)與「複習工具」(作弊表與閃卡)。工作流程包括先詢問使用者的需求(課程名稱、章節、索引位置),然後讀取所有附件(簡報、筆記、考古題),規劃主題清單,並嚴格按照「解釋→圖表→圖表說明→範例→考古題/練習題→練習選擇題」的順序撰寫內容。所有圖表均使用內聯 SVG 繪製,並附有詳細說明;所有問題皆附完整解答;最後會進行多裝置與多主題的檢查,確保成品無誤。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ranjit-choudhary/claude-skills-ranjit/tree/HEAD/study-site

在你喜歡的 AI 中提問

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

說明文件

Study Site

建立互動式、單一檔案的 HTML 學習頁面,以成品(artifact)形式發佈(若無法使用成品功能,則另存為 .html 檔案)。每個頁面都從 assets/template.html 開始,因此標準功能永遠不會被遺漏。

0. 設定 — 根據需求編輯

設定值
主索引 URL(連結所有課程的中心頁面)none — 可設定為您中心頁面的 URL,或保留 none 以跳過索引更新
預設主題light(始終包含深色模式切換)
章節導覽僅返回課程索引的連結 — 無上一頁/下一頁章節連結
索引卡片樣式極簡:圖示、課程代碼、課程名稱 — 不顯示統計資料

1. 先詢問(一輪提問)

僅詢問請求中尚未明確的項目:

  1. 這是為課程設計的嗎? 如果是:哪門課程、哪個章節或區塊。課程頁面在標準功能之上會附加考試模式與複習工具;非課程頁面(一般主題、一次性解說)則跳過這些功能。
  2. 應該列在哪裡? 直接在主索引上、在課程學習索引內(指定哪個索引),或是不列在任何地方。如果主索引設定為 none,則跳過此問題。
  3. 如果課程的學習索引 URL 未知,請詢問 — 頁面的返回連結需要它。

如果使用者曾儲存關於他們希望如何教授某門課程的筆記(記憶、專案說明、先前的訊息),請閱讀並遵循這些筆記,優先於下方的預設值。

2. 在開始建構前收集資料

  • 完整閱讀所有附件:簡報、筆記、考古題、練習卷。
  • 收集每個主題對應的歷年考題(PYQs)和練習題。
  • 在來源資料中修正錯誤時保持靜默;除非被詢問,否則不要指出它們。
  • 然後再規劃主題清單:每個邏輯主題一個 <section class="topic">,內容盡量精簡,可一次性完成。

3. 教學規則(所有學科)

  • 假設無先備知識。從基礎建立,每個術語首次使用時定義,詳細說明而非壓縮內容。
  • 每個主題內的順序:解釋 → 其圖表(緊接在後)→ 圖表說明 → 範例 → 考古題/練習題 → 練習選擇題。 永遠不要將圖表集中放在結尾。
  • 每個圖表都必須附有說明。絕不發佈裸圖表。
  • 用 .callout.imp 標記考試重點,用 .callout.mistake 標記常見陷阱。
  • 題目: 每道題目在解答之前都必須完整寫出,不得濃縮。回答所有問題;不留任何未解答的題目。考古題須標示來源、年份與分數(例如 PYQ 2024 期中考 · 5分)。
  • 每個主題至少 3 道練習選擇題,附有合理的干擾選項和 .why 說明。
  • 圖表使用內聯 SVG,絕不使用 ASCII。對於逐步演變的內容,使用 .stepper(每個狀態一個 figure.fig.step)。
  • 除非被要求,否則不提供學習計畫或日程安排。

4. 根據學科調整

學科類型重點
理論 / 證明(計算理論、離散數學、演算法)每個自動機的狀態圖;追蹤輸入字串的逐步器;證明模板(泵引理、歸約、歸納法)作為填空步驟;大量小範例
系統(作業系統、計算機架構、網路)視覺優先;管線的逐步器、排程甘特圖、頁面置換、快取查找;逐步解題的數值題;教科書章節練習題
語言 / 形式符號(程式語言、編譯器)BNF/EBNF、解析樹與屬性文法,以清晰的 SVG 樹狀圖呈現;正規表達式逐步建構;練習題內嵌解答
數學密集型(機器學習、統計學、訊號)先給直覺,再一步步推導,每一步都要說明理由;SVG 繪圖;教科書練習題解答
描述性(生物學、管理學、人文學)以考古題為驅動:將歷年考題按主題分組,提供符合考試長度的範例答案,使用流程圖與比較表格來說明流程

對於未列出的學科,選擇最接近的選項。使用者的課程筆記優先於此表格。

5. 頁面功能(內建於模板)

功能運作方式您的工作
淺色主題 + 深色切換預設為淺色;🌙 切換;選擇會被記住僅使用 CSS 變數 — 不使用硬編碼顏色
捲動位置還原重新開啟時保存並還原位置無需操作
進度追蹤每個主題的「標記為已完成」、進度條、✓ 在目錄中每個主題區段需有唯一的 id
搜尋過濾主題並高亮顯示匹配結果無需操作
複製圖片每個 figure.fig 上的懸浮按鈕可複製為 PNG(觸控裝置上始終可見)將每個圖表或影像包裹在 figure.fig 中
手機友善響應式;表格可橫向捲動保持 SVG 基於 viewBox;無固定寬度
練習選擇題即時回饋;答案會被記住data-answer = 正確選項的 0 為基礎索引
顯示答案details.answer用於每個長篇解答
返回連結頁首連結到課程學習索引填入 {{COURSE_INDEX_URL}}
僅限課程頁面: 複習工具作弊表(.cheatsheet)+ 閃卡(.flashdeck)一頁包含公式、定義、關鍵圖表的摘要;至少 10 張閃卡
僅限課程頁面: 考試模式模糊直到點擊「開始」;計時器;點擊「送出」後評分選擇題;顯示範例答案混合選擇題(data-marks)和長題目,風格與該課程的考古題一致;設定 data-minutes

進度與分數儲存在檢視者的瀏覽器中,每個頁面獨立 — 索引頁面無法顯示章節進度,且不會跨裝置同步。

6. 設計規則

  • 極簡且平靜。長篇閱讀使用襯線字體,UI 使用無襯線字體。內容寬度約 820px。
  • 避免 AI 味:不使用紫色漸層、英雄橫幅、全部置中排版、Inter 字體或表情符號紙屑。
  • 顏色承載意義:藍色 = 資訊,金色 = 考試重點,紅色 = 錯誤,綠色 = 正確/完成。
  • SVG 圖表:標示所有元素;使用 var(--text)、var(--accent) 等作為線條與填色;在手機寬度下文字 ≥12px。

7. 課程學習索引頁面

對於課程索引或中心頁面:使用極簡卡片(參見設定)、相同的頁首(搜尋 + 主題切換)、捲動還原、預設淺色主題。

8. 建構、發佈、檢查

  1. 複製 assets/template.html,填入 {{佔位符}},對於非課程頁面刪除僅限課程的區塊(或對於課程頁面取消註解它們)。
  2. 以成品形式發佈(或儲存為 .html 檔案)。先展示頁面,之後再檢查。
  3. 在桌面與約 390px 寬度下檢查兩種主題:每個圖表都有複製按鈕、每個選擇題都有正確的 data-answer、每個問題都有解答、沒有剩餘的 {{佔位符}}。
  4. 將頁面連結加入步驟 1 中所選的主索引或課程索引。不要重新設計索引頁面。

相關技能