diff --git a/CLAUDE.md b/CLAUDE.md index 99b9faa..5e3374c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -9,10 +9,8 @@ You are Next.js 管理后台开发助手, a specialized AI assistant. ## Your Capabilities -- 专门帮助开发Next.js管理后台的AI助手,熟悉React、Next.js、TypeScript、Tailwind CSS、Prisma等技术栈 -- 负责多个工作空间和模板的开发工作: - - 工作空间223的模板242(Next.js管理后台) - - 工作空间226的模板244(AI智能抽背助手Web应用) +- 专门帮助开发AI智能抽背助手Web应用的AI助手,熟悉微信小程序开发、AI集成、教育科技应用等技术栈 +- 负责工作空间226的模板244(AI智能抽背助手Web应用)开发工作 - 帮助用户构建包含前台、管理后台、API的完整全栈应用 - You can access the conversation history for context - You provide helpful, accurate, and friendly responses @@ -24,7 +22,6 @@ You are Next.js 管理后台开发助手, a specialized AI assistant. 使用 D8D MCP 管理多个开发容器: **可用模板:** -- 模板 242: Next.js 管理后台模板(工作空间223) - 模板 244: AI智能抽背助手Web应用(工作空间226)🆕 **常用命令(模板244 - AI智能抽背助手):** @@ -45,24 +42,6 @@ mcp__d8d__d8d_exec_dev_container_command(item_id=244, item_type="template", work mcp__d8d__d8d_get_dev_container_conversation_history(item_id=244, item_type="template", workspace_id=226) ``` -**常用命令(模板242 - Next.js管理后台):** -```bash -# 启动开发容器 -mcp__d8d__d8d_start_dev_container(item_id=242, item_type="template") - -# 检查容器状态 -mcp__d8d__d8d_get_dev_container_status(item_id=242, item_type="template") - -# 停止开发容器 -mcp__d8d__d8d_stop_dev_container(item_id=242, item_type="template") - -# 在容器中执行命令 -mcp__d8d__d8d_exec_dev_container_command(item_id=242, item_type="template", command="命令") - -# 获取容器对话历史 -mcp__d8d__d8d_get_dev_container_conversation_history(item_id=242, item_type="template") -``` - **子代理交互 (核心工具):** ```bash # 调用模板244容器内的 Claude 子代理 (AI智能抽背助手开发) @@ -73,21 +52,13 @@ mcp__d8d__d8d_invoke_dev_container_subagent( message="你的问题或指令", backgroundMode=true/false # true:后台模式(推荐), false:前台模式 ) - -# 调用模板242容器内的 Claude 子代理 (Next.js管理后台开发) -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="你的问题或指令", - backgroundMode=true/false -) ``` **使用说明:** - 推荐使用 `backgroundMode=true` 后台模式 - 超时时使用 `taskId` 查询结果 - 保持 `session_id` 和 `assistant_message_uuid` 可继续对话 -- 模板244需要指定 `workspace_id=226`,模板242不需要(工作空间223为默认) +- 模板244需要指定 `workspace_id=226` ### 容器内 BMAD 官方技能系统 @@ -127,14 +98,6 @@ mcp__d8d__d8d_invoke_dev_container_subagent( message="bmad-技能名称", # 技能触发命令 backgroundMode=true # 推荐使用后台模式 ) - -# 模板242(Next.js管理后台)- 不需要 workspace_id -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, # 模板 ID - item_type="template", # 固定值 - message="bmad-技能名称", # 技能触发命令 - backgroundMode=true # 推荐使用后台模式 -) ``` **使用示例(AI智能抽背助手 - 模板244):** @@ -167,33 +130,6 @@ mcp__d8d__d8d_invoke_dev_container_subagent( ) ``` -**使用示例(Next.js管理后台 - 模板242):** -```bash -# 示例 1: 调用子代理使用 bmad-help 技能获取智能建议 -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="bmad-help", - backgroundMode=true -) - -# 示例 2: 调用子代理使用 bmad-quick-spec 快速定义变更 -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="bmad-quick-spec", - backgroundMode=true -) - -# 示例 3: 调用子代理使用 bmad-dev-story 实施开发 -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="bmad-dev-story", - backgroundMode=true -) -``` - **重要提示**: - ❌ **不要**直接在外层环境调用 BMAD 技能 (它们不存在于外层) - ✅ **必须**通过 D8D 子代理在容器内调用 (BMAD 安装在容器内) @@ -261,14 +197,6 @@ mcp__d8d__d8d_invoke_dev_container_subagent( message="请在容器中执行: npx bmad-method install --modules bmm --tools claude-code --communication-language chinese --document-output-language chinese --yes", backgroundMode=false ) - -# 模板242(Next.js管理后台)- 不需要 workspace_id -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="请在容器中执行: npx bmad-method install --modules bmm --tools claude-code --communication-language chinese --document-output-language chinese --yes", - backgroundMode=false -) ``` **官方 BMAD 安装内容包括:** @@ -280,7 +208,6 @@ mcp__d8d__d8d_invoke_dev_container_subagent( **💡 推荐项目**: - 🆕 **模板244(AI智能抽背助手)**: 工作空间226,已安装需求文档,准备启动 BMAD PRD 流程 -- 模板242(Next.js管理后台): 工作空间223,可按需安装 BMAD ## 🎓 技能优先策略 (Skills-First Approach) @@ -348,13 +275,6 @@ npx skills remove - **需求文档**: 已传输到容器 `/mnt/code/226-244-template-6/ai-tutor-requirements.md` (564行) - **项目信息文档**: `/mnt/code/226-244-template-6/PROJECT_INFO.md` -#### 🛠️ Next.js管理后台(模板项目) -- **工作空间**: AI Agent Workspace (ID: 223) -- **模板**: Next.js 管理后台模板 (ID: 242) -- **容器访问地址**: - - VSCode: `d8d-ai-vscode-23964-223-242-template-6-group.dev.d8d.fun` - - 应用端口: `d8d-ai-vscode-8080-223-242-template-6-group.dev.d8d.fun` - ## Project Documentation ### 模板概述文档 @@ -363,7 +283,7 @@ npx skills remove | 模板 | 概述文档 | 说明 | |------|---------|------| -| 模板 242 | [template-242-overview.md](docs/template-242-overview.md) | Next.js 管理后台 - React + Next.js + Tailwind + Prisma | +| 模板 244 | [template-244-overview.md](docs/template-244-overview.md) | AI智能抽背助手 - 微信小程序 + AI + 记忆曲线 | **使用建议:** 1. 在操作模板前,先阅读对应的概述文档了解项目结构 diff --git a/README.md b/README.md index b060fb5..21d2185 100644 --- a/README.md +++ b/README.md @@ -4,10 +4,9 @@ ## 🎯 项目定位 -这是一个 **AI 助手开发项目仓库**,目前包含两个主要项目: +这是一个 **AI 助手开发项目仓库**,当前主要项目: -1. **Next.js 管理后台模板**(模板 242)- 工作空间 223 -2. **AI 智能抽背助手 Web 应用**(模板 244)- 工作空间 226 🆕 +1. **AI 智能抽背助手 Web 应用**(模板 244)- 工作空间 226 🆕 --- @@ -48,19 +47,6 @@ --- -### 🛠️ Next.js 管理后台(模板项目) - -**状态**: ✅ 已完成基础配置 - -**工作空间**: 223 -**模板**: 242 - -**技术栈**: Next.js + React + Tailwind CSS + Prisma - -**详细文档**: [docs/template-242-overview.md](docs/template-242-overview.md) - ---- - ## ✨ 模板特性 ### 📦 开箱即用 @@ -128,6 +114,9 @@ cp ai-assistant-starter/README.md my-project/ cp ai-assistant-starter/.gitignore my-project/ # 2. 根据你的项目修改配置 +# - 修改 CLAUDE.md:更新为你的助手名称和职责 +# - 修改 README.md:更新项目说明 +# - 修改模板ID和工作空间ID ``` --- diff --git a/docs/template-242-overview.md b/docs/template-242-overview.md deleted file mode 100644 index ce701c5..0000000 --- a/docs/template-242-overview.md +++ /dev/null @@ -1,304 +0,0 @@ -# 模板 242: Next.js 管理后台 - 概述 - -## 📋 基本信息 - -| 属性 | 值 | -|------|-----| -| **模板名称** | Next.js 管理后台模板 | -| **模板 ID** | 242 | -| **工作空间 ID** | 223 (AI Agent Workspace) | -| **容器访问** | `d8d-ai-vscode-23964-223-242-template-6-group.dev.d8d.fun` | -| **应用端口** | `d8d-ai-vscode-8080-223-242-template-6-group.dev.d8d.fun` | - ---- - -## 🎯 项目定位 - -这是一个**通用的 Next.js 全栈管理后台开发模板**,用于快速构建包含以下功能的完整应用系统: - -- ✅ **前台用户界面** - 面向终端用户的 Web 界面 -- ✅ **管理后台** - 系统管理、数据统计、内容管理 -- ✅ **API 服务** - RESTful API / GraphQL -- ✅ **数据库集成** - PostgreSQL + Prisma ORM - ---- - -## 🛠️ 技术栈 - -### 前端框架 -- **Next.js 14+** - React 框架,支持 App Router -- **React 19** - UI 库 -- **TypeScript** - 类型安全 -- **Tailwind CSS** - 样式框架 - -### 后端 & 数据库 -- **Next.js API Routes** - 服务端 API -- **Prisma ORM** - 数据库 ORM -- **PostgreSQL** - 关系型数据库 - -### 开发工具 -- **ESLint** - 代码检查 -- **Prettier** - 代码格式化 -- **Git** - 版本控制 - ---- - -## 📁 项目结构 - -``` -template-242/ -├── app/ # Next.js App Router 目录 -│ ├── (auth)/ # 认证路由组 -│ │ ├── login/ # 登录页面 -│ │ └── register/ # 注册页面 -│ ├── (dashboard)/ # 后台路由组 -│ │ ├── layout.tsx # 后台布局 -│ │ ├── page.tsx # 后台首页 -│ │ ├── users/ # 用户管理 -│ │ └── settings/ # 系统设置 -│ ├── (public)/ # 前台路由组 -│ │ ├── page.tsx # 前台首页 -│ │ └── about/ # 关于页面 -│ ├── api/ # API 路由 -│ │ ├── auth/ # 认证 API -│ │ ├── users/ # 用户 API -│ │ └── trpc/ # tRPC API (可选) -│ ├── layout.tsx # 根布局 -│ └── page.tsx # 根页面 -├── components/ # 共享组件 -│ ├── ui/ # UI 组件 (shadcn/ui) -│ ├── forms/ # 表单组件 -│ └── layouts/ # 布局组件 -├── lib/ # 工具库 -│ ├── prisma.ts # Prisma 客户端 -│ ├── auth.ts # 认证工具 -│ └── utils.ts # 通用工具 -├── prisma/ # Prisma 配置 -│ ├── schema.prisma # 数据库模型 -│ └── migrations/ # 迁移文件 -├── public/ # 静态资源 -│ ├── images/ # 图片 -│ └── fonts/ # 字体 -├── styles/ # 样式文件 -│ └── globals.css # 全局样式 -├── types/ # TypeScript 类型定义 -├── .env.local # 环境变量 -├── next.config.js # Next.js 配置 -├── tailwind.config.ts # Tailwind 配置 -├── tsconfig.json # TypeScript 配置 -└── package.json # 项目依赖 -``` - ---- - -## 🚀 快速开始 - -### 1. 启动开发容器 - -```bash -# 使用 D8D MCP 启动容器 -mcp__d8d__d8d_start_dev_container(item_id=242, item_type="template") -``` - -### 2. 检查容器状态 - -```bash -mcp__d8d__d8d_get_dev_container_status(item_id=242, item_type="template") -``` - -### 3. 访问应用 - -- **VSCode**: https://d8d-ai-vscode-23964-223-242-template-6-group.dev.d8d.fun -- **应用**: http://d8d-ai-vscode-8080-223-242-template-6-group.dev.d8d.fun - -### 4. 安装依赖 (首次运行) - -```bash -# 通过子代理在容器中执行 -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="npm install", - backgroundMode=false -) -``` - -### 5. 配置数据库 - -```bash -# 初始化 Prisma -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="npx prisma generate && npx prisma db push", - backgroundMode=false -) -``` - -### 6. 启动开发服务器 - -```bash -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="npm run dev", - backgroundMode=true -) -``` - ---- - -## 🎨 核心功能 - -### 用户认证 -- ✅ 登录/注册 -- ✅ 密码重置 -- ✅ 会话管理 -- ✅ 权限控制 - -### 用户管理 -- ✅ 用户列表 -- ✅ 用户详情 -- ✅ 角色管理 -- ✅ 权限分配 - -### 数据管理 -- ✅ CRUD 操作 -- ✅ 数据导入/导出 -- ✅ 批量操作 -- ✅ 数据验证 - -### 系统设置 -- ✅ 系统配置 -- ✅ 日志查看 -- ✅ 数据备份 -- ✅ 性能监控 - ---- - -## 🔌 可用技能 - -### 全局技能 (已安装) -- vercel-react-best-practices -- nextjs-app-router-patterns -- typescript-advanced-types -- tailwind-design-system -- prisma-database-setup -- prisma-client-api -- kpi-dashboard-design -- fullstack-developer -- typescript-react-reviewer - -### 本地技能 (.claude/skills/) -- docx - Word 文档处理 -- pptx - PowerPoint 处理 -- pdf - PDF 处理和 OCR -- xlsx - Excel 表格处理 -- new-conversation - 新对话创建 -- skill-creator - 技能创建指南 -- mcp-builder - MCP 服务器构建 -- mcp-container-install-bmad - BMAD 安装 - ---- - -## 📖 开发指南 - -### 使用子代理进行开发 - -**推荐工作流**: -```bash -# 调用子代理执行开发任务 -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="创建一个用户列表页面,包含搜索、分页和批量删除功能", - backgroundMode=true -) - -# 如果使用 BMAD 工作流 -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="bmad-quick-spec", # 快速定义变更 - backgroundMode=true -) -``` - -### 技能优先策略 - -在开发前先查询是否有相关技能: - -```bash -# 搜索相关技能 -npx skills find <关键词> - -# 查看已安装技能 -npx skills list -g -``` - -### 代码规范 - -- 使用 TypeScript 类型定义 -- 遵循 ESLint 规则 -- 使用 Prettier 格式化 -- 组件命名使用 PascalCase -- 文件命名使用 kebab-case - ---- - -## 🔗 相关链接 - -- **Gitea 仓库**: https://gitea.d8d.fun/d8dfun/nextjs-admin-assistant -- **D8D 工作空间**: 223 -- **技能市场**: https://skills.sh/ -- **Next.js 文档**: https://nextjs.org/docs -- **Prisma 文档**: https://www.prisma.io/docs - ---- - -## 🆘 故障排查 - -### 容器无法启动 -```bash -# 检查容器状态 -mcp__d8d__d8d_get_dev_container_status(item_id=242, item_type="template") - -# 重启容器 -mcp__d8d__d8d_restart_dev_container(item_id=242, item_type="template") -``` - -### 依赖安装失败 -```bash -# 清理缓存重新安装 -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="rm -rf node_modules package-lock.json && npm install", - backgroundMode=false -) -``` - -### 数据库连接错误 -```bash -# 检查环境变量 -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="cat .env.local", - backgroundMode=false -) - -# 重新生成 Prisma Client -mcp__d8d__d8d_invoke_dev_container_subagent( - item_id=242, - item_type="template", - message="npx prisma generate", - backgroundMode=false -) -``` - ---- - -**最后更新**: 2026-03-28 -**维护者**: d8dfun -**AI 助手**: @nextjs-admin