AI Assistant Starter 🚀

Web 应用类 AI 助手快速启动模板 - 包含完整的配置、技能和文档，开箱即用！

🎯 项目定位

这是一个 AI 助手开发模板仓库，专门用于快速创建 Web 应用类 AI 助手。以后创建新的 AI 助手时，直接克隆这个仓库，修改配置即可使用，无需重复配置！

---

✨ 模板特性

📦 开箱即用

• ✅ 完整的 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: 克隆模板（推荐）

# 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: 从现有项目复制配置

# 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. 根据你的项目修改配置

---

📝 配置清单

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

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

# 修改以下内容：

# 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 223 的模板ID 242 中进行Next.js管理后台开发
# 改: 在工作空间ID [XXX] 的模板ID [XXX] 中进行[你的项目]开发

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

2. README.md - 项目说明

# 修改以下内容：

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

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

# 创建新的模板概述文档，包含：
- 基本信息（模板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 管理后台助手

# 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 助手

# 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 AI 助手: Claude Sonnet 4.6

---

🎉 快速开始

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

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

# 开始使用！
🚀