模块 7：综合实战项目

📋 学习目标

✅ 应用所有 Claude Code 技能
✅ 完成端到端的实战项目
✅ 掌握完整的开发工作流
✅ 培养最佳实践习惯

🎯 模块概述

这是学习计划的最终模块，你将：

整合前6个模块的所有知识
完成3个难度递增的实战项目
建立自己的 Claude Code 工作流
达到独立使用 Claude Code 的水平

📚 前置知识检查

在开始实战前，确保你掌握：

✅ 必需技能

模块 1：理解 Claude Code 基本概念
模块 2：熟练使用 Read、Write、Edit、Glob、Grep、Bash
模块 3：掌握 Git 操作和 PR 流程
模块 4：能创建自定义 Slash Commands
模块 5：能配置和使用 Hooks
模块 6：了解 MCP 和 Sub-Agents

💡 推荐回顾

如果有不确定的地方，回顾相应模块：

# 快速回顾
cd module-X
cat README.md

🏗️ 项目 1：博客系统（初级实战）

项目概述

目标：使用 Claude Code 从零构建一个完整的博客系统

技术栈：

Node.js + Express
React (前端)
SQLite (数据库)
Jest (测试)

项目时长：4-6 小时

项目需求

功能需求：

用户认证（注册、登录）
文章管理（CRUD）
评论系统
标签分类
搜索功能

技术要求：

RESTful API 设计
输入验证和错误处理
单元测试覆盖率 > 80%
清晰的代码结构
完整的 API 文档

项目步骤

第一阶段：项目初始化（30分钟）

任务：

创建一个完整的 Node.js + React 博客项目：

项目结构：
backend/
  ├── src/
  │   ├── routes/
  │   ├── controllers/
  │   ├── models/
  │   └── middleware/
  ├── tests/
  └── package.json

frontend/
  ├── src/
  │   ├── components/
  │   ├── pages/
  │   └── api/
  └── package.json

要求：
- 配置 ESLint 和 Prettier
- 设置 Jest 测试环境
- 创建 .gitignore
- 初始化 Git 仓库

使用的技能：

Write 工具创建文件
Bash 执行 npm init
Git 初始化

自定义命令：

# 创建 .claude/commands/init-project.md
/init-project name=blog-system

第二阶段：后端 API 开发（2小时）

任务 2.1：用户认证

实现用户认证系统：

包含：
1. 用户注册 API (POST /api/auth/register)
   - 输入验证（email、密码强度）
   - 密码加密（bcrypt）
   - JWT token 生成

2. 用户登录 API (POST /api/auth/login)
   - 凭证验证
   - token 返回

3. 认证中间件
   - JWT 验证
   - 用户身份附加到 req.user

4. 单元测试
   - 所有 API 端点
   - 边界条件
   - 错误处理

任务 2.2：文章管理

实现文章 CRUD API：

1. 创建文章 (POST /api/posts)
2. 获取文章列表 (GET /api/posts)
   - 分页支持
   - 标签过滤
3. 获取单篇文章 (GET /api/posts/:id)
4. 更新文章 (PUT /api/posts/:id)
5. 删除文章 (DELETE /api/posts/:id)

要求：
- 权限验证（只能操作自己的文章）
- 完整的错误处理
- 单元测试

使用的技能：

Read 查看相关文件
Edit 修改代码
Bash 运行测试
自定义 /test 命令生成测试

第三阶段：前端开发（2小时）

任务 3.1：基础组件

创建 React 组件：

1. AuthForm 组件（登录/注册表单）
2. PostList 组件（文章列表）
3. PostDetail 组件（文章详情）
4. PostEditor 组件（文章编辑器）
5. CommentList 组件（评论列表）

要求：
- 使用 React Hooks
- PropTypes 类型检查
- 响应式设计
- 组件测试

使用的技能：

自定义 /component 命令
Glob 查找相似组件参考
Sub-Agents 并行创建多个组件

第四阶段：集成与部署（1小时）

任务 4.1：集成测试

创建端到端测试：

测试场景：
1. 用户注册 → 登录 → 创建文章 → 发表评论
2. 搜索文章 → 查看详情 → 编辑 → 删除
3. 标签过滤 → 分页浏览

使用工具：
- Cypress 或 Playwright
- 测试覆盖率报告

任务 4.2：部署准备

准备生产部署：

1. 环境变量配置
2. 数据库迁移脚本
3. Docker 配置（可选）
4. CI/CD 配置
5. README 和文档

使用的技能：

Hooks 配置部署前检查
GitHub MCP 创建仓库和 PR
自定义 /deploy-check 命令

第五阶段：代码审查与优化（30分钟）

任务：

使用 Claude Code 审查整个项目：

检查：
1. 代码质量和规范
2. 安全隐患
3. 性能瓶颈
4. 测试覆盖率
5. 文档完整性

生成：
- 代码审查报告
- 改进建议清单
- 重构计划

使用的技能：

Sub-Agents 并行审查各模块
自定义 /review 系列命令
生成完整的报告

项目交付

提交内容：

评分标准：

项目	权重	评分要点
功能完整性	30%	所有需求实现
代码质量	25%	规范、清晰、可维护
测试覆盖	20%	单元测试和集成测试
文档完整	15%	README、API 文档
工作流	10%	Git 提交、PR 规范

🚀 项目 2：任务管理工具（中级实战）

项目概述

目标：构建一个类似 Trello 的任务管理工具

技术栈：

TypeScript
Next.js
PostgreSQL
Prisma ORM
TailwindCSS

项目时长：6-8 小时

核心特性

功能需求：

工作空间管理
看板和列表
任务卡片（拖拽排序）
团队协作
实时更新
文件附件
活动日志

高级特性：

WebSocket 实时通信
文件上传（S3 或本地）
富文本编辑器
搜索和过滤
数据导出

项目要点

使用 Claude Code 的高级技能：

使用 MCP 集成
- GitHub MCP：项目管理
- Database MCP：查询优化
使用 Sub-Agents
- 并行开发多个功能模块
- 大型重构任务
完整的工作流
- Slash Commands：快速生成组件
- Hooks：自动化质量检查
- Git 工作流：功能分支开发

实战技巧

技巧 1：使用 Sub-Agent 并行开发

启动 3 个 Sub-Agents 并行开发：

Agent 1: 开发工作空间模块
Agent 2: 开发看板模块
Agent 3: 开发任务卡片模块

每个 Agent：
1. 设计数据模型
2. 实现 API
3. 创建前端组件
4. 编写测试

最后合并所有结果

技巧 2：使用 Hooks 确保质量

{
  "hooks": {
    "user-prompt-submit-hook": {
      "command": "bash .claude/hooks/comprehensive-check.sh",
      "blocking": true
    }
  }
}

技巧 3：自定义项目命令

/feature name=workspace           # 创建完整功能模块
/api-endpoint method=POST path=/workspaces
/component type=page name=Dashboard

🎯 项目 3：开源贡献（高级实战）

项目概述

目标：为真实的开源项目贡献代码

方式：

选择感兴趣的开源项目
找到适合的 issue
提交高质量的 PR

项目时长：8-12 小时

项目步骤

第一步：选择项目和 Issue

使用 GitHub MCP：

使用 GitHub MCP：

1. 搜索感兴趣的项目
   - 活跃度高
   - 有 "good first issue" 标签
   - 技术栈匹配

2. 分析项目：
   - 代码结构
   - 贡献指南
   - 代码规范
   - 测试要求

3. 选择 Issue：
   - 难度适中
   - 说明清晰
   - 没有被认领

第二步：理解项目

使用 Sub-Agents 分析：

使用 Sub-Agent 深度分析项目：

1. 项目架构分析
2. 相关模块定位
3. 依赖关系梳理
4. 测试策略了解
5. 贡献流程学习

生成：
- 项目理解文档
- 改动计划
- 测试计划

第三步：实现功能

完整工作流：

1. Fork 项目
2. 创建功能分支
3. 实现功能
   - 遵循项目规范
   - 编写测试
   - 更新文档
4. 自我审查
5. 提交 PR
6. 响应审查意见

第四步：PR 质量保证

使用所有 Claude Code 技能：

PR 提交前检查清单：

✅ 代码质量
  - 运行项目 lint
  - 通过所有测试
  - 代码审查通过

✅ 文档更新
  - README 更新
  - CHANGELOG 更新
  - 代码注释完整

✅ 测试充分
  - 单元测试
  - 集成测试
  - 边界条件

✅ PR 描述清晰
  - 问题描述
  - 解决方案
  - 测试说明
  - 截图或演示

使用 Hook 自动检查所有项

成功标准

PR 被接受的关键：

解决实际问题
代码质量高
测试完整
文档清晰
沟通专业
响应及时

📊 模块总测试

测试方式

完成至少一个实战项目，提交：

完整的项目代码
Git 提交历史
测试报告
项目复盘文档

评分标准

项目 1（博客系统）：

基础分：60分（功能完成）
质量分：20分（代码质量）
进阶分：20分（测试和文档）

项目 2（任务管理）：

基础分：55分
质量分：25分
进阶分：20分

项目 3（开源贡献）：

PR 提交：60分
PR 被接受：80分
PR 合并：100分

🎓 学习成果

完成本模块后，你应该能够：

✅ 独立使用 Claude Code

快速启动新项目
高效开发功能
自动化质量保证
规范的 Git 工作流

✅ 建立个人工作流

自定义 Slash Commands 库
配置 Hooks 自动化
MCP 服务器集成
Sub-Agents 使用策略

✅ 提高开发效率

减少重复工作
代码质量提升
开发速度加快
减少低级错误

💡 项目复盘

复盘模板

完成项目后，写一份复盘：

# 项目复盘：[项目名称]

## 项目概况
- 项目：
- 时长：
- 技术栈：

## Claude Code 使用情况

### 最有用的功能
1. [功能名称]
   - 使用场景：
   - 效果：
   - 改进空间：

### 遇到的挑战
1. [挑战描述]
   - 解决方案：
   - 经验教训：

### 工作流优化
- 使用的自定义命令：
- Hooks 配置：
- MCP 集成：

## 学习收获
- 技术收获：
- 工作流改进：
- Claude Code 技巧：

## 下一步计划
- 改进点：
- 新技能学习：

🎯 毕业项目

终极挑战

任务：创建你自己的"梦想项目"

要求：

自选技术栈
完整的开发周期
全面应用 Claude Code 技能
开源并分享

示例项目方向：

个人工具（笔记、任务管理）
开发者工具（CLI 工具、插件）
学习项目（教程、demo）
创意项目（游戏、艺术）

展示你的项目

完成后，可以：

GitHub 开源
写博客分享
社区展示
参加 Hackathon

🏆 恭喜完成！

你已经完成了 Claude Code 完整学习计划！

你现在具备：

✅ Claude Code 所有核心技能
✅ 实战项目经验
✅ 高效的开发工作流
✅ 持续学习的能力

继续成长：

深化技能
- 探索更多 MCP 服务器
- 创建高级自动化
- 贡献开源项目
分享经验
- 写博客和教程
- 帮助其他学习者
- 参与社区讨论
保持更新
- 关注 Claude Code 更新
- 学习新特性
- 优化工作流

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

模块 7：综合实战项目

📋 学习目标

🎯 模块概述

📚 前置知识检查

✅ 必需技能

💡 推荐回顾

🏗️ 项目 1：博客系统（初级实战）

项目概述

项目需求

项目步骤

第一阶段：项目初始化（30分钟）

第二阶段：后端 API 开发（2小时）

第三阶段：前端开发（2小时）

第四阶段：集成与部署（1小时）

第五阶段：代码审查与优化（30分钟）

项目交付

🚀 项目 2：任务管理工具（中级实战）

项目概述

核心特性

项目要点

实战技巧

🎯 项目 3：开源贡献（高级实战）

项目概述

项目步骤

第一步：选择项目和 Issue

第二步：理解项目

第三步：实现功能

第四步：PR 质量保证

成功标准

📊 模块总测试

测试方式

评分标准

🎓 学习成果

✅ 独立使用 Claude Code

✅ 建立个人工作流

✅ 提高开发效率

💡 项目复盘

复盘模板

🎯 毕业项目

终极挑战

展示你的项目

🏆 恭喜完成！

你现在具备：

继续成长：

📚 下一步资源

官方资源

社区资源

继续学习