Community生產力與協作github.com

Study Pack

將 Notion 或上傳檔案中的課程資料,轉換成一份連貫的學習包(包含 Sílabo、Resumo、Revisão 以及可選的 Plano),或更新現有學習包。所有課程皆使用統一的問題格式與固定頁面套件,確保外觀與操作一致。

Study Pack 是什麼?

此技能可自動將課程素材(來自 Notion 筆記或上傳的 PDF、Word 等檔案)整理成一套結構化的學習包。它會根據預先定義的套件(kit)來生成四個頁面:大綱型的 Sílabo、詳盡解說與例題的 Resumo、包含練習與評分的 Revisão,以及可選的考試計畫 Plano。 技能嚴格遵循套件規則,所有頁面均透過 kit 內的 build.py 產生,使用者只需以 JSON 格式提供內容。它支援多種題型(選擇題、自由作答、是非題等)、計算機模式、個人化主題、字型選擇,以及透過 localStorage 或資料庫儲存學習進度。 此技能特別適合需要為多門課程建立一致學習資源的學生或教師,支援 Notion 文字擷取、教材掃描、題庫管理等功能,並能與 Claude Code 或 Cursor 等平台上的 AI 助手整合。 工作流程包含:取得套件、檢查既有學習包、收集素材、透過視覺化問卷設定選項、以 JSON 撰寫內容、建立考試計畫、建置與檢查,最後發佈至指定的 URL。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CAFEERON21br18/claude-skills/tree/HEAD/study-pack

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

學習包

針對一門課程的四個連結頁面,一律透過套件(kit)建置(位於 github.com/CAFEERON21br18/claude-skills 的 study-pack/kit 資料夾):

  1. Sílabo:編號主題,僅含必要內容。
  2. Resumo:完整課程,詳盡解說,每個主題至少 3 個有解答的範例。
  3. Revisão:簡短課程 + 練習題(你的/使用者的)、評分、歷史紀錄、筆記、家教。
  4. Plano(可選):附有圖表和勾選記號的考試倒數計畫。

第零條規則:套件決定外觀,你只負責撰寫內容

  • 每個頁面皆由 kit/build.py 產生。切勿手動撰寫或修改頁面的 HTML、CSS 或 JS,切勿「改善」版面配置,切勿加入頁面專屬樣式。相同的選項就會產生相同的頁面,無論是哪個課程(CDI、AL、LP……)。
  • 你只需要撰寫 kit/SCHEMA.md 中描述的 JSON(使用 Python 的 json.dump),然後建置、檢查、發佈。
  • 問題一律使用 kit/questions.py 中的表單,依照其順序與格式。切勿改寫、重新排序、拆分或以其他方式提問。切勿僅列出主題名稱而不附帶顏色。
  • 如果某些功能無法透過套件實現,請在最終訊息中用一行說明。不要透過修改 HTML 來繞過限制。

套件為你處理好的項目(請勿重新實作):頁首(CDI 版面:左側為課程名稱+標題,右側為 4 個分頁,第二列為工具列:倒數計時 · 頁面工具 · As minhas notas · 淺色/深色切換按鈕,使用 ruben-bonanni-ribeiro.dev 的太陽/月亮圖示)、主題列、內嵌字型的 KaTeX、寬版數學公式排版、筆記、家教聊天室、圖形計算機、專注模式、日曆天數倒數、同分頁連結、手機版版面、儲存功能。

每個頁面的工具(順序固定,關閉的選項直接隱藏):

頁面頁首工具頁首下方工具列
Sílabo倒數計時 · 專注模式 · 我的筆記 · ☾/☀—
Resumo倒數計時 · 計算機 · 專注模式 · 我的筆記 · ☾/☀—
Revisão倒數計時 · 計算機 · 專注模式 · 僅錯題 · 歷史紀錄 · 我的筆記 · ☾/☀已完成 / 正確 / 待複習 + 已儲存
Plano倒數計時 · 今天 · 隱藏已完成 · ☾/☀完成的時段 + 時數

步驟 0 — 取得套件,以及學習包是否已存在?

  1. 每次皆重新取得套件(內容可能已更新): git clone --depth 1 https://github.com/CAFEERON21br18/claude-skills /tmp/sp && cp -r /tmp/sp/study-pack/kit ./kit 閱讀 kit/SCHEMA.md。
  2. 列出使用者的成品(Artifact 清單,範圍「全部」,限制 200 筆),尋找「Sílabo/Syllabus/Programa — <課程名稱>」、「Resumo — <課程名稱>」、「Revisão/Revision — <課程名稱>」、「Plano — <課程名稱>」或類似的名稱。
  3. 找到 → 簡短詢問一次:「Já existe um pacote de <課程名稱>. Atualizo esse ou crio um novo?」(更新現有(推薦)· 建立新的)。如果選擇更新:「O que muda?」(加入新素材 · 更改選項 · 補上缺少的頁面 · 重新出題)。 名稱模糊 → 詢問一次要使用哪一個,提供最接近的比對結果以及「Nenhum, começar do zero」(無,從頭開始)。未找到 → 直接繼續,無需詢問。

更新模式

  • 立即在步驟 0 中,使用 Artifact 的 action:"read" 不帶 path 參數,完整讀取每個現有頁面。如果未讀取完整現行版本,則拒絕發佈。大型頁面會以儲存檔案的形式回傳:請以每次約 150–200 行的方式分段讀取,直到讀完。同時儲存每個頁面的 HTML(使用 read 加上 path:"index.html"),供 extract.py 使用。
  • python3 kit/extract.py pack <已儲存頁面…> 從套件頁面重建 pack/(pack.json、topics、plan.json)。保留 slug、storage、urls、主題編號和練習題 ID 不變。
  • 舊版學習包(無套件資料):從頁面推斷設定(主題、字型、語言、功能、數量),並寫入 pack.json。將其儲存金鑰複製到 `

相關技能