前言¶
想系統讀《資治通鑑》，常見做法是自行拆卷、找譯本、記進度，再每天打開文檔或筆記。步驟分散，很難和對話式助手保持在同一套節奏裏。SkillHub 上的社區 Skill「資治通鑑每日學習」（@user_25ab92ec/zizhitongjian-study，v1.0.0）把「按書序每日一篇、原文—譯文—解讀、進度與檢索」寫進標準 SKILL.md，並附帶 Python 入口腳本，便於在 Cursor 等支持 Skills 的客戶端裏複用同一套約定。
這是什麼¶
「資治通鑑每日學習」是 SkillHub education 分類下的社區 Skill，發佈者爲 user_25ab92ec，當前版本 1.0.0，標籤標明 requires_api_key=false（無需額外 API Key）。官方頁面與 API 座標分別爲 SkillHub 技能頁 與 https://api.skillhub.cn/user_25ab92ec/zizhitongjian-study。
它面向「按《資治通鑑》原書順序、每天一篇」的學習方式：每篇包含原文、白話翻譯與解讀（背景、人物、啓示等）。SKILL.md 中說明全書約 294 卷、約 300 天 學完的節奏；具體篇目與進度由 Skill 內邏輯與本地數據承載。
核心功能¶
以下能力均來自包內 SKILL.md 與 src/main.py，安裝後 Agent 可按 Skill 說明調用；也可在終端直接運行入口腳本。
-
每日學習（daily_lesson）
按學習進度推送當前「第 N 天」篇目，輸出卷次、年份、標題、原文、翻譯、解讀。 -
指定天數 / 卷序學習
跳轉到某一天的內容（Skill 文檔中的斜槓命令與 CLI 的day子命令）。 -
搜索（search_events）
在標題、原文、譯文、解讀文本中按關鍵詞檢索相關篇目。 -
進度（track_progress）
記錄當前天數、已完成篇數、開始與上次學習日期；進度寫入 Skill 目錄下data/progress.json（由main.py創建與更新）。 -
斜槓命令（SKILL.md 聲明）
-/zizhi-today：今日學習內容
-/zizhi-day：指定某天學習
-/zizhi-search：搜索歷史事件
-/zizhi-progress：學習進度 -
CLI 子命令（entry_point：
src/main.py）
除today、day、search、progress外，還提供random隨機一篇；today/day支持--complete/-c標記完成並推進current_day。
運行環境：skill.json 要求 Python >= 3.9.0，並聲明 file_access 權限（用於讀寫進度文件）。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝說明 執行（完整安裝示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安裝本 Skill 到當前 Agent 的 skills 目錄¶
SkillHub 要求安裝時必須用 --dir 指向當前客戶端會加載的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。
skillhub install @user_25ab92ec/zizhitongjian-study --dir <你的 skills 目錄>
常見路徑（摘自官方安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
官方技能頁給出的自然語言安裝提示爲：根據 https://skillhub.cn/install/skillhub.md 安裝 @user_25ab92ec/zizhitongjian-study。安裝完成後，按你所用客戶端說明重啓或重新加載 Skills，使 SKILL.md 被 Agent 讀取。
3. 可選：直接用 Python 跑入口腳本¶
在已安裝的技能目錄中（包內路徑爲 src/main.py），可在 Python 3.9+ 環境下執行，例如：
python3 src/main.py today
python3 src/main.py day 1
python3 src/main.py search 曹操
python3 src/main.py progress
python3 src/main.py today --complete
進度文件默認位於 src/data/progress.json（相對 main.py 所在目錄的 data 子目錄）。
典型用法¶
在對話裏（按 SKILL.md）
啓用 Skill 後，可用文檔中的示例形式發起學習，例如今日一篇、指定第 1 天、搜索「曹操」、查看進度：
/zizhi-today
/zizhi-day 1
/zizhi-search 曹操
/zizhi-progress
在終端（按 main.py）
與上面對應的 CLI 示例：
python3 src/main.py today
python3 src/main.py day 1 --complete
python3 src/main.py search 曹操
python3 src/main.py progress
學完當天內容後使用 --complete，會將當日記入 completed_days 並將 current_day 推進到下一天。
適用場景與注意¶
適合誰
- 希望用固定節奏讀《資治通鑑》、且希望在 Agent 對話裏用統一命令觸發學習的人。
- 需要在本地保留學習進度、偶爾按人名或事件關鍵詞回顧篇目的人。
限制與實現細節（以當前 v1.0.0 包爲準）
- 包內 src/main.py 將篇目數據放在常量 ZIZHI_TONGJIAN_DATA 中，源碼註釋寫明爲「部分原文數據（示例，實際應包含全書）」；當前倉庫內僅內置 day 1–3 三篇（如「三家分晉」「智伯索地」「晉陽之戰」）。因此 progress 中的「總篇數」與「約 300 天」在文檔層是產品目標，現網包內可學篇數需以實際數據條數爲準。
- skill.json 中含 freemium 定價字段（free / pro），屬於包內元數據；是否在 SkillHub 或客戶端側強制限額，需以你安裝來源的說明爲準，本文不展開未在 SkillHub 頁面公示的商業條款。
- 社區來源（source: community），內容與校對質量依賴發佈者維護；史學閱讀仍建議對照權威版本。
- SkillHub 頁面統計（抓取時）：評分 100000，下載 1148，安裝 2；會隨時間變化，以技能頁爲準。
結尾¶
「資治通鑑每日學習」把按日閱讀、檢索與進度跟蹤收斂到一套 Skill 約定與可選 CLI，適合掛在 Cursor 等環境的 skills 目錄里長期使用。安裝與座標：
- 技能頁：https://www.skillhub.cn/skills/user_25ab92ec/zizhitongjian-study
- API：https://api.skillhub.cn/user_25ab92ec/zizhitongjian-study
