用途:面向 Jarvus React 基础技术栈,帮助构建或维护前端应用。基础栈包括 Bun(依赖管理与脚本)、Vite、React 19、TypeScript、通过 @tailwindcss/vite 接入的 Tailwind CSS v4、通过 react-router 接入的 React Router v7,以及 clsx 加 tailwind-merge 处理条件类名。shadcn/ui 视为可选组件库层,除非项目已使用或用户选择,否则不初始化。
主要能力与用法:按任务查阅参考文档——搭建基础栈看 setup-guide.md,路由、URL 状态、布局与无障碍模式看 patterns.md,shadcn/ui 看 shadcn.md,MapLibre GL JS 看 maplibre.md,库 API 与组件调研看 mcp-tools.md。新项目先看搭建指南再看模式指南。导入使用 react-router 而非 react-router-dom;类名组合用 cn 函数封装 twMerge(clsx(inputs));样式使用 bg-background、text-foreground 等语义化 token,并在 src/index.css 中定义。
质量与代码规范:UI 变更需使用语义元素与程序化标签,保留键盘操作与可见焦点,不以颜色单独传达状态,覆盖加载、空、错误、禁用、成功状态,检查宽窄布局并尊重减少动效偏好。可分享的筛选、选择与分页放入 URL,更新 URLSearchParams 副本以保留无关参数。Jarvus TypeScript 包使用 oxc 而非 ESLint 与 Prettier,安装 bun add -d oxlint oxfmt,并配置 dev、build、typecheck、lint、format、format:check 脚本;类型检查用 tsc -b 而非 tsc --noEmit。oxc 命令应限定真实源码路径,避免裸 .。
限制与护栏:改动依赖或配置前先检查仓库,保留其包管理器、框架、路由模式、组件系统与质量工具,除非用户明确要求迁移。Bun 项目用 bun add,不手改版本或换包管理器生成锁文件。React Router 固定为 bun add react-router@7。未经授权不得提交、推送或发布。完成前运行仓库相关脚本(如 bun run lint、format:check、typecheck、test、build),仅跳过确实未配置的命令并说明。其他细节暂未提供。