用途:为 VeChain dApp 提供通用前端开发模式,涵盖 React Query(TanStack Query)的查询键、缓存失效、批量查询、加载状态与反模式,Turborepo 单仓架构与约定,状态管理(React Query 管服务端状态、Zustand 管客户端状态),Chakra UI 集成与响应式设计,react-i18next 国际化,以及交易 UX 的加载状态、确认模式与错误处理,并帮助在 VeChain Kit 与 dapp-kit 之间做选择。包级 API 见 vechain-kit 技能,核心 SDK、费用代付与多子句交易见 vechain-core 技能。
主要能力与规则:涉及参考表主题时须先读对应参考文件再动手,并简要说明正在读取哪个文件;信息优先级为参考文件优先,其次用 @vechain/mcp-server 查链上数据、构建交易与实时网络查询,用 Kapa AI MCP 查 VeChain 文档,网络搜索仅作最后手段。建议在主对话中直接处理 VeChain 任务,计划模式与子代理不继承技能上下文。上下文压缩或丢失后需重读 SKILL.md。
默认技术栈:React/Next.js(App Router)、@tanstack/react-query、Zustand(仅客户端状态)、Chakra UI v2、Turborepo、Node 20 LTS(nvm 管理)。
使用方式:先检查 Node 版本,若项目根有 .nvmrc 则运行 nvm use,否则创建内容为 20 的 .nvmrc 再运行 nvm use;检测项目结构,存在 turbo.json 则遵循 Turborepo 约定(apps/frontend、packages/*),仅在项目实际使用时应用 Chakra UI、i18n、Zustand 等条件模式;需求含糊时先澄清再实现。实现时所有服务端状态用 React Query,不在 Zustand 中重复;动态参数查询加 enabled 守卫;加载时显示骨架屏;交易后失效相关缓存。完成标准为代码可编译、测试通过、记录签名/费用/代币转账相关风险。
限制:资料未提供具体版本兼容范围、安装命令细节与更多示例;未提及收费或价格信息。