前言¶
想系统读《资治通鉴》，常见做法是自行拆卷、找译本、记进度，再每天打开文档或笔记。步骤分散，很难和对话式助手保持在同一套节奏里。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
