|
| 1 | +# Claude Code 学习计划项目 |
| 2 | + |
| 3 | +## 📋 项目概述 |
| 4 | + |
| 5 | +**项目名称**: Claude Code 完整学习计划 |
| 6 | +**项目类型**: 教育/学习资源 |
| 7 | +**目标用户**: 想要学习 Claude Code 的开发者 |
| 8 | +**当前版本**: v2.0 |
| 9 | +**维护状态**: 活跃维护中 |
| 10 | + |
| 11 | +## 🎯 项目目标 |
| 12 | + |
| 13 | +这是一个完整的 Claude Code 学习计划,帮助开发者从零开始,系统掌握 Claude Code 的所有功能和最佳实践。 |
| 14 | + |
| 15 | +### 核心价值 |
| 16 | +- 📚 **系统化学习路径** - 7个模块,从基础到高级 |
| 17 | +- 💪 **实践导向** - 大量练习和实战项目 |
| 18 | +- 🆘 **完整支持** - 故障排查和最佳实践指南 |
| 19 | +- 🎓 **渐进式学习** - 三级难度设计(基础→进阶→挑战) |
| 20 | + |
| 21 | +## 🏗️ 项目结构 |
| 22 | + |
| 23 | +``` |
| 24 | +claude-code-learning/ |
| 25 | +├── README.md # 项目总览和快速开始 |
| 26 | +├── LEARNING_PLAN.md # 详细的7模块学习计划 |
| 27 | +├── QUICK_START.md # 30分钟快速入门 |
| 28 | +├── ASSESSMENT.md # 学习评估体系 |
| 29 | +├── TROUBLESHOOTING.md # 故障排查指南(15+问题) |
| 30 | +├── .claude/ # Claude Code 配置 |
| 31 | +│ └── CLAUDE.md # 本文件 - 项目上下文 |
| 32 | +│ |
| 33 | +├── module-1/ # 基础认知 |
| 34 | +├── module-2/ # 核心工具与工作流 |
| 35 | +├── module-3/ # Git 集成与版本控制 |
| 36 | +├── module-4/ # 自定义扩展 I - Slash Commands |
| 37 | +├── module-5/ # 自定义扩展 II - Hooks 与自动化 |
| 38 | +├── module-6/ # 外部集成 - MCP 与 Sub-Agents |
| 39 | +├── module-7/ # 综合实战项目 |
| 40 | +│ |
| 41 | +└── projects/ # 实战项目目录 |
| 42 | +``` |
| 43 | + |
| 44 | +## 🛠️ 技术栈 |
| 45 | + |
| 46 | +### 主要技术 |
| 47 | +- **文档格式**: Markdown |
| 48 | +- **代码示例**: JavaScript/Node.js (主要) |
| 49 | +- **练习语言**: JavaScript, Python, Shell |
| 50 | +- **工具**: Git, npm, Claude Code |
| 51 | + |
| 52 | +### 依赖 |
| 53 | +- Node.js >= 18 |
| 54 | +- Claude Code CLI |
| 55 | +- Git |
| 56 | +- 可选: gh (GitHub CLI) |
| 57 | + |
| 58 | +## 📖 模块详解 |
| 59 | + |
| 60 | +### 模块 1: Claude Code 基础认知 |
| 61 | +- **位置**: `module-1/` |
| 62 | +- **内容**: 安装、配置、基本交互 |
| 63 | +- **练习**: buggy-code.js 调试 |
| 64 | +- **难度**: ⭐ 入门 |
| 65 | + |
| 66 | +### 模块 2: 核心工具与工作流 |
| 67 | +- **位置**: `module-2/` |
| 68 | +- **内容**: Read, Write, Edit, Glob, Grep, Bash |
| 69 | +- **练习**: shopping-cart.js 重构 |
| 70 | +- **难度**: ⭐⭐ 初级 |
| 71 | + |
| 72 | +### 模块 3: Git 集成与版本控制 |
| 73 | +- **位置**: `module-3/` |
| 74 | +- **内容**: Git 操作、提交、PR、冲突解决 |
| 75 | +- **练习**: 5大练习系列 + 冲突实战 |
| 76 | +- **难度**: ⭐⭐⭐ 中级 |
| 77 | + |
| 78 | +### 模块 4-7: 高级特性和实战 |
| 79 | +- **内容**: Slash Commands, Hooks, MCP, Sub-Agents, 实战项目 |
| 80 | +- **状态**: 框架已建立,内容持续完善中 |
| 81 | +- **难度**: ⭐⭐⭐⭐ 高级 |
| 82 | + |
| 83 | +## 🎨 编码规范 |
| 84 | + |
| 85 | +### 文档规范 |
| 86 | +- 使用 Markdown 格式 |
| 87 | +- 标题层级清晰(H1-H4) |
| 88 | +- 代码块使用语法高亮 |
| 89 | +- 包含示例和验证清单 |
| 90 | + |
| 91 | +### 练习设计规范 |
| 92 | +每个练习应包含: |
| 93 | +1. **目标** - 学习目标明确 |
| 94 | +2. **场景** - 真实使用场景 |
| 95 | +3. **步骤** - 详细操作步骤 |
| 96 | +4. **提示词** - 可复用的提示词模板 |
| 97 | +5. **验证** - 检查清单 |
| 98 | + |
| 99 | +### 提示词模板规范 |
| 100 | +```markdown |
| 101 | +**提示词**: |
| 102 | +``` |
| 103 | +[清晰的任务描述] |
| 104 | +- 具体要求 1 |
| 105 | +- 具体要求 2 |
| 106 | +- 预期输出格式 |
| 107 | +``` |
| 108 | +``` |
| 109 | + |
| 110 | +## 🔧 常用命令 |
| 111 | + |
| 112 | +### 项目导航 |
| 113 | +```bash |
| 114 | +# 查看项目概览 |
| 115 | +cat README.md |
| 116 | + |
| 117 | +# 查看学习计划 |
| 118 | +cat LEARNING_PLAN.md |
| 119 | + |
| 120 | +# 快速开始 |
| 121 | +cat QUICK_START.md |
| 122 | + |
| 123 | +# 故障排查 |
| 124 | +cat TROUBLESHOOTING.md |
| 125 | +``` |
| 126 | + |
| 127 | +### 学习流程 |
| 128 | +```bash |
| 129 | +# 开始模块 1 |
| 130 | +cd module-1 |
| 131 | +cat README.md |
| 132 | + |
| 133 | +# 查看练习 |
| 134 | +cat CHECKLIST.md # 或 TASKS.md, EXERCISES.md |
| 135 | + |
| 136 | +# 进入下一模块 |
| 137 | +cd ../module-2 |
| 138 | +``` |
| 139 | + |
| 140 | +## 🤝 与 Claude Code 交互指南 |
| 141 | + |
| 142 | +### 项目相关任务 |
| 143 | + |
| 144 | +#### 查看和导航 |
| 145 | +``` |
| 146 | +"显示这个学习计划的整体结构" |
| 147 | +"我在哪个模块?下一步学什么?" |
| 148 | +"列出模块 3 的所有练习" |
| 149 | +``` |
| 150 | + |
| 151 | +#### 学习支持 |
| 152 | +``` |
| 153 | +"我在做模块 2 的重构练习,遇到了 [问题]" |
| 154 | +"解释一下模块 3 中 Git 冲突解决的步骤" |
| 155 | +"帮我检查模块 1 的检查清单,我完成了哪些?" |
| 156 | +``` |
| 157 | + |
| 158 | +#### 练习辅助 |
| 159 | +``` |
| 160 | +"我要开始 module-3/conflict-practice 练习,指导我" |
| 161 | +"帮我解决 buggy-code.js 中的问题" |
| 162 | +"为 shopping-cart.js 提供重构建议" |
| 163 | +``` |
| 164 | + |
| 165 | +#### 内容改进 |
| 166 | +``` |
| 167 | +"为模块 4 创建一个 Slash Command 练习" |
| 168 | +"添加一个关于 [主题] 的常见问题到 TROUBLESHOOTING.md" |
| 169 | +"改进模块 2 的练习,添加难度梯度" |
| 170 | +``` |
| 171 | + |
| 172 | +### 最佳实践 |
| 173 | + |
| 174 | +#### ✅ 好的提示词 |
| 175 | +``` |
| 176 | +"我在学习模块 3 的 Git 集成。 |
| 177 | +当前进度:已完成基础 Git 操作练习。 |
| 178 | +问题:在合并分支时遇到冲突,conflict-practice/config.js。 |
| 179 | +需要:解释冲突标记的含义,并帮我解决。" |
| 180 | +``` |
| 181 | + |
| 182 | +#### ❌ 避免的提示词 |
| 183 | +``` |
| 184 | +"帮我" # 太模糊 |
| 185 | +"这个不工作" # 没有上下文 |
| 186 | +"讲讲 Claude Code" # 与学习计划无关 |
| 187 | +``` |
| 188 | + |
| 189 | +## 📝 内容更新规范 |
| 190 | + |
| 191 | +### 添加新练习 |
| 192 | +1. 创建练习文件(.js, .md 等) |
| 193 | +2. 在模块 README.md 中添加说明 |
| 194 | +3. 更新检查清单 |
| 195 | +4. 提供提示词模板 |
| 196 | + |
| 197 | +### 添加新模块 |
| 198 | +1. 创建 `module-X/` 目录 |
| 199 | +2. 添加 `README.md`(学习内容) |
| 200 | +3. 添加 `EXERCISES.md` 或 `TASKS.md`(练习) |
| 201 | +4. 创建练习文件和示例 |
| 202 | +5. 更新 `LEARNING_PLAN.md` |
| 203 | + |
| 204 | +### 修复问题 |
| 205 | +1. 在 TROUBLESHOOTING.md 中记录 |
| 206 | +2. 提供诊断步骤 |
| 207 | +3. 给出解决方案 |
| 208 | +4. 添加预防建议 |
| 209 | + |
| 210 | +## 🚨 重要注意事项 |
| 211 | + |
| 212 | +### 项目维护原则 |
| 213 | +1. **向后兼容** - 不破坏已有学习者的进度 |
| 214 | +2. **渐进增强** - 逐步添加新内容 |
| 215 | +3. **质量优先** - 宁缺毋滥 |
| 216 | +4. **用户导向** - 基于实际学习需求 |
| 217 | + |
| 218 | +### 文件操作规范 |
| 219 | +- ❌ 不要删除已有的练习文件 |
| 220 | +- ✅ 可以扩展和改进现有内容 |
| 221 | +- ✅ 添加新文件时保持目录结构清晰 |
| 222 | +- ✅ 大改动前先备份(如 module-X-old) |
| 223 | + |
| 224 | +### 学习者支持 |
| 225 | +- 优先解决学习中的实际问题 |
| 226 | +- 提供多种难度的练习选项 |
| 227 | +- 给出清晰的错误诊断步骤 |
| 228 | +- 包含可复用的提示词模板 |
| 229 | + |
| 230 | +## 📊 项目状态 |
| 231 | + |
| 232 | +### 当前进度 |
| 233 | +- ✅ 模块 1-3: 完整(文档 + 练习) |
| 234 | +- ⏸️ 模块 4-7: 框架已建立,内容待完善 |
| 235 | +- ✅ 核心文档: 全部完成 |
| 236 | +- ✅ 故障排查: 15+ 问题覆盖 |
| 237 | + |
| 238 | +### 质量指标 |
| 239 | +- **文档完整性**: 9/10 |
| 240 | +- **练习丰富度**: 8/10 |
| 241 | +- **问题支持**: 9/10 |
| 242 | +- **总体评分**: 9/10 |
| 243 | + |
| 244 | +### 近期计划 |
| 245 | +1. 完善模块 4-7 的详细内容 |
| 246 | +2. 添加更多实战项目 |
| 247 | +3. 建立练习答案库 |
| 248 | +4. 收集用户反馈 |
| 249 | + |
| 250 | +## 🔗 相关资源 |
| 251 | + |
| 252 | +### 官方文档 |
| 253 | +- [Claude Code 官方文档](https://docs.claude.com/en/docs/claude-code/) |
| 254 | +- [GitHub Discussions](https://github.com/anthropics/claude-code/discussions) |
| 255 | +- [GitHub Issues](https://github.com/anthropics/claude-code/issues) |
| 256 | + |
| 257 | +### 项目内部链接 |
| 258 | +- 快速开始: `QUICK_START.md` |
| 259 | +- 学习计划: `LEARNING_PLAN.md` |
| 260 | +- 故障排查: `TROUBLESHOOTING.md` |
| 261 | +- 评估体系: `ASSESSMENT.md` |
| 262 | + |
| 263 | +## 💡 使用提示 |
| 264 | + |
| 265 | +### 对于学习者 |
| 266 | +1. 从 `README.md` 开始了解项目 |
| 267 | +2. 选择适合自己的学习路径 |
| 268 | +3. 按模块顺序学习(建议) |
| 269 | +4. 完成每个模块的练习 |
| 270 | +5. 遇到问题查 `TROUBLESHOOTING.md` |
| 271 | + |
| 272 | +### 对于贡献者 |
| 273 | +1. 阅读本文档了解项目结构 |
| 274 | +2. 遵循编码规范和更新规范 |
| 275 | +3. 提供高质量的练习和文档 |
| 276 | +4. 测试所有改动 |
| 277 | +5. 更新相关的检查清单 |
| 278 | + |
| 279 | +## 🎯 Claude Code 交互示例 |
| 280 | + |
| 281 | +### 场景 1: 开始新模块 |
| 282 | +``` |
| 283 | +用户: "我要开始学习模块 2" |
| 284 | +Claude: [读取 module-2/README.md,总结学习内容,列出练习] |
| 285 | +``` |
| 286 | + |
| 287 | +### 场景 2: 练习求助 |
| 288 | +``` |
| 289 | +用户: "我在做 shopping-cart.js 重构,不知道如何提取重复代码" |
| 290 | +Claude: [读取文件,分析重复代码,提供重构建议和代码示例] |
| 291 | +``` |
| 292 | + |
| 293 | +### 场景 3: 问题排查 |
| 294 | +``` |
| 295 | +用户: "Git 提交失败,提示权限错误" |
| 296 | +Claude: [查看 TROUBLESHOOTING.md,定位到问题 3-4,提供诊断步骤] |
| 297 | +``` |
| 298 | + |
| 299 | +### 场景 4: 进度追踪 |
| 300 | +``` |
| 301 | +用户: "检查我的学习进度" |
| 302 | +Claude: [查看各模块的 CHECKLIST,总结完成情况,建议下一步] |
| 303 | +``` |
| 304 | + |
| 305 | +## ✨ 特殊标记说明 |
| 306 | + |
| 307 | +### 文档中的符号 |
| 308 | +- ✅ 已完成 |
| 309 | +- ⏸️ 进行中/待完善 |
| 310 | +- ❌ 不推荐/错误示例 |
| 311 | +- ⭐ 重要/新增 |
| 312 | +- 📦 已备份 |
| 313 | +- 🚀 快速开始 |
| 314 | +- 💡 提示 |
| 315 | +- ⚠️ 注意事项 |
| 316 | + |
| 317 | +### 难度标记 |
| 318 | +- ⭐ 入门级 |
| 319 | +- ⭐⭐ 初级 |
| 320 | +- ⭐⭐⭐ 中级 |
| 321 | +- ⭐⭐⭐⭐ 高级 |
| 322 | +- ⭐⭐⭐⭐⭐ 专家级 |
| 323 | + |
| 324 | +## 📞 反馈和支持 |
| 325 | + |
| 326 | +### 遇到问题? |
| 327 | +1. 查看 `TROUBLESHOOTING.md` |
| 328 | +2. 搜索 GitHub Issues |
| 329 | +3. 在 Discussions 提问 |
| 330 | +4. 联系维护者 |
| 331 | + |
| 332 | +### 有建议? |
| 333 | +1. 在项目 Issues 提交 |
| 334 | +2. 说明具体的改进点 |
| 335 | +3. 提供示例(如适用) |
| 336 | + |
| 337 | +--- |
| 338 | + |
| 339 | +**记住**: 这个项目的目标是帮助每个人都能轻松学习 Claude Code! |
| 340 | + |
| 341 | +保持内容清晰、实用、易懂!🚀 |
0 commit comments