# Next.js 管理后台 & AI 智能抽背助手开发项目 🚀

**Web 应用类 AI 助手开发仓库** - 包含完整的配置、技能和文档，开箱即用！

## 🎯 项目定位

这是一个 **AI 助手开发项目仓库**，当前主要项目：

1. **AI 智能抽背助手 Web 应用**（模板 244）- 工作空间 226 🆕

---

## 📊 当前项目进展

### 🎯 AI 智能抽背助手（主项目 - 2026-03-28）

**状态**: 🔄 BMAD PRD 流程进行中

**工作空间**: 226
**模板**: 244
**容器配置**: 8v16G (PostgreSQL + Redis + MinIO)

#### 已完成 ✅
- [x] 工作空间和模板创建
- [x] 开发容器配置和启动
- [x] BMAD 工作流安装
- [x] 需求文档编写（1092行，包含10个界面详细UI分析）
- [x] 需求文档传输到容器
- [x] UI 设计分析完成（第一组4个界面 + 第二组6个界面）
- [x] 模板概述文档创建（template-244-overview.md）

#### 进行中 🔄
- [ ] **BMAD PRD 流程** - 产品经理（John）正在创建 PRD
  - 已完成：执行摘要、成功标准、用户旅程映射
  - 下一步：领域需求分析

#### 待开始 📋
- [ ] 技术架构设计
- [ ] 数据库设计
- [ ] 前端开发环境搭建
- [ ] 后端 API 开发
- [ ] AI 模型集成

**详细文档**:
- 需求文档: [docs/ai-tutor-requirements.md](docs/ai-tutor-requirements.md)
- 模板概述: [docs/template-244-overview.md](docs/template-244-overview.md)

---

## ✨ 模板特性

### 📦 开箱即用

- ✅ **完整的 CLAUDE.md 配置** - D8D MCP 工具、BMAD 工作流、技能系统
- ✅ **9 个精选开发技能** - 文档处理、AI 助手、开发工具
- ✅ **模板概述文档** - 完整的项目说明和使用指南
- ✅ **Git 仓库配置** - .gitignore、提交规范

### 🎓 技能系统

**全局技能（9个）** - 通过 npx skills 安装：
- vercel-react-best-practices (256.8K 🔥)
- nextjs-app-router-patterns
- typescript-advanced-types
- tailwind-design-system
- prisma-database-setup
- prisma-client-api
- kpi-dashboard-design
- fullstack-developer
- typescript-react-reviewer

**本地技能（9个）** - .claude/skills/：
- 📊 **文档处理**: docx, pptx, pdf, xlsx
- 🤖 **AI 助手**: new-conversation, skill-creator
- 🔧 **开发工具**: mcp-builder, mcp-container-install-bmad
- 🎨 **原型生成**: generate-prototype-grid

---

## 🚀 如何使用此模板创建新 AI 助手

### 方法 1: 克隆模板（推荐）

```bash
# 1. 克隆 starter 模板
git clone https://gitea.d8d.fun/d8dfun/ai-assistant-starter.git my-new-assistant

# 2. 进入项目目录
cd my-new-assistant

# 3. 修改配置文件
# - 编辑 CLAUDE.md：修改助手名称、职责、模板ID等
# - 编辑 README.md：修改项目说明
# - 编辑 docs/ 下的文档：更新模板信息

# 4. 初始化为新仓库
rm -rf .git
git init
git add .
git commit -m "feat: 初始化 [你的助手名称]"

# 5. 推送到新仓库
git remote add origin <你的新仓库地址>
git push -u origin main
```

### 方法 2: 从现有项目复制配置

```bash
# 1. 复制配置文件
cp -r ai-assistant-starter/.claude/ my-project/
cp ai-assistant-starter/CLAUDE.md my-project/
cp ai-assistant-starter/README.md my-project/
cp ai-assistant-starter/.gitignore my-project/

# 2. 根据你的项目修改配置
# - 修改 CLAUDE.md：更新为你的助手名称和职责
# - 修改 README.md：更新项目说明
# - 修改模板ID和工作空间ID
```

---

## 📝 配置清单

创建新 AI 助手时，需要修改以下内容：

### 1. **CLAUDE.md** - 核心配置文件

```markdown
# 修改以下内容：

# 1. 标题和角色名称
# 原: # Next.js 管理后台开发助手
# 改: # [你的助手名称]

# 2. 触发方式
# 原: group chat: Users mention you using `@nextjs-admin`
# 改: group chat: Users mention you using `@[你的触发词]`

# 3. 能力描述
# 原: 专门帮助开发Next.js管理后台的AI助手
# 改: 专门帮助[你的专业领域]的AI助手

# 4. 职责范围
# 原: 在工作空间ID 226 的模板ID 244 中进行AI智能抽背助手开发
# 改: 在工作空间ID [XXX] 的模板ID [XXX] 中进行[你的项目]开发

# 5. 开发环境信息
# 修改工作空间ID、模板ID、容器访问地址
```

### 2. **README.md** - 项目说明

```markdown
# 修改以下内容：

# 1. 项目标题和描述
# 2. 开发环境信息
# 3. 技能清单
# 4. 相关链接
```

### 3. **docs/template-XXX-overview.md** - 模板概述

```markdown
# 创建新的模板概述文档，包含：
- 基本信息（模板ID、访问地址）
- 项目定位
- 技术栈
- 项目结构
- 快速开始指南
```

---

## 🛠️ 技术栈参考

此模板适用于以下技术栈的 AI 助手：

### 前端框架
- ✅ Next.js (App Router)
- ✅ React 19
- ✅ Vue 3
- ✅ Nuxt 3

### 后端框架
- ✅ NestJS
- ✅ Express
- ✅ FastAPI
- ✅ Django

### 数据库
- ✅ PostgreSQL + Prisma
- ✅ MongoDB + Mongoose
- ✅ MySQL
- ✅ Redis

### 样式方案
- ✅ Tailwind CSS
- ✅ Ant Design
- ✅ Element Plus
- ✅ Material-UI

---

## 📚 完整功能清单

### D8D MCP 工具集成
- ✅ 容器控制（启动/停止/检查）
- ✅ 子代理交互（核心开发方式）
- ✅ 命令执行
- ✅ 对话历史管理

### BMAD 工作流系统
- ✅ 完整的 BMAD Method 说明
- ✅ 核心技能（bmad-help, bmad-quick-spec, bmad-dev-story）
- ✅ 专家 Agent（PM, Architect, Developer, Scrum Master）
- ✅ 工作流技能（PRD、架构、史诗、故事）

### 技能系统
- ✅ 技能优先策略
- ✅ 技能查询和安装
- ✅ 使用场景说明

---

## 🎯 适用场景

此模板适合创建以下类型的 AI 助手：

### ✅ 推荐使用
- 📱 **全栈 Web 应用** - Next.js、React、Vue 等
- 🎨 **管理后台系统** - 仪表板、CRUD、数据管理
- 🔌 **API 服务** - RESTful、GraphQL、微服务
- 🗄️ **数据库驱动** - Prisma、SQL、NoSQL

### ⚠️ 不推荐使用
- ❌ 移动应用（React Native、Flutter）
- ❌ 桌面应用（Electron、Tauri）
- ❌ 游戏开发（Unity、Unreal）
- ❌ AI/ML 模型训练
- ❌ DevOps/基础设施

---

## 📖 使用示例

### 示例 1: 创建 Vue 管理后台助手

```bash
# 1. 克隆模板
git clone https://gitea.d8d.fun/d8dfun/ai-assistant-starter.git vue-admin-assistant
cd vue-admin-assistant

# 2. 修改 CLAUDE.md
# - 标题改为: "# Vue 管理后台开发助手"
# - 触发词改为: @vue-admin
# - 技术栈改为: Vue 3 + Nuxt 3 + TypeScript
# - 模板ID改为: 你的模板ID

# 3. 修改 README.md
# - 更新项目描述和链接

# 4. 推送到新仓库
git remote set-url origin https://gitea.d8d.fun/d8dfun/vue-admin-assistant.git
git push -u origin main
```

### 示例 2: 创建 Python API 助手

```bash
# 1. 克隆模板
git clone https://gitea.d8d.fun/d8dfun/ai-assistant-starter.git python-api-assistant
cd python-api-assistant

# 2. 修改配置
# - CLAUDE.md: Python + FastAPI + SQLAlchemy
# - 技能系统: 移除前端技能，添加 Python 相关技能

# 3. 推送
git push -u origin main
```

---

## 🔗 相关链接

- **Gitea 仓库**: https://gitea.d8d.fun/d8dfun/ai-assistant-starter
- **问题反馈**: https://gitea.d8d.fun/d8dfun/ai-assistant-starter/issues
- **技能市场**: https://skills.sh/

---

## 📄 许可证

MIT License - 自由使用、修改和分发

---

## 🙏 致谢

本模板由以下项目启发：
- D8D 平台 - 开发容器和 MCP 工具
- BMAD - 敏捷 AI 驱动开发工作流
- Vercel - React 最佳实践
- Claude Code - AI 开发助手

---

**维护者**: d8dfun
**创建时间**: 2026-03-28
**最后更新**: 2026-03-28

## 📅 最近更新

### 2026-03-28

#### AI 智能抽背助手项目
- ✅ 创建工作空间 226 和模板 244
- ✅ 完成需求文档编写（1092行，包含完整UI分析）
- ✅ 整合 UI 分析到主需求文档（10个界面详细分析）
- ✅ 传输需求文档到容器（替换旧版本）
- ✅ 安装 BMAD 工作流平台
- ✅ 启动 BMAD PRD 流程（产品经理 John 已介入）
- ✅ 创建模板概述文档（template-244-overview.md）
- 🔄 PRD 创建进行中（已完成执行摘要、成功标准、用户旅程映射）

#### 文档更新
- ✅ 更新 CLAUDE.md，添加工作空间 226 和模板 244 信息
- ✅ 创建 template-244-overview.md
- ✅ 更新 README.md，添加项目进展信息
- ✅ 整合 UI 分析报告（删除独立报告，所有分析整合到主文档）

**AI 助手**: Claude Sonnet 4.6

---

## 🎉 快速开始

```bash
# 一键克隆
git clone https://gitea.d8d.fun/d8dfun/ai-assistant-starter.git

# 三步配置
# 1. 修改 CLAUDE.md（助手配置）
# 2. 修改 README.md（项目说明）
# 3. 推送到你的仓库

# 开始使用！
🚀
```