# AI Coding Lab

从零开始，用 AI 学编程、做 AI 应用。每个项目都是一次完整的实战。

> [English Version](./README.en.md)

## 这是什么

AI Coding Lab 是一个 AI 实战教程合集，涵盖 **AI 编程** 和 **AI 应用开发** 两大方向。每个项目从「零基础」到「可上线」，全程用 AI 辅助完成。不教语法，不讲理论——只做项目，在实战中学会跟 AI 协作。

## 项目列表

### AI 编程

用 AI 辅助编写代码，学习软件开发。

#### Vibe Coding（氛围编程）

用自然语言描述需求，让 AI 直接生成代码。适合零基础入门。

| # | 项目 | 难度 | 你将做出什么 |
|---|------|------|-------------|
| 1 | [个人链接页](./vibe-coding/bio-link-page/) | ⭐ 入门 | 一个类似 Linktree 的个人主页，10 分钟完成 |
| 2 | [个人博客](./vibe-coding/nextjs-blog/) | ⭐⭐ 初级 | 一个全栈博客系统，支持文章管理、分类标签、评论 |
| 3 | [个人博客（评论系统）](./vibe-coding/nextjs-blog-comment/) | ⭐⭐ 初级 | 在博客基础上增加嵌套评论回复功能 |
| 4 | [FlowBoard 看板](./vibe-coding/flow-board/) | ⭐⭐⭐ 进阶 | 个人 Kanban 看板，支持拖拽排序、多看板、标签、Checklist、搜索过滤、归档、快捷键 |

#### Skills（技能定制）

给 AI 写 SOP，让它按你的标准做事。写一次规范，无限复用。

| # | 项目 | 难度 | 你将做出什么 |
|---|------|------|-------------|
| 1 | [Claude Skills 实战](./skills/) | ⭐⭐ 初级 | 3 个实用 Skill（博客生成器、Commit 规范、发票生成器）+ API 调用 Demo |

### AI 应用

动手构建 RAG、Chatbot、Agent 等 AI 应用，掌握主流 AI 开发模式。

#### RAG

检索增强生成（RAG）实战项目。

| # | 项目 | 难度 | 你将做出什么 |
|---|------|------|-------------|
| 1 | [员工手册问答机器人](./rag/ask-book/) | ⭐⭐⭐ 进阶 | 一个 RAG 聊天机器人，上传 PDF 即可问答 |

#### Chatbot

AI 聊天机器人实战项目。

| # | 项目 | 难度 | 你将做出什么 |
|---|------|------|-------------|
| 1 | [Mnemo 记忆聊天助手](./chatbot/mnemo/) | ⭐⭐⭐⭐ 高级 | 一个带长期记忆的 AI 聊天助手，支持文档上传、语义检索、双轨记忆提取 |

#### Agent

AI Agent 实战项目。

| # | 项目 | 难度 | 你将做出什么 |
|---|------|------|-------------|
| 1 | [仓库分析器](./agent/repo-analyzer/) | ⭐⭐⭐ 进阶 | 一个分析代码仓库的 AI Agent |
| 2 | [JobSpy 求职分析助手](./agent/job-spy/) | ⭐⭐⭐ 进阶 | AI 解析 JD + 匹配简历，链式分析 vs 单次分析对比，输出求职策略 |
| 3 | [ResearchHub 多源调研助手](./agent/research-hub/) | ⭐⭐⭐ 进阶 | AI 四路并行调研，输入公司名即出分析报告（并行化模式实战） |
| 4 | [Agent 编排模式实战](./agent/mastra-orchestration/) | ⭐⭐⭐⭐ 高级 | 用 Mastra 实现 4 种 Agent 编排模式（Supervisor / Workflow / Handoff / Council）+ 混合编排，配套 React Flow 可视化 |

## 适合谁

- **完全零基础**：不懂代码也能跟着做，从 Vibe Coding 开始
- **有一定基础**：想学习如何用 AI 提升开发效率
- **对 AI 编程好奇**：想知道「AI 写代码」到底靠不靠谱
- **想做 AI 应用**：想动手构建 RAG、Chatbot、Agent 等 AI 产品

## 如何使用

1. 选一个感兴趣的项目
2. 打开项目文件夹里的 README
3. 跟着步骤做

每个项目都是独立的，不需要按顺序来。

## 推荐工具

| 工具 | 说明 | 适合场景 |
|------|------|---------|
| [Claude Code](https://claude.ai/claude-code) | AI 命令行编程助手 | 全场景适用，高效协作 |

## 许可证

MIT

---

*如果觉得有帮助，欢迎 Star 和分享！有问题请在 [Issues](https://github.com/luzhenqian/ai-coding-lab/issues) 中提出。*
