用途：better-chatbot 是面向个人与团队的开源 AI 聊天机器人平台，基于 Next.js 15 与 Vercel AI SDK v5 构建，支持 OpenAI、Anthropic、Google、xAI、Ollama、OpenRouter 等多模型，并提供 MCP 工具集成、可视化工作流构建器、实时语音助手与团队协作。本技能用于让 Claude 掌握该项目的约定与模式，确保贡献代码符合既有标准。
主要能力与架构：项目采用三层工具系统，包括 MCP 外部工具、基于 DAG 的可视化工作流工具，以及内置默认工具（如网页搜索、图像生成）。API 路由遵循 RESTful 约定，采用流式优先架构，并用 safe() 包装实现防御式编程。组件按功能组织，使用复合组件模式，工具执行与渲染分离。数据库访问通过 Drizzle ORM 的仓储类抽象。
使用方式：克隆仓库后执行 pnpm install，复制 .env.example 为 .env 并配置 API 密钥、DATABASE_URL 与 BETTER_AUTH_SECRET，然后运行 pnpm dev。常用命令包括 pnpm build、pnpm test、pnpm test:e2e 与 pnpm check（提交 PR 前运行）。
关键规则：服务端操作必须使用 validatedActionWithUser 或 validatedActionWithAdminPermission；执行工具前用品牌类型标签检查工具类型；跨字段校验使用 Zod superRefine；不要手动解析 FormData；不要直接修改 Zustand 状态；提交前运行 pnpm check，UI 变更需附视觉文档，PR 标题使用 Conventional Commit 格式。
适用场景与限制：适用于为该项目贡献代码、实现工具、API 路由、组件或数据库查询，以及排查常见错误。技能包含 12 个参考文件，按需加载。依赖 Next.js 15+、Vercel AI SDK 5+、Better Auth 1.3+、Drizzle ORM 0.40+、PostgreSQL，测试使用 Vitest 与 Playwright。具体收费、价格与平台支持情况暂未提供。