c8f0c31a83
- 将配置示例从模板242更新为模板244（AI智能抽背助手） - 确保示例文档反映实际项目情况 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
353 lines
8.5 KiB
Markdown
353 lines
8.5 KiB
Markdown
# 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. 推送到你的仓库
|
||
|
||
# 开始使用！
|
||
🚀
|
||
```
|