一个AI 驱动的学习框架，帮助你系统化掌握任何技术领域。Fork 后即可自定义学习内容。
📖 核心概念速查（点击展开）
| 术语 | 一句话解释 |
|---|---|
| Fork | 在 GitHub 上复制一个仓库到你的账号下 |
| upstream | 原始的主仓库（模板源） |
| origin | 你 Fork 后的个人仓库 |
| MCP | Model Context Protocol，让 Claude 能使用外部工具的协议 |
| Tool Use | Claude 调用工具（如编辑文件、运行命令）的能力 |
| Hook | 在特定事件发生时自动执行的脚本 |
| 书签系统 | 记录学习疑问，深入探索后能返回主线的导航系统 |
| 知识缓存 | 将官方文档保存到本地，避免重复拉取 |
| 本地管理 | 数据保存在你的电脑上，不会同步到 GitHub |
┌─────────────────────────────────────────────┐
│ AI 技术学习模板总览 │
└─────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────┐
│ 核心价值 │
├─────────────────────────────────────────────────────────────────────┤
│ 📦 模板化设计 │ Fork 后自定义学习内容，适合任何技术领域 │
│ 🤖 AI 辅助学习 │ Claude Code 驱动的进度追踪和知识管理 │
│ 📊 进度追踪 │ 自动化进度计算，可视化学习路径 │
│ 💾 知识缓存 │ 本地缓存官方文档，减少重复获取 │
└─────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────┐
│ 学习模式说明 │
├─────────────────────────────────────────────────────────────────────┤
│ 快速模式（理论） │ 完整模式（理论+实践） │
│ 阅读文档、理解概念 │ 实践操作、完成项目、输出作品 │
│ 约 30% 时间 │ 完整学习体验 │
└─────────────────────────────────────────────────────────────────────┘
01-基础入门 (1-1.5周) ████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
├─ ai-tools-fundamentals [P0🔴] AI 工具基础
└─ mcp-protocol [P1🟡] MCP 协议入门
02-进阶探索 (1.5-2周) ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░██████████░░░░░░░
├─ agent-configuration [P2🟢] Agent 配置与使用
├─ mcp-advanced-config [P3🔵] MCP 高级配置
├─ ai-orchestration [P1🟡] AI 编排平台
└─ ai-resources-research [P1🟡] AI 资源研究
03-实战应用 (2-3周) ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░████████░░░░░
├─ config-management [P2🟢] 配置管理工具
├─ spec-driven-dev [P2🟢] 规范驱动开发
└─ practical-projects [P1🟡] 综合实战项目
| 特性 | 说明 |
|---|---|
| 📦 模板化设计 | Fork 后即可自定义学习内容，添加你自己的学习模块 |
| 🤖 AI 辅助学习 | Claude Code 驱动的进度追踪、书签导航、知识缓存 |
| 📊 进度追踪 | 自动化进度计算，可视化学习路径，优先级管理 |
| 💾 知识缓存 | 本地缓存官方文档，减少重复获取，提升学习效率 |
| 🔒 数据隔离 | 学习进度和笔记完全本地管理，不会同步到 GitHub |
| 要求 | 说明 |
|---|---|
| 操作系统 | Windows 10/11 |
| Shell 环境 | Git Bash（Git for Windows 自带）或 WSL |
| 必需软件 | Git、Claude Code CLI |
注意：本项目目前仅支持 Windows 环境。脚本使用 bash 编写，需要 Git Bash 或 WSL 运行。
| 场景 | 说明 |
|---|---|
| 个人技术学习 | 系统化学习任何技术领域（AI、前端、后端、DevOps...） |
| 团队培训 | 团队共同学习特定技术栈，统一学习路径 |
| 课程管理 | 教师创建课程模板，学生 Fork 后跟踪学习进度 |
| 技能认证准备 | 系统化准备技术认证考试 |
| 阶段 | 预计时长 | 模块数 | 说明 |
|---|---|---|---|
| 01-基础入门 | 1-1.5 周 | 2 | AI 工具基础与 MCP 协议 |
| 02-进阶探索 | 1.5-2 周 | 4 | Agent 配置、AI 编排、资源研究 |
| 03-实战应用 | 2-3 周 | 3 | 配置管理与综合项目 |
当前进度：查看 PROGRESS.md 了解详细进度
本模板支持 Fork + upstream 工作流，你拥有独立的学习数据，同时可以获取模板更新。
💡 什么是 Fork 工作流？
- Fork = 复制模板到你的账号
- upstream = 模板仓库（你 Fork 的源）
- origin = 你的仓库（Fork 后的副本）
详细解释见 TEMPLATE_GUIDE.md
⚠️ 重要提示：首次使用前请运行bash scripts/init.sh初始化课程内容。
┌─────────────────────────────────────────────────────────────────┐
│ 步骤 1: Fork 并 Clone │
│ 1. Fork 本模板到你的 GitHub 账号 │
│ 2. Clone 你的仓库到本地: git clone <your-fork-url> │
│ 3. 运行初始化: bash scripts/init.sh │
├─────────────────────────────────────────────────────────────────┤
│ 步骤 2: 开始学习 │
│ 对 Claude 说：→ "开始学习 ai-tools-fundamentals" │
├─────────────────────────────────────────────────────────────────┤
│ 步骤 3: 同步更新（可选） │
│ GitHub UI: 点击 "Sync fork" → "Update branch" │
└─────────────────────────────────────────────────────────────────┘
| 特性 | 说明 |
|---|---|
| 数据隔离 | 学习进度、笔记、书签完全本地管理，不会被同步覆盖 |
| 模板更新 | 通过 GitHub "Sync fork" 获取模板最新功能和修复 |
| 模块模板 | 课程模板存放在 .templates/modules/，可自由修改个人版本 |
- TEMPLATE_GUIDE.md - 完整的模板使用指南
- MIGRATION_V3.md - v3.0.0 升级指南
- CHANGELOG.md - 版本变更历史
┌─────────────────────────────────────────────────────────────────┐
│ 步骤 1: 查看状态 │
│ 对 Claude 说：→ "查看学习状态" │
├─────────────────────────────────────────────────────────────────┤
│ 步骤 2: 开始学习 │
│ 对 Claude 说：→ "开始学习 ai-tools-fundamentals" │
│ 选择模式：快速(3天) / 完整(1周) │
├─────────────────────────────────────────────────────────────────┤
│ 步骤 3: 更新进度 │
│ 对 Claude 说：→ "更新进度 ai-tools-fundamentals" │
└─────────────────────────────────────────────────────────────────┘
| 功能 | 命令 | 说明 |
|---|---|---|
| 学习管理 | ||
| 开始学习 | 开始学习 <模块名> |
启动模块学习 |
| 更新进度 | 更新进度 <模块名> |
同步学习进度 |
| 查看状态 | 查看学习状态 |
显示进度概览 |
| 书签系统 | ||
| 创建书签 | 创建书签 <名称> |
记录疑问点，深入探索 |
| 继续书签 | 继续书签 |
查看并继续探索 |
| 完成书签 | 完成书签 <名称> |
完成探索，返回主线 |
| 知识缓存 | ||
| 初始化缓存 | 初始化知识缓存 <模块名> |
首次拉取官方资料 |
| 刷新缓存 | 刷新知识缓存 |
更新所有缓存 |
| 查看缓存 | 查看知识缓存 |
显示缓存状态 |
💡 所有命令都支持自然语言变体，例如"开始学习模块 mcp-protocol"、"我的书签"等
| 模式 | 时长 | 内容 | 适合人群 |
|---|---|---|---|
| 📚 快速模式 | ~3天 | 理论阅读 | 想快速了解概念 |
| 🛠️ 完整模式 | ~1周 | 理论+实践 | 需要深入掌握 |
| 指南 | 说明 |
|---|---|
| 学习工作流程 | 完整的学习命令说明（包含书签和缓存系统） |
| 模板使用指南 | Fork + upstream 工作流，自定义学习计划 |
| v3.0.0 升级指南 | Fork 用户升级到 v3.0.0 的步骤 |
| Agent Skills 平台指南 | 全网 Agent Skills 发现和分享平台评估 |
| 工具改进指南 | 如何改进这个学习工具本身 |
| .claude/IDEAS.md | 学习工具改进想法记录 |
使用 Skill "新增模块" 快速创建新模块：
对 Claude 说："新增模块 react-basics，阶段 01-基础入门，优先级 P1"
或者手动创建模块目录结构：
- 创建模块目录（如
01-基础入门/react-basics/） - 复制
.templates/modules/中的模板文件 - 更新 CLAUDE.md 的模块路径映射
编辑模块的 README.md，添加你的学习资源链接：
## 学习资源
### 官方文档
- [React 官方文档](https://react.dev)
- [TypeScript 手册](https://www.typescriptlang.org/docs/)
### 推荐教程
- 你的教程链接...编辑 CLAUDE.md 自定义：
- 学习命令触发词
- 进度计算规则
- 书签系统行为
本模板内置了 AI 工具学习基础课程作为示例，包含以下模块：
仅完成 P0 必学模块：
ai-tools-fundamentals[P0]- 时间：约 3-4 天
完成 P0 + P1 模块：
ai-tools-fundamentals[P0]mcp-protocol[P1]ai-orchestration[P1]ai-resources-research[P1]practical-projects[P1]- 时间：约 3-4 周
完成所有 P0/P1/P2/P3 模块：
- 核心能力路径 +
agent-configuration[P2] +config-management[P2] +spec-driven-dev[P2] +mcp-advanced-config[P3] - 时间：约 5-7 周
ai-learning-template/
├── README.md # 本文件
├── PROGRESS.md # 学习进度总表（个人数据，.gitignore）
├── CLAUDE.md # AI 工作流程配置（命令定义）
├── TEMPLATE_GUIDE.md # 模板使用指南
├── CHANGELOG.md # 版本变更历史
├── MIGRATION_V3.md # v3.0.0 升级指南
│
├── .templates/ # 初始化模板目录（系统文件）
│ ├── PROGRESS.template.md # 进度文件模板
│ ├── KNOWLEDGE_CACHE.template.md
│ ├── LEARNING_BOOKMARKS.template.md
│ ├── module/ # 模块模板
│ │ ├── checklist.template.md
│ │ ├── notes.template.md
│ │ └── README.template.md # 新模块模板
│ └── modules/ # 课程内容模板（系统文件）
│ ├── 01-基础入门/
│ │ ├── README.md # 分类导学
│ │ ├── ai-tools-fundamentals/
│ │ │ ├── README.md
│ │ │ └── exercises/ # 练习文件模板
│ │ └── mcp-protocol/
│ │ └── README.md
│ ├── 02-进阶探索/
│ │ ├── README.md # 分类导学
│ │ ├── agent-configuration/
│ │ ├── mcp-advanced-config/
│ │ ├── ai-orchestration/
│ │ │ ├── README.md
│ │ │ └── exercises/ # 练习文件模板
│ │ └── ai-resources-research/
│ └── 03-实战应用/
│ ├── README.md # 分类导学
│ ├── config-management/
│ ├── spec-driven-dev/
│ └── practical-projects/
│ ├── README.md
│ └── feishu-learning-assistant/ # 实战项目模板
│
├── scripts/ # 自动化脚本（系统文件）
│ ├── init.sh # 初始化脚本（复制课程内容）
│ ├── migrate.sh # 版本迁移工具
│ └── backup.sh # 数据备份工具（可选）
│
├── .claude/ # 系统配置目录
│ ├── LEARNING_BOOKMARKS.md # 书签系统（个人数据，.gitignore）
│ ├── KNOWLEDGE_CACHE.md # 知识缓存系统状态（个人数据，.gitignore）
│ └── IDEAS.md # 改进想法记录
│
├── 01-基础入门/ # 用户目录（由 init.sh 创建）
│ ├── README.md # 阶段导学（从模板复制）
│ ├── ai-tools-fundamentals/ # AI 工具基础 [P0🔴]
│ └── mcp-protocol/ # MCP 协议入门 [P1🟡]
│
├── 02-进阶探索/ # 用户目录（由 init.sh 创建）
│ ├── README.md
│ ├── agent-configuration/ # Agent 配置与使用 [P2🟢]
│ ├── mcp-advanced-config/ # MCP 高级配置 [P3🔵]
│ ├── ai-orchestration/ # AI 编排平台 [P1🟡]
│ └── ai-resources-research/ # AI 资源研究 [P1🟡]
│
├── 03-实战应用/ # 用户目录（由 init.sh 创建）
│ ├── README.md
│ ├── config-management/ # 配置管理工具 [P2🟢]
│ ├── spec-driven-dev/ # 规范驱动开发 [P2🟢]
│ └── practical-projects/ # 综合实战项目 [P1🟡]
│
├── .backups/ # 备份目录（.gitignore）
│
└── memory/ # 长期记忆存储
└── MEMORY.md # 持久化记忆文件
架构说明：
- 系统内容：
.templates/modules/包含所有课程内容、练习文件、实战项目模板- 用户数据：
01-*/02-*/03-*/目录由init.sh创建，包含用户的个人进度和笔记- 数据隔离：用户可自由修改个人版本，同步上游时不会被覆盖
- everything-claude-code - Claude Code 全面资源集合
- OpenClaw - 本地优先 AI 助手平台
- cc-switch - CC 配置管理工具
- spec-kit - GitHub 规范工具包
💡 Agent Skills 平台指南: 如果你想了解全网 Agent Skills 发现和分享平台，查看 Agent Skills 平台指南，包含 10+ 主流平台详细评估。
本学习模板支持 自然语言 触发的进度管理命令：
| 命令 | 示例 | 说明 |
|---|---|---|
| 学习管理 | ||
| 开始学习 | "开始学习 mcp-protocol" | 启动模块学习，选择模式 |
| 更新进度 | "更新进度 ai-tools-fundamentals" | 根据清单自动计算进度 |
| 完成学习 | "完成学习 ai-tools-fundamentals" | 标记模块为已完成 |
| 查看状态 | "查看学习状态" | 显示所有模块进度概览 |
| 书签系统 | ||
| 创建书签 | "创建书签 深入理解钩子" | 记录疑问点，自动获取上下文 |
| 继续书签 | "继续书签" 或 "我的书签" | 查看书签列表，选择继续 |
| 完成书签 | "完成书签 钩子系统" | 完成探索，返回主线学习 |
| 知识缓存 | ||
| 初始化缓存 | "初始化知识缓存 mcp-protocol" | 首次拉取官方资料到本地 |
| 刷新缓存 | "刷新知识缓存" | 更新所有模块的缓存 |
| 查看缓存 | "查看知识缓存" | 显示缓存状态和日期 |
💡 所有命令都支持自然语言变体，例如"开始模块 mcp-protocol"、"我的书签有哪些"等
- 阅读本 README 了解整体规划
- 对 Claude 说 "查看学习状态" 查看当前进度
- 对 Claude 说 "开始学习 <模块名>" 启动模块
- 选择学习模式（快速/完整）
- 可选：对 Claude 说 "初始化知识缓存 <模块名>" 拉取官方资料
💾 什么是知识缓存？ 将官方文档下载到本地
knowledge/目录，提升学习速度。
- 首次：需要联网拉取（约 1-2 分钟）
- 之后：离线也能阅读，秒开速度
- 手动编辑
checklist.md勾选完成项 - 对 Claude 说 "更新进度 <模块名>" 同步进度
- 📚 快速模式：理论为主，约 30% 时间，适合快速了解
- 🛠️ 完整模式：理论+实践，完整学习体验，适合深入掌握
- 各模块的详细进度在对应模块的
checklist.md中 - 整体进度汇总在根目录的 PROGRESS.md 中
- 支持自然语言命令自动更新进度
学习过程中遇到疑问需要深入探索时：
📌 什么是书签系统？ 书签系统就像浏览器书签，但它记录的是"学习位置"。 当你想深入探索某个疑问时，创建书签；探索完成后，一键返回主线。
示例场景：
- 学习"钩子系统"时，想深入研究 Tool Use 机制
- 创建书签 → 深入探索 → 完成书签 → 自动返回"钩子系统"继续学习
使用流程：
- 对 Claude 说 "创建书签 <名称>"
- 系统自动获取当前模块和位置
- 描述你的疑问点
- 系统智能生成探索目标
- 开始探索（每次查询后 AI 会询问"还有其他疑问吗？"）
- 探索完成后，对 Claude 说 "完成书签 <名称>" 返回主线
探索笔记（可选）：
- 探索过程中说"记录一下"，可将探索结果保存到书签笔记
- 笔记保存在
.claude/LEARNING_BOOKMARKS.md
| 日期 | 模块 | 事件 | 备注 |
|---|---|---|---|
| 2026-02-26 | - | 初始化学习计划 | 创建目录结构和进度追踪系统 |
| 2026-02-27 | - | 学习系统改进 | 实施书签系统和知识缓存系统 |
| 2026-02-27 | - | 团队协作系统 | 实施 Fork + upstream 工作流和模板系统 |
| 2026-03-01 | ai-tools-fundamentals | 模块完成 | 🎉 ai-tools-fundamentals 模块 100% 完成！ |
| 2026-03-01 | - | 文件完整性检查 | 核对 CLAUDE.md 和项目文件完整性 |
| 2026-03-03 | - | 版本 1.3.0 | 学习计划同步功能 |
| 2026-03-03 | practical-projects | feishu-learning-assistant | 飞书学习助手实战项目 |
| 2026-03-05 | - | 版本 2.0.0 | 项目重新定位为"AI 技术学习模板" |
| 2026-03-09 | - | 版本 3.0.0 | 纯模板化架构 - 所有系统内容移入 .templates/modules/ |
创建于 2026-02-26 | 最后更新 2026-03-09