# AI Coding Lab

**Repository Path**: xiaoshen666/ai-coding-lab

## Basic Information

- **Project Name**: AI Coding Lab
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-19
- **Last Updated**: 2026-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Coding Lab

> 从零开始，用 AI 学编程、做 AI 应用。每个项目都是一次从零基础到可上线的完整实战，全程借助 AI 辅助完成。

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

---

## 项目简介

AI Coding Lab（人工智能编程实验室）是一个开源的 AI 辅助编程实战教程集合，涵盖 **AI 编程**（用 AI 辅助编写代码）和 **AI 应用开发**（动手构建 RAG、聊天机器人、Agent 等）两大方向。不教语法，不讲理论——只做项目，在实战中学会跟 AI 协作。

每个子项目均独立运行，拥有各自的 `package.json` 和构建配置，无需顺序依赖。

---

## 技术栈

| 类别 | 技术 |
|------|------|
| **前端框架** | Next.js 15/16（App Router）、React 18/19、Vite |
| **样式** | Tailwind CSS v4、shadcn/ui v4、Lucide React |
| **AI/LLM SDK** | Vercel AI SDK v6、Anthropic/OpenAI SDK、Mastra Agent 框架 |
| **数据库/ORM** | PostgreSQL（+pgvector）、SQLite、Prisma、Drizzle ORM |
| **语言** | TypeScript（严格模式）、Node.js 20+ |
| **包管理** | npm、pnpm |

---

## 项目列表

### AI 编程

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

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

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

| # | 项目 | 难度 | 你将做出什么 |
|---|------|------|-------------|
| 1 | [个人链接页](./vibe-coding/bio-link-page/) | ⭐ 入门 | 类似 Linktree 的个人主页，10 分钟完成 |
| 2 | [个人博客](./vibe-coding/nextjs-blog/) | ⭐⭐ 初级 | 全栈博客系统：文章管理、分类标签、评论、Markdown 编辑 |
| 3 | [个人博客（评论系统）](./vibe-coding/nextjs-blog-comment/) | ⭐⭐ 初级 | 扩展嵌套评论回复，含 OpenSpec 规格驱动开发工作流 |
| 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 即可问答，支持 pgvector 向量检索 |

#### Chatbot

AI 聊天机器人实战项目。

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

#### Agent

AI Agent 实战项目。

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

---

## 创作工具

| 项目 | 说明 |
|------|------|
| [cover-generator](./creative/cover-generator/) | Vite + React 封面生成器，为视频系列生成统一风格封面（720p~5K 导出） |
| [motion-canvas-videos](./creative/motion-canvas-videos/) | Motion Canvas 动画讲解视频（Agent 编排模式等） |

---

## 设计理念

- **规格驱动开发（SDD）**：使用 OpenSpec/SpecKit 工具链进行 AI 编码规范约束，让 AI 输出更可控
- **AI First 工作流**：深度集成 Claude Code，针对 AI 辅助开发设计工作流程
- **渐进式难度**：项目按 ⭐1~4 标注，从"10 分钟搭建"到"多 Agent 编排"，学习路径清晰
- **实测可运行**：每个项目均配有完整代码和 README 指引

---

## 适合谁

- **完全零基础**：不懂代码也能跟着做，从 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) 中提出。*