學習包
針對一門課程的四個連結頁面,一律透過套件(kit)建置(位於 github.com/CAFEERON21br18/claude-skills 的 study-pack/kit 資料夾):
- Sílabo:編號主題,僅含必要內容。
- Resumo:完整課程,詳盡解說,每個主題至少 3 個有解答的範例。
- Revisão:簡短課程 + 練習題(你的/使用者的)、評分、歷史紀錄、筆記、家教。
- 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 — 取得套件,以及學習包是否已存在?
- 每次皆重新取得套件(內容可能已更新):
git clone --depth 1 https://github.com/CAFEERON21br18/claude-skills /tmp/sp && cp -r /tmp/sp/study-pack/kit ./kit閱讀kit/SCHEMA.md。 - 列出使用者的成品(
Artifact清單,範圍「全部」,限制 200 筆),尋找「Sílabo/Syllabus/Programa — <課程名稱>」、「Resumo — <課程名稱>」、「Revisão/Revision — <課程名稱>」、「Plano — <課程名稱>」或類似的名稱。 - 找到 → 簡短詢問一次:「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。將其儲存金鑰複製到 `