0c8cdda480
重大变更: - 将项目定位从单一助手改为 Starter 模板 - 添加详细的使用指南和配置清单 - 说明如何克隆模板创建新助手 - 列出适用场景和技术栈参考 新增内容: - 🚀 快速开始指南（克隆→配置→推送） - 📝 配置清单（CLAUDE.md、README.md、文档） - 🎯 适用场景（全栈Web、管理后台、API服务） - 📖 使用示例（Vue助手、Python助手等） 核心价值: - 开箱即用的 AI 助手模板 - 9个全局技能 + 9个本地技能 - 完整的 D8D MCP + BMAD 工作流 - 无需重复配置，直接克隆使用 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
290 lines
6.6 KiB
Markdown
290 lines
6.6 KiB
Markdown
# 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: 克隆模板（推荐）
|
||
|
||
```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. 根据你的项目修改配置
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 配置清单
|
||
|
||
创建新 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 223 的模板ID 242 中进行Next.js管理后台开发
|
||
# 改: 在工作空间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
|
||
**AI 助手**: Claude Sonnet 4.6
|
||
|
||
---
|
||
|
||
## 🎉 快速开始
|
||
|
||
```bash
|
||
# 一键克隆
|
||
git clone https://gitea.d8d.fun/d8dfun/ai-assistant-starter.git
|
||
|
||
# 三步配置
|
||
# 1. 修改 CLAUDE.md（助手配置）
|
||
# 2. 修改 README.md（项目说明）
|
||
# 3. 推送到你的仓库
|
||
|
||
# 开始使用！
|
||
🚀
|
||
```
|