SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场dynamic

dynamic

编程与开发

查看项目

更新于 10-16 02:12

技能介绍

用途

dynamic 是 bkit-claude-code 中的中级（Dynamic）技能，面向基于 bkend.ai BaaS 的全栈开发，帮助开发者快速搭建包含认证、数据库与 API 集成的 Web 应用。其触发关键词包括 fullstack、BaaS、login、signup、database、web app。

主要能力

该技能提供三个动作：

  • init：项目初始化（/init-dynamic feature），例如 /dynamic init my-saas。会创建 Next.js + Tailwind 项目结构、配置 bkend.ai MCP（.mcp.json）、创建 CLAUDE.md（指定 Level: Dynamic）、创建 docs/ 目录结构、生成 src/lib/bkend.ts 客户端模板，并初始化 pipeline store——在 lib/pdca/status.js 中调用 writeBkitMemory()，写入 .bkit/state/memory.json（.bkit-memory.json 的迁移路径）。该文件保存项目级别与 9 阶段 pipelineStatus，供流水线 Stop 钩子在阶段 5、6、9 读取；PDCA 阶段本身存放在 .bkit/state/pdca-status.json，而非此处。
  • guide：显示开发指南，包括 bkend.ai 认证/数据配置指南、Phase 1-9 完整流水线指南、API 集成模式。
  • help：BaaS 集成帮助，解释 bkend.ai 基本概念、认证、数据库、文件存储用法以及 MCP 集成方法。

技术栈

  • 前端：React / Next.js 14+、TypeScript、Tailwind CSS、TanStack Query（数据获取）、Zustand（状态管理）
  • 后端（BaaS）：bkend.ai，提供自动 REST API、MongoDB 数据库、内置认证（JWT）、实时功能（WebSocket）
  • 部署：Vercel（前端）、bkend.ai（后端）

使用方式

项目结构

初始化后生成的结构包含 src/app（Next.js App Router，含 (auth) 与 (main) 路由组）、src/components（ui 与 features）、src/hooks（useAuth.ts、useQuery.ts）、src/lib（bkend.ts、utils.ts）、src/stores（auth-store.ts）、src/types，以及 docs/（01-plan、02-design 含 data-model.md 与 api-spec.md、03-analysis、04-report）、.mcp.json、.env.local、package.json、README.md。

核心模式

  • bkend.ai 客户端：lib/bkend.ts 中定义 REST Service API Client，通过环境变量 NEXT_PUBLIC_BKEND_API_URL、NEXT_PUBLIC_BKEND_PROJECT_ID、NEXT_PUBLIC_BKEND_ENV 配置，封装 auth（signup、signin、me、refresh、signout）与 data（list、get、create、update、delete）方法。
  • 认证 Hook：hooks/useAuth.ts 使用 Zustand 与 persist 中间件管理用户状态与登录/登出。
  • 数据获取：使用 TanStack Query 进行列表查询、单项查询与创建/更新（Mutation）。
  • 受保护路由：components/ProtectedRoute.tsx 根据用户状态重定向。
  • 数据模型设计：基础字段 _id、createdAt、updatedAt 自动生成，支持引用字段、数组字段与嵌入对象。

MCP 集成

  • Claude Code CLI（推荐）：claude mcp add bkend --transport http https://api.bkend.ai/mcp
  • .mcp.json（按项目）：配置 mcpServers.bkend，type 为 http，url 为 https://api.bkend.ai/mcp
  • 认证：OAuth 2.1 + PKCE（浏览器自动认证），无需 API Key/环境变量。首次 MCP 请求会打开浏览器，登录 bkend 控制台、选择组织并批准权限。可通过“Show my bkend projects”验证。

环境变量（.env.local）

NEXT_PUBLIC_BKEND_API_URL=https://api.bkend.ai/v1 NEXT_PUBLIC_BKEND_PROJECT_ID=your-project-id NEXT_PUBLIC_BKEND_ENV=dev 项目 ID 可在 bkend 控制台（console.bkend.ai）找到，或通过 MCP 的“Show my project list” -> backend_project_list 获取。

语言层级指引（v1.3.0）

推荐 Tier 1-2 语言。Tier 1 完全支持；Tier 2 支持移动端（Flutter/RN）与现代 Web（Vue、Astro）；Tier 3 仅限平台特定需求；Tier 4 建议迁移。移动开发推荐 React Native（通过 TypeScript 属 Tier 1），Flutter（通过 Dart 属 Tier 2）受支持。

bkit 特性（v1.5.1）

  • 输出样式：推荐激活 bkit-pdca-guide（/output-style bkit-pdca-guide），提供 PDCA 状态徽章、代码变更后的差距分析建议、自动下一阶段指引与清单。
  • Agent Teams（2 名队友）：developer 角色使用 bkend-expert 负责 Do、Act 阶段；qa 角色使用 qa-monitor、gap-detector 负责 Check 阶段。启用方式：设置环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1，启动团队模式 /pdca team {feature}，监控进度 /pdca team status。
  • Agent Memory（自动激活）：所有 bkit 智能体自动跨会话记忆项目上下文，无需设置，使用 project 范围记忆。

适用场景

  • 前端开发者
  • 独立创业者
  • 希望快速构建全栈服务的人群

限制

  • 不适合复杂后端逻辑（受 serverless function 限制）
  • 不适合大规模流量（受 BaaS 限制）
  • 不适合自定义基础设施控制
  • 不适合微服务架构

如需以下情况，建议升级到 Enterprise Level：流量将显著增长、希望拆分为微服务、需要自有服务器/基础设施、需要复杂后端逻辑。

常见错误

  • CORS 错误：在 bkend.ai 控制台注册域名
  • 401 Unauthorized：令牌过期，重新登录或刷新令牌
  • 数据不显示：检查集合名称与查询条件
  • 类型错误：同步 TypeScript 类型定义与 schema